Withdrawal Account

This set of APIs pertains to linking an existing physical bank account with a wallet for withdrawal purposes. This action can be undertaken for Full KYC wallets ONLY as per RBI regulations.

Please note that only one bank account can be linked to a wallet at any time, and this is the same account where all the remaining money will be transferred automatically when the consumer permanently closes/cancels their wallet via our APIs.

Link Bank Account

This API allows linking an account with the wallet associated with the specified mobile.

curl --location --request POST 'https://in.staging.decentro.tech/v2/prepaid/wallet/9000000009/account/ZZZZZZZZZZZZZZZZZZ' \
--header 'client_id: YOUR_CLIENT_ID' \
--header 'client_secret: YOUR_CLIENT_SECRET' \
--header 'module_secret: YOUR_PREPAID_MODULE_SECRET' \
--header 'provider_secret: YOUR_CHOSEN_PROVIDER_SECRET' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_id": "000",
    "purpose": "test_purpose",
    "consent": true,
    "ifsc": "FGHJ0000XYZ",
    "validate_account_transaction_id": "UUU"
}'

{
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "status": "FAILURE",
  "responseCode": "E00009",
  "message": "No consumer found with the given mobile. Kindly try a different mobile or re-trigger the consumer registration API"
}

Verify Bank Account Linkage

This API allows verification of an account's linkage with the wallet associated with the specified mobile.

curl --location --request POST 'https://in.staging.decentro.tech/v2/prepaid/wallet/9000000009/account/ZZZZZZZZZZZZZZZZZZ/verify' \
--header 'client_id: YOUR_CLIENT_ID' \
--header 'client_secret: YOUR_CLIENT_SECRET' \
--header 'module_secret: YOUR_PREPAID_MODULE_SECRET' \
--header 'provider_secret: YOUR_CHOSEN_PROVIDER_SECRET' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_id": "LLL",
    "original_transaction_id": "YYY",
    "purpose": "test_purpose",
    "consent": true,
    "amount": 2.77
}'

{
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "status": "SUCCESS",
  "responseCode": "E00000",
  "message": "Transaction failed",
  "data": {
    "transactionStatus": "UNKNOWN",
    "transactionDescription": "This is a sample response",
    "name": "ABC",
    "bankReferenceNumber": "BBBBBBBBBBBB",
    "ifsc": "YYY",
    "branch": "Kryptonite"
  }
}