Skip to main content

KYB - SWIFT (International Payouts and USD Deposits)

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
curl -X GET "https://api.sandbox.avenia.io:10952/v2/account/metadata" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
JSON
{
"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​

  • Payouts. You fund a SWIFT payout from your token balance (USDC, USDT, BRLA, EURC with inputPaymentMethod=INTERNAL) or with a BRL PIX deposit.
  • Deposits in USD. Once Avenia enables SWIFT deposits for the account, it gets a fixed SWIFT receiving account, and every USD transfer sent to it is credited as USDC. See Static Deposits and, in sandbox, Simulate Static Deposit.
  • 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).