Post Bank Accounts By Bank Account Id Replace Autoexchange
AuthorizationBearer <token>Scope: bank-accounts:write
bank_account_id*stringIdempotency-Key*stringUnique key making the create idempotent across retries (16-64 chars of A-Z a-z 0-9 _ -).
^[a-zA-Z0-9_-]{16,64}$application/json- body
Create a subaccount-scoped bank account. asset and network are required; all other fields are optional and depend on the rail.
asset*stringSettlement asset / currency, e.g. BRL, USD.
network*stringPayment rail the account belongs to, e.g. pix, ach, wire.
bank_type?stringBank account type. Defaults to external.
"external""external""shared"bank_name?stringbank_code?stringBank / institution code (e.g. Brazilian COMPE code, or SWIFT/BIC).
branch?stringBranch / agency number.
account?stringAccount number.
bank_short_description?stringOptional human-readable label.
bank_address?stringbank_city?stringbank_state?stringbank_postal_code?stringinstant_payment?stringInstant-payment key (e.g. a Pix key).
instant_payment_type?stringInstant-payment key type (e.g. evp, cpf, cnpj, email, phone).
country?stringISO country code of the bank.
deposit_reference?stringReference shown on deposits to this account.
routing_number?stringRouting number (e.g. US ABA).
iban?stringbic_swift?stringwire_message?stringFree-form message for wire transfers.
ffc_message?string"For further credit" message for intermediary routing.
autoexchange?booleanWhen true, funds received on this account are auto-exchanged and settled to autoexchange_destination_wallet_id.
falseautoexchange_destination_wallet_id?|Wallet (wal_…) that receives auto-exchanged funds. Required when autoexchange is true.
The old autoexchange bank account was soft-deleted and this replacement created in the same transaction. bank_type defaults to shared when omitted.
application/json- response
A subaccount-scoped bank account, as returned by create and replace-autoexchange.
id*stringBank account ID (bnk_…).
account_id*stringOwning account ID (acc_…).
subaccount_id*stringOwning subaccount ID (sub_…).
asset*stringnetwork*stringbank_type*string"external""shared"bank_short_description?stringbank_code?stringbank_name?stringbranch?stringaccount?stringinstant_payment?stringinstant_payment_type?stringcountry?stringdeposit_reference?stringcompliance_status*stringapproved for external, unchecked for shared.
is_active*booleanautoexchange*booleanautoexchange_destination_wallet_id?stringDestination wallet for auto-exchange, when configured.
created_at*stringdate-timeupdated_at*stringdate-timecurl -X POST 'https://api.betaramps.com/bank-accounts/string/replace-autoexchange' \ -H 'Idempotency-Key: string' \ -H 'Content-Type: application/json' \ -d '{ "asset": "BRL", "network": "pix", "bank_name": "Banco do Brasil", "bank_code": "001", "branch": "0001", "account": "1234567-8", "instant_payment": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "instant_payment_type": "evp", "country": "BR", "autoexchange": true, "autoexchange_destination_wallet_id": "wal_0192f4e6-1a2b-7c3d-8e4f-5a6b7c8d9e01"}'{ "id": "bnk_0192f5a2-3c4d-7e5f-8a6b-7c8d9e0a1b23", "account_id": "acc_0192f4e0-1a2b-7c3d-8e4f-5a6b7c8d9e01", "subaccount_id": "sub_0192f4e3-8a9b-7c6d-5e4f-3a2b1c0d9e8f", "asset": "BRL", "network": "pix", "bank_type": "shared", "bank_name": "Banco do Brasil", "bank_code": "001", "branch": "0001", "account": "1234567-8", "instant_payment": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "instant_payment_type": "evp", "country": "BR", "compliance_status": "unchecked", "is_active": true, "autoexchange": true, "autoexchange_destination_wallet_id": "wal_0192f4e6-1a2b-7c3d-8e4f-5a6b7c8d9e01", "created_at": "2026-10-31T12:00:00Z", "updated_at": "2026-10-31T12:00:00Z"}