Experience seamless payments with the Paga Checkout gateway! Create a hassle-free HTML payment form, where customers simply click to submit and gain instant access to an integrated checkout gateway. We help your customers complete the payment process and smoothly return them to your platform for more exciting interactions

Try Payment below

Experiment with the payment process by obtaining Test Data and initiating a sample payment.

📘
Sample Card:
Card number: 5531 8866 5214 2950
Expiry Date: 09/32
CVV: 555,
You can get more sample cards in Test Data and play around with the widget

Simple walk-through

Add an HTML form tag containing the script below to render a "Make Payment" button on your website
When the button is clicked, the checkout widget will be loaded within an iFrame
When payment is completed, the customer is redirected back to your success/failure page.

📘
Base URL
Live environment - https://checkout.paga.com/?
Test Environment - https://beta-checkout.paga.com/?

Each of the widget parameters is explained in the table below

<form method="POST">
  <script 
          src="https://checkout.paga.com/checkout/?w=150&h=40"
          data-public_key="23A3E317-7382-4032-94DE-50BA4B653EE5"
          data-amount="1000.00"
          data-currency="NGN"
          data-payment_reference="JHX-18743567"
          data-charge_url="https://mymarket/payment/complete"
          data-phone_number="+2348063334156"
          data-email="[email protected]"
          data-display_image="https://www.mypaga.com/paga-business/loginSuccess.paga#"
          data-button_label="Make Payment"
          data-width="200"
          data-callback_url="https://webhook.site/e86958dc-f24f-49a1-aedb-f7521fb44587"
          data-funding_sources="CARD,PAGA,TRANSFER,AGENT,USSD" >
  </script>
</form>

Arguments	Data Type	Required	Description
src	String	Yes	This must contain the link as indicated. please note the base url for test environment will be https://beta-checkout.paga.com and live environment will be https://checkout.paga.com
data-public_key	String	Yes	Public Key for your Paga business account
data-amount	Number	Yes	Amount you want customer to pay
data-currency	String	No	Default is `NGN`, specify if otherwise
data-payment_reference	String	No	Payment identifier, if not provided, paga will generate
data-charge_url	String	No	Location to redirect your customer after payment
data-phone_number	String	No	Customer's phone number
data-email	String	No	Customer's email address
data-display_image	String	No	Merchant preferred image on checkout
data-button_label	String	No	Checkout button label
data-width	Number	No	Desired button width
data-callback_url	String	No	To receive callback for payment, indicate callback url
data-funding_sources	List	No	If specific payment method is preffered, specify and separate with comma `CARD,PAGA,TRANSFER,AGENT,USSD`

After Payment

Three actions will happen immediately after payment is completed

Customer will be redirected automatically to data-charge_url provided in the script tag with charge_reference=JHX-18743567& status_message=success & status_code=0

https://neutral.site/payment/confirmation?charge_reference=JHX-7045679&status_message=success&status_code=0

Params	Data Type	Required	Description
charge_reference	String	Yes	This is payment reference you provided in the script tag, if not provided we generate one for you
status_message	String	Yes	`success`- Indicate the payment was successful
status_code	Number	Yes	`0` - Success Payment

We'll send you a webhook if you provide data-callback_url

{
    "statusCode": 0,
    "statusMessage": "success",
    "paymentReference": "JHX-18743567",
    "amount": 1000,
    "currency": "NGN",
    "timeStamp": "2021-03-08T15:52:13.000Z",
    "description": "Payment for the good of the nation",
    "customerEmail": "[email protected]",
    "customerPhoneNumber": "+2348063334156"
}

We'll send you an email if you've enabled notification on your business account

Verify Charge

This service allows the merchant to verify the status and details of an executed process to determine if a transaction was indeed executed on Paga system using the pre-shared transaction payment reference number.

https://checkout.paga.com/checkout/transaction/verify

POST /checkout/transaction/verify HTTP/1.1
Content-Type: application/json
Accept: application/json
Authorization: "Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ=="

{
  paymentReference:"JHX-18743567",
  publicKey:"40090E2F-7446-4217-9345-7BBAB7043C4C",
  amount:1000,
  currency:"NGN"
}

{
  "status_code": 0,
  "status_message": "successful",
  "chargeId":"",
  "amount": 1000,
  "currency": "NGN"
}

Response	Type	Mandatory(M)/Optional(0)	Description
status_code	String	M	A status code of 0 indicating successful transaction
status_message	String	M	A human-readable message describing the transaction result (success or fail)
chargeId	String	M	The unique reference number code provided with the request
amount	Number	M	amount charged
currrencu	String	M	NGN by default

Checkout Inline

Try Payment below

📘
Sample Card:

Simple walk-through

📘
Base URL

After Payment

Verify Charge

Try Payment below

📘Sample Card:

Simple walk-through

📘Base URL

After Payment

Verify Charge

📘
Sample Card:

📘
Base URL