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": "[e-mail]",
            "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.

200: OK Your request is valid

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

500: Internal Server Error Duplicate reference found

{
    "success": false,
    "error": {},
    "message": "Request failed with status code 422"
}

403: Forbidden