Settlements

✅
What this does
Money you collect lands on your TransFi balance. Settlement is how it reaches your own bank account or wallet — in batches, on a schedule, with a record of which payments were in each batch.

Steps

1. Tell us where to send it

Create a settlement account once. Bank account for fiat, wallet address for crypto.

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 becomes the default. You can't delete the default — make another account the default first.

2. Batches are paid on your schedule

You don't create batches. TransFi groups your settled collections and pays them to your default settlement account on the cycle agreed with your account manager.

3. See what was paid

curl -X GET 'https://sandbox-api.transfi.com/v3/settlement-batches?limit=20' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -H 'mid: YOUR_MID'

Each batch shows the amount, currency and account it was paid to — enough to match it to your bank statement. → List Settlement Batches

📘
The list of individual payments inside a batch — Coming soon. Until then, use List Orders for the batch period.

Collections · Balances

Settlements

What this does

Steps

1. Tell us where to send it

The first account you create becomes the default. You can't delete the default — make another account the default first.

2. Batches are paid on your schedule

3. See what was paid

The list of individual payments inside a batch — Coming soon. Until then, use List Orders for the batch period.

Related