Fiat to Crypto

An NGN (fiat) deposit paying out POLYGON_USDT (crypto) — the classic on-ramp.

1

Call Get available currencies

Example response (trimmed to the two entries we need)

[
  {
    "currencyType": "fiat",
    "currencyCode": "NGN",
    "paymentChannels": [
      {
        "name": "Bank transfer",
        "type": "bank",
        "transferTypes": ["manual"],
        "isDepositAllowed": true,
        "isPayoutAllowed": true
      },
      {
        "name": "Airtime",
        "type": "airtime",
        "transferTypes": [],
        "isDepositAllowed": false,
        "isPayoutAllowed": true,
        "carriers": [
          { "code": "ng_mtn", "name": "MTN Nigeria" },
          { "code": "ng_airtel", "name": "Airtel Nigeria" },
          { "code": "ng_glo", "name": "Glo Mobile Nigeria" },
          { "code": "ng_9mobile", "name": "9Mobile Nigeria" }
        ]
      }
    ],
    "currencyDetails": { "countryIsoCode": "NG" },
    "pairs": ["crypto", "merchant_balance"]
  },
  {
    "currencyType": "crypto",
    "currencyCode": "POLYGON_USDT",
    "paymentChannels": [
      {
        "name": "Crypto",
        "type": "crypto",
        "transferTypes": ["manual"],
        "isDepositAllowed": true,
        "isPayoutAllowed": true
      }
    ],
    "currencyDetails": {
      "network": "POLYGON",
      "asset": "USDT",
      "contractAddress": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"
    },
    "pairs": ["fiat", "merchant_balance"]
  }
]

NGN takes deposits over bank and pays out over bank or airtime — airtime is payout-only, so it cannot be the deposit leg. POLYGON_USDT allows both directions, and NGN's pairs includes crypto. So NGN → POLYGON_USDT over bank is legal.

2

Call Get order limits

• depositPaymentChannel: "bank"

• depositCurrencyType: "fiat"

• depositCurrencyCode: "NGN"

• depositCountryIsoCode: "NG"

• payoutPaymentChannel: "crypto"

• payoutCurrencyType: "crypto"

• payoutCurrencyCode: "POLYGON_USDT"

Example response

{
  "deposit": {
    "min": 1556,
    "max": 311184,
    "minUsd": 1,
    "maxUsd": 200,
    "step": 1,
    "supportsDecimals": false
  },
  "payout": {
    "min": 1,
    "max": 200,
    "minUsd": 1,
    "maxUsd": 200,
    "step": 0.000001,
    "supportsDecimals": true
  }
}

The user wants 100 POLYGON_USDT, which is inside the payout window. Check their KYC tier with the KYC flow — pass the amounts so the answer covers this order.

3

Call Create quote

Set the amount on one leg only. Here it is the payout, because the user asked for a crypto amount.

Example request

{
  "deposit": {
    "paymentChannel": "bank",
    "currencyType": "fiat",
    "currencyCode": "NGN",
    "countryIsoCode": "NG"
  },
  "payout": {
    "paymentChannel": "crypto",
    "currencyType": "crypto",
    "currencyCode": "POLYGON_USDT",
    "amount": 100
  }
}

Example response (cashout trimmed)

{
  "quoteId": "68628fa56ff494df5f39faf5",
  "quoteExpiresAt": "2026-08-20T10:10:10.000Z",
  "deposit": {
    "paymentChannel": "bank",
    "currencyType": "fiat",
    "currencyCode": "NGN",
    "currencyDetails": { "countryIsoCode": "NG" },
    "cashout": {
      "exchangeRate": 1500,
      "exchangeRateAfterFees": 1531.1269,
      "amountBeforeFees": 153128,
      "amountAfterFees": 150015,
      "amountBeforeFeesUsd": 102.085333,
      "amountAfterFeesUsd": 100.01,
      "chargedFees": [
        { "id": "provider_fee", "type": "flat_amount", "recipient": "provider", "amount": 50 },
        { "id": "service_fee", "type": "percentage", "recipient": "platform", "amount": 3063 }
      ],
      "totalChargedFees": 3113,
      "totalChargedFeesUsd": 2.075333,
      "chargedFeesPerRecipient": { "provider": 50, "platform": 3063 }
    },
    "fieldsToCreateOrder": [
      { "key": "phoneNumber", "label": "Phone Number", "required": true, "type": "phone" },
      {
        "key": "bankCode",
        "label": "Bank name",
        "required": true,
        "type": "enum",
        "options": [
          { "value": "120001:02", "label": "9Payment Service Bank" },
          { "value": "801:02", "label": "Abbey Mortgage Bank" }
        ]
      },
      { "key": "bankAccountNumber", "label": "Bank Account Number", "required": true, "type": "string" }
    ],
    "transferType": "manual"
  },
  "payout": {
    "paymentChannel": "crypto",
    "currencyType": "crypto",
    "currencyCode": "POLYGON_USDT",
    "currencyDetails": {
      "network": "POLYGON",
      "asset": "USDT",
      "contractAddress": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"
    },
    "cashout": {
      "exchangeRate": 1,
      "exchangeRateAfterFees": 1.0001,
      "amountBeforeFees": 100.01,
      "amountAfterFees": 100,
      "amountBeforeFeesUsd": 100.01,
      "amountAfterFeesUsd": 100,
      "chargedFees": [
        { "id": "gas", "type": "flat_amount", "recipient": "blockchain", "amount": 0.01 }
      ],
      "totalChargedFees": 0.01,
      "totalChargedFeesUsd": 0.01,
      "chargedFeesPerRecipient": { "blockchain": 0.01 }
    },
    "fieldsToCreateOrder": [
      { "key": "blockchainWalletAddress", "label": "Your wallet address", "required": true, "type": "string" }
    ]
  }
}

To receive 100 POLYGON_USDT the user must deposit 153,128 NGN. Collect the required fields from both legs:

• phoneNumber

• bankCode (from the enum options)

• bankAccountNumber

• blockchainWalletAddress

4

Call Create order

Example request

{
  "quoteId": "68628fa56ff494df5f39faf5",
  "userCountryIsoCode": "NG",
  "userEmail": "[e-mail]",
  "userIp": "174.3.2.22",
  "deposit": {
    "paymentChannel": "bank",
    "currencyType": "fiat",
    "currencyCode": "NGN",
    "countryIsoCode": "NG"
  },
  "payout": {
    "paymentChannel": "crypto",
    "currencyType": "crypto",
    "currencyCode": "POLYGON_USDT",
    "amount": 100
  },
  "fieldsToCreateOrder": {
    "phoneNumber": "2348012345678",
    "bankCode": "120001:02",
    "bankAccountNumber": "1234567890",
    "blockchainWalletAddress": "0x5b7ae3c6c87f4a3f94b35c77233b13191ebfad20"
  }
}

Example response (transfer instructions excerpt)

{
  "quoteUsed": true,
  "order": {
    "_id": "68728fa56ff494df5f39faf5",
    "countryIsoCode": "NG",
    "userId": "57a28fa56ff494df5f39faf5",
    "userEmail": "[e-mail]",
    "status": "deposit_awaiting",
    "deposit": {
      "transferInstructions": {
        "type": "manual",
        "instructionsText": "Transfer the NGN to the agent's bank account.",
        "warningText": "Only transfer from the bank account you gave us, and include the narration.",
        "transferDetails": [
          { "id": "recipientBankName", "label": "Bank name", "value": "Sterling Bank" },
          { "id": "recipientBankAccountNumber", "label": "Bank account number", "value": "9012345678" },
          { "id": "recipientBankAccountName", "label": "Bank account name", "value": "Fonbnk Agent Ltd" },
          { "id": "amountToSend", "label": "Amount to send", "value": "153128" },
          {
            "id": "bankTransferNarration",
            "label": "Bank transfer narration",
            "description": "TRANSFER WITHOUT NARRATION WILL BE IGNORED BY THE SYSTEM.",
            "value": "shc-pshr4upg8s"
          }
        ],
        "fieldsToConfirmOrder": []
      }
    },
    "payout": { "...": "see Get order for the full object" },
    "expiresAt": "2026-08-20T13:10:10.000Z"
  }
}

The recipient* details are the agent's account — where the user sends the money. They are not the bankAccountNumber you collected, which is the user's own account and only identifies who is paying.

5

The user transfers the exact amount, with the narration

The narration is how the payment is matched. A transfer without it, or from a different account than the one they gave, will not be recognised.

6

Call Confirm order

fieldsToConfirmOrder is empty here, so the order ID is all you need.

Example request

{
  "orderId": "68728fa56ff494df5f39faf5"
}

7

We validate the deposit and send the payout

8

Wait for "payout_successful"

Handle the order-status-change webhook, or poll Get order.