POST /auth/add-bank-account

Use this API to add bank accounts.

This API is used to add a new bank account. A new deposit address associated to the bank account will also be created. Users can use the deposit address to request a redeem to the bank account.

Parameters

1. bankAccountNumber (String):

   This parameter represents the bank account number.

2. bankCode (String):

   This parameter represents the bank code. Get a list of available banks from this api.

3. bankName (String):

   The name of the bank, as returned by the same API.

4. notes (String):

   Optional. Use it when the bank account holder name differs from the name on the IDRX account, to describe the reason for the difference.

This endpoint requires a verified account. If the account has not completed verification, the request is rejected with 401 User is not verified.

Example Request

curl -X POST '<https://api.idrx.co/auth/add-bank-account>' --header 'idrx-api-key: <API_KEY>' --header 'idrx-api-sig: <signature>' --header 'idrx-api-ts': <timestamp>' --header 'Content-Type': application/json'

Payload

{
  "bankAccountNumber": "string",
  "bankCode": "string",
  "bankName": "string"
}

Response

If the request is successful, the response will be as shown below:

{
    "statusCode": 201,
    "message": "success",
    "data": {
        "id": 108,
        "userId": 411,
        "bankAccountNumber": "5017332241",
        "bankAccountName": "JOHN SMITH",
        "bankAccountNumberHash": null,
        "bankCode": "014",
        "bankName": "BANK CENTRAL ASIA",
        "deleted": false,
        "DepositWalletAddress": {
            "walletAddress": "0x07C158ab29f23D0821e7D24B191c5e5d9d72738b",
            "createdAt": "2024-01-17T10:34:22.304Z"
        }
    }
}