brand controls the name on the receiver’s bank statement line item. On outbound wires, brand selects the sender (originator) of the wire. On FedNow payouts, brand selects the sender the receiving bank sees.
Branded transfers are supported for ach_debit, ach_credit, same_day_ach_credit, outbound wire payouts (destination.transfer_type: "wire"), and FedNow payouts (destination.transfer_type: "fednow_credit"). Branding is not supported for rtp_credit.
To learn more and see a demo, schedule a meeting to talk to sales.
Creating 2nd/3rd Party Transfers branded transfers
POSThttps://api.brale.xyz/accounts/account_id/transfers
Use the brand object to control the business name displayed to the receiver. Pass the target account inside the request body under brand.account_id. The brand.account_id is the Account whose name should appear to the receiver.
account_id: aB3hJkL9mN2PqRsTuvWxyz1234=Company 1- Your business
account_id: 34fcsGrCgN0Z9zC1v55eP0I6AKW=Company 2- Your customer
brand, the transfer uses your default branding.
brand and ach_description are independent. brand controls who the ACH payment is from. ach_description controls the short description shown after the sender name on the recipient’s bank statement. Set it as destination.ach_description for ach_credit and same_day_ach_credit payouts, or source.ach_description for ach_debit. See What recipients see on ACH for character limits and defaults.
Definitions
- 2nd-party: You are the brand (display name = your business).
- 3rd-party: Your customer’s business is the brand (display name = your customer).
Example of a 2nd Party Transfer (brand = your business)
POSThttps://api.brale.xyz/accounts/account_id/transfers
brand.account_id = aB3hJkL9mN2PqRsTuvWxyz1234 (Company 1)
The receiver will see Company 1 as the name on the ach_debit transaction.
Request
Response
Example of a 3rd Party Transfer (Company 2 = your customer)
POSThttps://api.brale.xyz/accounts/account_id/transfers
brand.account_id = 34fcsGrCgN0Z9zC1v55eP0I6AKW (Company 2)
The receiver will see Company 2 as the originator name on the ach_debit transaction.
Request
Response
Confirm the brand on a transfer
Transfer responses include abrand field. When the transfer was branded, brand is { "account_id": "<ACCOUNT_ID>" }. When it was not branded, brand is null. The create, get, and list transfer endpoints all return this field, so you can confirm from the response that your brand was applied to an ACH, wire, or FedNow transfer.
A transfer created with brand in the request can still return brand: null. In that case, Brale sent the transfer unbranded.
Branded outbound wires
You can brand an outbound domestic wire payout with the same top-levelbrand object. brand.account_id selects the verified Account identity used as the wire sender (originator). It is not free-form display-name text.
A branded wire request involves three different parties:
Branding only changes the sender identity on the wire. It does not change which Account funds the transfer, who owns the source or destination, custody, or the existing payout eligibility and verification requirements. If you omit
brand, the wire is sent unbranded, as before. You do not need to create an Automation or set up a separate funding account to send a branded wire.
brand and destination.wire_memo are independent. brand controls who the wire is from. destination.wire_memo controls the payment reference text sent with the wire. Pass an explicit wire_memo when the recipient needs a specific reference.
Example of a branded wire payout (Company 2 = your customer)
POSThttps://api.brale.xyz/accounts/{account_id}/transfers
In this example, your business account in the URL funds the payout from its internal Address, and the wire is sent with Company 2 as the sender.
Request
source.address_idis a funded internal Address on the Account in the URL.source.value_typeandsource.transfer_typematch the token and network it holds.destination.address_idis an external bank Address withwirein itstransfer_types.destination.transfer_typeiswireanddestination.value_typeisUSD.
pending instead of creating a replacement, and reuse the same Idempotency-Key if you retry the same request.
See Stablecoin to fiat offramp to create the recipient’s wire-capable bank Address and to track the payout with destination.payment_details.imad, returns, and refunds.
Branded FedNow payouts
You can brand a FedNow payout with the same top-levelbrand object. brand.account_id selects the verified Account identity the receiving bank sees as the sender. As with wires, the Account in the URL funds the payout from source.address_id, and destination.address_id is the recipient’s bank Address with fednow_credit enabled.
brand applies to 2nd- and 3rd-party transfers. It is independent of the FedNow enablement requirement: your Account must have FedNow enabled whether or not you send brand. See FedNow overview.
Example of a branded FedNow payout (Company 2 = your customer)
POSThttps://api.brale.xyz/accounts/{account_id}/transfers
Request
pending instead of creating a replacement, and reuse the same Idempotency-Key if you retry the same request.
See Send FedNow payouts to register the recipient’s bank Address and track the payout.
Brand account errors
When you create a branded transfer, Brale can reject the request if the Account inbrand.account_id can’t be used as a brand:
Brale does not store the
422 brand_account_update_required or 503 brand_identity_unavailable response for the Idempotency-Key. The same request succeeds once support fixes the brand Account or the service recovers.