Initialize Transaction
Standard charge endpoint.
Always verify transactions before you give value; if you provide a callback in your payload we will be sending your transaction reference via a HTTP get request with a query ?reference=your_transaction_reference.
Sample Payload
{
"reference": "egobetter4u247",
"callback_url": "https://yourcallback.com",
"expires_in": 3,
"currency": "NGN",
"products": [
{
"name": "Toyota Avenza 2013 model",
"description": "3.5litre turbo V6 with 2k mileage, Silver Colour",
"amount": 630000000
},
{
"name": "Nike Air Max pro",
"description": "Factory signed, Size 40(EU)",
"amount": 40000000
}
],
"customer": {
"name": "Ciroma Alade",
"email": "[email protected]",
"phone": "08101234567"
},
"metadata": {
"location": "Abuja",
"dispatch": [
{
"name": "Sender's Logistics ",
"package": "Express Mini"
}
]
}
}POST {{base_url}}/payment/initialize
Fields with * are required
Headers
Authorization*
String
Bearer {{your_secret_key}}
Content-Type
String
Application/json
Request Body
reference*
String
Your unique Alphanumeric reference
expires_in*
Integer
A single-digit integer value between 0 - 30 days. You can make your customers define it but we prefer you do for consistency sake. However communicate this to your customers clearly before collecting payment. NOTE: for non-escrow/instant payments/settlements, set this at 0.
currency*
String
We only allow "NGN" at the moment
products*
Array
An array of objects
products.name*
String
The product you are selling
products.description*
String
A description of the product. Use clear terms. e.g. XL Natural Wool Male White Top
products.amount*
Integer
We expect a multiple of 100. That is, if your customer is paying 500 NGN we expect an input of 500 x 100. 50000 kobo
customer*
Object
An object of the customer information which consists of the name, email and phone keys
customer.name*
String
Your customer's first and last name.
customer.email*
String
Your customer's email
customer.phone*
String
An 11 character long string in this format "09101234567"
metadata
Object
Additional Information you would like to add e.g {location : "Abuja"}
callback_url
URL
Your callback endpoint for this transaction.
Last updated