Skip to main content

KYB - SWIFT (International Payout)

The SWIFT rail is enabled through a company onboarding handled by Avenia, not through an API call. There is no POST /v2/kyc/swift/... endpoint — unlike USD, EUR, COP, ARS and MXN, this rail has no self-service activation.

warning

Company accounts only. Individual accounts cannot be onboarded to SWIFT and are refused at ticket creation.

How activation works​

  1. Ask your account manager to enable SWIFT for your company account.
  2. Avenia's compliance team runs the onboarding, which includes a hosted verification step completed by the company. That page is issued by Avenia — it is not something your integration renders or drives.
  3. When the review is approved, the rail is switched on for your account.

Everything the review needs is company data you have already provided at KYB Level 1 — legal entity, UBOs, formation documents and proof of address. Compliance will come back to you if anything else is required.

Confirming the rail is active​

swiftUsdUnlocked on the account metadata endpoint is the source of truth:

curl -X GET "https://api.sandbox.avenia.io:10952/v2/account/metadata" \
     -H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
{
  "brlUnlocked": true,
  "usdUnlocked": false,
  "eurUnlocked": false,
  "arsUnlocked": false,
  "copUnlocked": false,
  "mxnUnlocked": false,
  "swiftUsdUnlocked": true
}

Poll it — or ask your account manager — before enabling the SWIFT corridor in your product. Creating a SWIFT ticket while the flag is false fails.

Once SWIFT is active​

  • Payout only. SWIFT is an outbound rail: you fund the payout from your token balance (USDC, USDT, BRLA, EURC with inputPaymentMethod=INTERNAL) or with a BRL PIX deposit. There is no SWIFT deposit account and no SWIFT payin.
  • Register the destination account first via POST /v2/account/beneficiaries/bank-accounts/swift/ and reference its id as beneficiarySwiftBankAccountId on the ticket. See Beneficiary Bank Accounts — SWIFT.
  • Per-currency minimums and maximums apply, expressed in the receiving currency. See Operations — SWIFT (International Payout).