Redeem Asset

{
  "amount": 100000,
  "bankCode": "058",
  "accountNumber": "0123456789",
  "saveDetails": true
}

curl -X POST "https://api.cngn.co/v1/api/redeemAsset" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "<base64 AES-256-CBC ciphertext of the plain body>",
    "iv": "<base64 16-byte IV>"
  }'

{
  "status": 200,
  "message": "Deposit for redeem was successfully",
  "data": {
    "trxRef": "RD-3e7a91cf",
    "address": "0x1fA2b3C4d5E6f7A8b9C0d1E2f3A4b5C6d7E8f9A0"
  }
}

{
  "status": 400,
  "message": "Service is currently unavailable. Please try again later."
}

POST

api

redeemAsset

{
  "amount": 100000,
  "bankCode": "058",
  "accountNumber": "0123456789",
  "saveDetails": true
}

curl -X POST "https://api.cngn.co/v1/api/redeemAsset" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "<base64 AES-256-CBC ciphertext of the plain body>",
    "iv": "<base64 16-byte IV>"
  }'

{
  "status": 200,
  "message": "Deposit for redeem was successfully",
  "data": {
    "trxRef": "RD-3e7a91cf",
    "address": "0x1fA2b3C4d5E6f7A8b9C0d1E2f3A4b5C6d7E8f9A0"
  }
}

{
  "status": 400,
  "message": "Service is currently unavailable. Please try again later."
}

Initiates a redemption: cNGN is burned and the equivalent Naira is paid out to the specified bank account.

Requires the Redeem permission. The request body must be encrypted. Verify the destination account first with Verify Account Details.

Body parameters (plain payload, pre-encryption)

number

required

Amount of cNGN to redeem. Minimum 1.

string

required

CBN bank code of the destination bank, from Get Banks.

string

required

10-digit destination account number.

boolean

Save these bank details for future redemptions.

Response (decrypted `data`)

string

Redemption transaction reference. Track it via Get Transactions.

string

The deposit address associated with the redemption.

{
  "amount": 100000,
  "bankCode": "058",
  "accountNumber": "0123456789",
  "saveDetails": true
}

curl -X POST "https://api.cngn.co/v1/api/redeemAsset" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "<base64 AES-256-CBC ciphertext of the plain body>",
    "iv": "<base64 16-byte IV>"
  }'

{
  "status": 200,
  "message": "Deposit for redeem was successfully",
  "data": {
    "trxRef": "RD-3e7a91cf",
    "address": "0x1fA2b3C4d5E6f7A8b9C0d1E2f3A4b5C6d7E8f9A0"
  }
}

{
  "status": 400,
  "message": "Service is currently unavailable. Please try again later."
}

Create Temporary Virtual Account Verify Account Details

Overview

Wallet

Deposits

Redemptions

On-Chain Transfers

Address Whitelisting

Body parameters (plain payload, pre-encryption)

Response (decrypted `data`)

​Body parameters (plain payload, pre-encryption)

​Response (decrypted data)

Body parameters (plain payload, pre-encryption)

Response (decrypted `data`)