Settlement Accounts

Create one bank account or wallet address. Settlements are paid to it.

curl -X POST 'https://sandbox-api.transfi.com/v3/settlement-accounts' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -H 'mid: YOUR_MID' \
  -H 'Content-Type: application/json' \
  -d '{
    "currencyType": "fiat",
    "currency": "EUR",
    "paymentType": "bank_transfer",
    "accountDetails": {
      "accountHolderName": "Acme Platforms Ltd",
      "iban": "DE89370400440532013000"
    }
  }'

The fields in accountDetails depend on the currency — get them from List Payment Methods with direction=withdraw.

→ Create · List · Update · Delete

📘
The first account you create is the default. To delete the default, make another account the default first.

📘
For crypto: currencyType: "crypto", a walletAddress, and either cryptoTicker or both cryptoCurrency and cryptoNetwork.

How settlement works: Settlements

The first account you create is the default. To delete the default, make another account the default first.

For crypto: currencyType: "crypto", a walletAddress, and either cryptoTicker or both cryptoCurrency and cryptoNetwork.

For crypto: `currencyType: "crypto"`, a `walletAddress`, and either `cryptoTicker` or both `cryptoCurrency` and `cryptoNetwork`.