IBAN-named fiat currency receiving and transferring

IBAN-named fiat currency receiving and transferring

Transfer-Related Rules

  1. Reference Bank Information for Transfers: Refer to the data returned in the card details document:
  • Multi-currency contact information (contacts)

  • Receiving bank information (depositBank)

  1. 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

  1. 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 NameRequiredTypeLengthDescription
orderNoYString64Order Number
cardIdYString32Card ID
ibanIdYString32Contact Person's Bank Account ID
amountYString32Amount (Unit: Cents)
currencyYString3Currency 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 NameTypeDescription
successbooleanSuccess flag
errorbooleanFailure flag
msgStringReturn message
codeintegerReturn code
modelbooleanWhether 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.