Multi-Currency Accounts are receiving accounts through which merchants can collect funds from their global customers via SWIFT payment method.

📘
Supported Currencies for Multi-Currency Accounts -

USD

JPY

AED

AUD

EUR

GBP

Request Specifications

POST /v2/payments/currency_account

Field	Type	Description	Required
`reference_id`	String	Unique reference ID for the request.	Yes
`consumer_urn`	String	Unique identifier for the consumer.	Yes
`currency`	String	ISO currency code (e.g., `USD`, `EUR`).	Yes
`payment_channel`	String	`SWIFT`	Yes
`name`	String	Nick name for account identification.	Yes
`purpose`	String	Business purpose for account creation.	Yes

Response Specifications

The response for the Multi-Currency Account returns standard banking credentials for international wire transfers.

Field	Type	Description
`decentro_txn_id`	String	Unique Decentro transaction identifier.
`status`	String	Status of the API request (e.g., SUCCESS).
`consumer_urn`	String	Unique URN of the consumer.
`currency_account_urn`	String	Unique URN for the newly created currency account.
`message`	String	Human-readable response message.
`account_details`	String	Container for the provisioned banking details.
`response_key`	String	Machine-readable response key for logic handling.

Account Details Object

Sub Field	Type	Description
`account_number`	String	The provisioned bank account number or IBAN.
`beneficiary_name`	String	The registered name for the account.
`bank_name`	String	Partner bank name (e.g., RBL Bank GIFT City).
`routing_code_name`	String	Type of routing code (e.g., SWIFT, IFSC).
`routing_code_value`	String	The actual routing code (e.g., RATNINBBXXX).
`payment_channel`	String	The supported payment Channel for this account - SWIFT.
`address`	String	Physical address associated with the bank branch.