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": "ciroma@alade.com",
            "phone": "08101234567"
        },
    "metadata": {
        "location": "Abuja",
        "dispatch": [
            {
                "name": "Sender's Logistics ",
                "package": "Express Mini"
            }
        ] 
    }
}

POST {{base_url}}/payment/initialize

Fields with * are required

Headers

Name
Type
Value

Authorization*

String

Bearer {{your_secret_key}}

Content-Type

String

Application/json

Request Body

Name
Type
Description

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.

{
    "authorization_url": "https://checkout.browpay.com/0xGuq2ZLIDCZsVI",
    "success": true,
    "payment_reference": "egobetter4u247"
}

Last updated