✨ New Features
Virtual Accounts
-
New Endpoint:
POST /v3/customers/{customer_id}/virtual-accountsCreate Virtual Account issues a virtual account for a customer and now lets you choose the banking partner that receives the fiat deposit.source.bank— required. AcceptsPORTAGE. The banks available to you depend on your configuration, and not every bank supports every source rail.- The create response now returns
deposit_instructions,destination, andbank.customer_idandcreated_atare no longer returned on create.
-
New Endpoint:
GET /v3/customers/{customer_id}/virtual-accountsList Virtual Accounts returns a paginated list of every virtual account belonging to a customer. -
New Endpoint:
GET /v3/customers/{customer_id}/virtual-accounts/{va_id}Get Virtual Account Details returns the full record for a single virtual account, including the deposit instructions the customer funds it with and the crypto destination the deposits settle to. There is no earlier equivalent for this endpoint.
Beneficiaries
- New Field:
intermediary_routing_numberCreate Beneficiary acceptsreceiver_meta_data.intermediary_routing_number, the routing number of an intermediary bank when a payout has to be routed through one before it reaches the beneficiary bank. This field is required for SWIFT payouts.
🛠️ Improvements
Beneficiaries
-
Request Examples Split by Rail
The bank beneficiary example on Create Beneficiary has been replaced with two examples: a local rail example using
bank_account.schemeLOCALwith aFEDWIRErouting number, and an international rail example usingbank_account.schemeSWIFTwith a SWIFT BIC. Both examples now use theETHEREUMrail fordeposit_instructionandrefund_instruction. - USD ACH Payouts Coming Soon USD ACH payouts are not yet available. This is now stated on Create Beneficiary.
Supported Currencies and Rails
-
EURCRemoved From Currency EnumsEURCis no longer accepted and has been removed from the currency enums on the following endpoints.USDCandUSDTare unaffected.- Create Beneficiary —
deposit_instruction.currency,refund_instruction.currency, and the external crypto wallet token list - Create Virtual Account —
destination.currency - Create Customer Wallets —
currency
- Create Beneficiary —
-
FEDNOWandSEPARemoved From Virtual Account Source Railssource.railon Create Virtual Account now acceptsACH,SWIFT,FEDWIRE, andSPEI.FEDNOWandSEPAhave been removed. -
Capabilities Response Examples Updated
The response examples on Get Customer Capabilities no longer include
EURCtokens, theFEDNOWon-ramp rail, orSEPAoff-ramp routes.
🗑️ Deprecations and Removals
-
Endpoints Deprecated and Removed After the September 1, 2026 Deprecation Date
PATCH /v1/customers/{customer_id}— Patch Customer RFI is unaffected and remains available.Update, October 2, 2026:POST /v2/beneficiariesandPOST /v2/customers/{customer_id}/virtual-accountshave been restored and remain available for existing integrations. See the October 2, 2026 changelog. -
V1 Virtual Account Webhooks Deprecated
The
virtual_account.createdandvirtual_account.statusevents are deprecated and no longer documented. Subscribe to the.v2events instead, which carry the same fields plusrfianddeveloper_fee_fixed.Both event names have been removed from thetypeenum on the webhook event envelope. Thestatusvalues differ between the two versions: the deprecated events returnedACTIVE,INACTIVE, andSUSPENDED, while the.v2events returnPROCESSING,IN_COMPLIANCE,REQUEST_FOR_INFORMATION,ACTIVE,INACTIVE, andDECLINED. All other webhook events are unaffected.
