Documentation
Collections
Nigeria Collections

Nigeria Collection

When initiating a collection from Nigeria, the process follows a checkout flow:

  • Request Initialization: Upon making a request, a temporary virtual account is generated and returned.
  • Payment Expectation: This virtual account is set to receive a payment for the exact amount specified in the request. Overpayments or underpayments will be rejected or reversed.
  • Account expiry: The temporary virtual account is valid for 2 hours from creation time.

Below is a sample request for Nigeria collection:

Initialize Collections [POST]
curl --location '{{sandboxURL}}/wallets/collections/initialize' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
    "customerEmail": "ray.jon@mail.com",
    "country": "NG",
    "currency": "NGN",
    "amount" : 1000000,
    "description": "Payment for dress"
    "payload": {
        "type": "BANK",
        "accountName": "Musa Ahmed",
    }
}

ParameterDescriptionRequired
typeThis is the payment type. It will be BANK
accountNameThis is the name of the sender