IBAN-named fiat currency receiving and transferring
IBAN-named fiat currency receiving and transferring
Transfer-Related Rules
- Reference Bank Information for Transfers: Refer to the data returned in the card details document:
-
Multi-currency contact information (contacts)
-
Receiving bank information (depositBank)
- Fiat Currency Top-up for Same-Name Accounts:
-
Operation Path: Query card details to obtain receiving bank information (depositBank)
-
Top-up Conditions: After card activation
-
Supported Methods: Top up this account via IBan wire transfer
- Rules for Transfers to Same-Name Accounts:
-
Transfer Scope: Only transfers to bank accounts within the contact list (contacts) are allowed.
-
Core Requirement: The contact name must match the recipient's name in the receiving bank information.
Account Transfer Request URL
/open/api/card/withdraw/refund/iban
Account Transfer Request Method
- POST
Account Transfer Parameters
| Parameter Name | Required | Type | Length | Description |
|---|---|---|---|---|
| orderNo | Y | String | 64 | Order Number |
| cardId | Y | String | 32 | Card ID |
| ibanId | Y | String | 32 | Contact Person's Bank Account ID |
| amount | Y | String | 32 | Amount (Unit: Cents) |
| currency | Y | String | 3 | Currency USD, EUR, CHF |
Account Transfer Request Example
{
"amount": "1100",
"cardId": "465251_USD24",
"currency": "EUR",
"ibanId": "EA-00014179",
"orderNo": "101417557704370443131"
}Account Transfer Return Parameter Description
| Parameter Name | Type | Description |
|---|---|---|
| success | boolean | Success flag |
| error | boolean | Failure flag |
| msg | String | Return message |
| code | integer | Return code |
| model | boolean | Whether the operation was successful |
Account transfer return example
{
"success": true,
"error":false,
"msg": "success",
"code": 0,
"model": true,
"traceId": 1646651934238
}Remarks
- For more error codes, please see the error code description on the homepage.
Updated about 6 hours ago