Automations

Automations allow businesses to set up automatic onramps, offramps, or stablecoin swaps that are triggered upon receiving funds—without requiring a manual transfer request.


Common Automation Flows

  • Fiat to Stablecoin (Onramp) – Automatically mints stablecoins when a fiat deposit is received.
  • Stablecoin to Fiat (Offramp) – Automatically converts stablecoins to fiat and withdraws to a bank account. (Coming soon)
  • Stablecoin to Stablecoin (Swap) – Automatically swaps one stablecoin for another. (Coming soon)

📘

Automations can also be created in the Brale Dashboard on the Automations tab.


Onramp Automations

Automations provide a unique account number and routing number for wire transfers and ACH deposits. When funds are received, stablecoins are automatically minted to a pre-defined wallet address. Businesses can use automations to direct unique pre-funding coordinates to their customers, which mint stablecoins in a customer’s wallet.


Creating an Automation

Create an automation to receive USD and automatically mint SBC to a Solana wallet.

POST https://api.brale.xyz/accounts/account_id/automations

{
  "name": "XYZ Onramp",
  "type":"USD", 
  "destination": {
    "address_id": "2MhCCIHulVdXrHiEuQDJvnKbSkl", 
    "value_type": "SBC", 
    "transfer_type": "Solana"
  }
}

Automations are opened in a pending state and automatically transition into processing. Once virtual accounts are created and the automation is ready to use, it will transition to a completed status.

Response

{
    "id": "2xNiU3WRRNiGqnHka0OuIwltoQF",
    "name": "XYZ Onramp",
    "status": "pending",
    "destination": {
        "address_id": "2MhCCIHulVdXrHiEuQDJvnKbSkl",
        "value_type": "SBC",
        "transfer_type": "Solana"
    }
}

Listing Automations for a Customer

Retrieve all automations associated with a customer Account.

GET https://api.brale.xyz/accounts/account_id/automations

Response

{
  "automations": [
    {
      "name": "Customer Onramp",
      "status": "active",
      "wire_instructions": {
        "bank_beneficiary_name": "Jane Business",
        "bank_name": "Example Bank",
        "bank_address": "456 Commerce St., Des Moines, IA 50309",
        "bank_beneficiary": "XYZ Holdings LLC",
        "bank_account_number": "123456789",
        "bank_routing_number": "87654321",
      },
      "destination": {
        "address_id": "2MhCCIHulVdXrHiEuQDJvnKbSkl",
        "value_type": "SBC",
        "transfer_type": "Solana"
      }
    },
    {
      "name": "Business Payin",
      "status": "pending",
      "wire_instructions": {
        "bank_beneficiary_name": "John Enterprise",
        "bank_name": "Fictional Bank",
        "bank_address": "789 Market St., Chicago, IL 60601",
        "bank_beneficiary": "ABC Capital Inc.",
        "bank_account_number": "987654321",
        "bank_routing_number": "12345678",
      },
      "destination": {
        "address_id": "2MyQyQ2JCZJHNEUujTI8fT1nULc",
        "value_type": "SBC",
        "transfer_type": "Ethereum"
      }
    }
  ]
}

Retrieve an Automation

Retrieve a specific Automation.

GET https://api.brale.xyz/accounts/account_id/automations/automation_id

{
    "id": "2xNiU3WRRNiGqnHka0OuIwltoQF",
    "name": "XYZ Onramp",
    "status": "active",
    "destination": {
        "address_id": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
        "value_type": "SBC",
        "transfer_type": "base"
    },
    "wire_instructions": {
        // Brale Bank instructions
}