Improved

Stablecoin API v1.0.5 β€” Release Notes

πŸš€ Stablecoin API Update v1.0.5 is now live! πŸŽ‰

This release expands off-ramp coverage with four new preview currencies β€” πŸ‡ΏπŸ‡² ZMW, πŸ‡ΊπŸ‡¬ UGX, πŸ‡ΈπŸ‡¬ SGD, and πŸ‡¨πŸ‡¦ CAD β€” adds the πŸ‡¨πŸ‡΄ COP remote bank account schema, introduces corporate Bakkt account closure, and clarifies an important prerequisite for USD ACH Pulls.

✨ What's New

  • 🌍 New off-ramp currencies (preview): ZMW, UGX, SGD & CAD
  • πŸ‡¨πŸ‡΄ COP remote bank account schema now available
  • 🏒 Corporate Bakkt bank accounts can now be closed via API
  • πŸ“– USD ACH Pull flow now clarifies the required Bakkt fiat account setup

🌍 New Off-Ramp Currencies (Preview)

Off-ramps are now available as preview currencies for:

CurrencyCountry
ZMWπŸ‡ΏπŸ‡² Zambian Kwacha
UGXπŸ‡ΊπŸ‡¬ Ugandan Shilling
SGDπŸ‡ΈπŸ‡¬ Singapore Dollar
CADπŸ‡¨πŸ‡¦ Canadian Dollar

⚠️ Preview currencies are enabled for a limited set of merchants in production and may change before general availability. Reach out to your Bakkt contact if you'd like access.

ZMW & UGX β€” mobile money support

ZMW and UGX additionally support mobile money payouts, using the same mobile-wallet / bank-account rail model as KES and GHS.

Railis_mobile_walletRequired fields
Mobile wallettrue (default)currency + recipient_phone_number
Bank accountfalsecurrency + is_mobile_wallet + account_number + swift_code

For mobile money payouts, the recipient's phone number must be associated with a supported mobile money provider for that currency. Retrieve the current list of supported banks and mobile money providers via:

  • GET /stablecoin/supported/banks?currency=ZMW
  • GET /stablecoin/supported/banks?currency=UGX

SGD & CAD β€” fixed-field bank account

SGD and CAD use the fixed-field bank account shape.

CurrencyRequired fields
πŸ‡ΈπŸ‡¬ SGDaccount_number, swift_code, bank_name, recipient_relationship, remittance_purpose
πŸ‡¨πŸ‡¦ CADaccount_number, swift_code, bank_name, transit_code, recipient_relationship, remittance_purpose

Please refer to the API reference for the required account and recipient information for each currency.

πŸ‡¨πŸ‡΄ Colombian Peso (COP)

The COP remote bank account schema is now available for off-ramp flows in Sandbox. COP requires some corridor-specific recipient information, including the recipient's national identifier.

Required fields

currency, account_number, swift_code, bank_name, national_identifier, recipient_relationship, remittance_purpose

Example

{
  "account_details": {
    "currency": "COP",
    "account_number": "020601089805504",
    "swift_code": "COLOCOBM",
    "bank_name": "Bancolombia",
    "national_identifier": "3214786174",
    "recipient_relationship": "Self",
    "remittance_purpose": "Salary"
  }
}

Please refer to the API reference for the complete request schema and supported values.

🏒 Corporate Bakkt Bank Account Closure

Corporate Bakkt bank accounts can now be closed through the Stablecoin API.

New endpoint:

POST /stablecoin/corporate/{corporate_uuid}/bank-account/bakkt/{account_uuid}/close

An optional reason may be included in the request body. This brings corporate account management in line with the existing user-level account closure functionality.

πŸ“– ACH Pull β€” USD Bakkt Fiat Account Required

An important reminder when integrating USD ACH Pulls: before initiating an ACH Pull, the user must have a USD Bakkt fiat account.

Creating a linked bank account profile does not automatically create the USD Bakkt account, so make sure it has been created before initiating the pull. If it's missing, the pull fails with a 404 and an "account mapping not found" error.

Please review the updated ACH Pull documentation when implementing or troubleshooting this flow.

πŸ™Œ Let us know if you need help testing or integrating these updates!