Sandbox and Testnet

Brale provides a testnet environment for non-production requests. There is no separate sandbox. Only testnets (Sepolia, Solana Devnet, Base Sepolia, etc.) are supported. Blockchain mainnets (Ethereum, Solana, etc.) are not supported in testnet. Real fiat movement is not supported in testnet. Brale does not contact a bank or move real funds. You can still test fiat-funded flows: testnet mints and burns skip the fiat leg, and you can simulate inbound ACH and wire deposits into testnet Automations. See the full set of supported blockchain networks.

1. Create API Credentials scoped to Testnet

Create an application on the Settings page in the Dashboard.

Select Testnet as Network and enable all resources.

2. Mint Tokens on Testnets

When you submit a mint on testnet, we skip the fiat leg and immediately mint on-chain. This simulates an onramp transaction and acts as a faucet to mint tokens for other flows (payouts, etc.). POST https://api.brale.xyz/accounts/account_id/transfers

Request

{
  "amount": {
    "value": "100",
    "currency": "USD"
  },
  "source": {
    "value_type": "USD",
    "transfer_type": "wire"
  },
  "destination": {
    "address_id": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
    "value_type": "SBC",
    "transfer_type": "solana_devnet"
  }
}

3. Burn Tokens on Testnets

When you submit a redemption on testnet, we immediately burn on-chain and skip the fiat payout. This simulates an offramp transaction. POST https://api.brale.xyz/accounts/account_id/transfers

Request

{
  "amount": {
    "value": "100",
    "currency": "USD"
  },
  "source": {
    "address_id": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
    "value_type": "SBC",
    "transfer_type": "solana_devnet"
  },
  "destination": {
    "value_type": "USD",
    "transfer_type": "wire"
  }
}

4. Simulate a deposit into a testnet Automation

Testnet Automations return placeholder banking coordinates that cannot receive real deposits. To test the full Automation flow, simulate an inbound ACH or wire deposit. Brale runs the normal Automation, Transfer, and testnet mint flow and emits the normal payment.completed webhook event. Your testnet API credentials need the automations:write and network:testnet scopes. Create an Automation with a testnet destination

curl --request POST \
  --url "https://api.brale.xyz/accounts/${ACCOUNT_ID}/automations" \
  --header "Authorization: Bearer ${AUTH_TOKEN}" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $(uuidgen)" \
  --data '{
    "name": "Testnet Onramp",
    "source": { "value_type": "USD" },
    "destination": {
      "address_id": "'"${ADDRESS_ID}"'",
      "value_type": "SBC",
      "transfer_type": "base_sepolia"
    }
  }'

Wait until the Automation is active

curl --request GET \
  --url "https://api.brale.xyz/accounts/${ACCOUNT_ID}/automations/${AUTOMATION_ID}" \
  --header "Authorization: Bearer ${AUTH_TOKEN}"

Continue when the response has "status": "active". Simulate the deposit

curl --request POST \
  --url "https://api.brale.xyz/accounts/${ACCOUNT_ID}/automations/${AUTOMATION_ID}/simulations/deposits" \
  --header "Authorization: Bearer ${AUTH_TOKEN}" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $(uuidgen)" \
  --data '{
    "amount": { "value": "10.00", "currency": "USD" },
    "transfer_type": "ach"
  }'

Brale returns 202 Accepted with the resulting Transfer, including automation_id. transfer_type accepts ach or wire. Fetch the Transfer

curl --request GET \
  --url "https://api.brale.xyz/accounts/${ACCOUNT_ID}/transfers/${TRANSFER_ID}" \
  --header "Authorization: Bearer ${AUTH_TOKEN}"

When status is complete, destination.transaction_id holds the testnet mint transaction. See Simulate an Automation deposit for validation errors and idempotency behavior.

Follow the Quick Start Guide

Follow Quick Start - Your First Stablecoin Transfer for next steps to get deeper with the Brale API.

Overview

Key concepts

Webhooks

Sandbox and Testnet

1. Create API Credentials scoped to Testnet

2. Mint Tokens on Testnets

3. Burn Tokens on Testnets

4. Simulate a deposit into a testnet Automation

Follow the Quick Start Guide

​1. Create API Credentials scoped to Testnet

​2. Mint Tokens on Testnets

​3. Burn Tokens on Testnets

​4. Simulate a deposit into a testnet Automation

​Follow the Quick Start Guide

1. Create API Credentials scoped to Testnet

2. Mint Tokens on Testnets

3. Burn Tokens on Testnets

4. Simulate a deposit into a testnet Automation

Follow the Quick Start Guide