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",
}
}
Parameter | Description | Required |
---|---|---|
type | This is the payment type. It will be BANK | ✅ |
accountName | This is the name of the sender | ✅ |