Initiate Invoice Payment

Invoice Generation

For every request made to the Invoice Payment API, an invoice is automatically generated by Qwaap whose invoice number is shared in the response as invoice_number.

Invoice Payment Request API

POST https://apisdbx.qwaap.com/v1/request-payment

Headers

Name	Type	Description
Content-Type*	String	application/json
public-key*	String	Obtained from merchant account settings

Request Body

Name	Type	Description
transaction_currency*	String	Currency in which transactions will be made
request_amount*	Int/Double	At most 2 decimal places allowed for double.
merchant_reference*	String	The UNIQUE reference for this transaction generated by your system. A unique string value should be sent for every attempt. 4 to 36 character
narration*	String	Use this to add a brief description or comment on the transaction. 4 to 64 character
redirect_url*	String	Url e.g https://yourdomain.com that we redirect to.
customer_email*	String	Customer Email to which one time password(OTP) will be sent. Your customer will use this to login instantly.

200: OK

{
    "code": 200,
    "status": "success",
    "message": "Payment Initiated Successfully.",
    "data": {
        "invoice_number": "QINVMNTVMRGJ4TWK72PN",
        "merchant_reference": "ERYDTS234",
        "amount": 1000000,
        "currency": "NGN",
        "payment_status": "PENDING",
        "payment_url": "https://qwaap-quick.web.app/pay/QINVMNTVMRGJ4TWK72PN"
    }
}

401: Unauthorized

{
    "code": 401,
    "status": "error",
    "message": "public-key is required",
    "data": {}
}

The Invoice Payment Request API responds with the parameters below.

Parameter	Type	Description
currency	string	currency in which the payment is to be made.
amount	integer/double	Amount to be paid by the customer.
merchant_reference	string	Merchant transaction reference
invoice_number	string	Reference to the generated invoice.
payment_status	string	Current status of invoice payment
payment_url	string	Url to which you redirect your customers to complete payment.