Skip to content
Paybeta Checkout

NGN Hosted checkout for Nigerian businesses

Accept card, bank and USSD payments with one checkout link

Create a payment with a single API call, send your customer to a fast, secure checkout page, and get a signed webhook once Squad confirms the money. Settled to your Paybeta wallet the next business day.

Opens the real checkout for a live ₦100 payment. Your card will be charged.

Fee
1.4%max ₦2,000
Settlement
Next day
USSD banks
22

Accept every major Nigerian payment method

  • Visa
  • Mastercard
  • Verve
  • GTBank
  • *USSD#

Payment methods

Let customers pay the way they already do

Every payment method on one page. You choose which ones each payment offers with the channels field.

Cards

01

Visa, Mastercard and Verve. PIN, OTP and 3-D Secure all happen inside the checkout, so customers never get sent to another site.

USSD

02

Customers dial a code from any phone, with no data or smartphone needed. Works with 22 banks, including microfinance banks.

Bank account

03

GTBank customers pay straight from their account and confirm with the token their bank sends.

You choose what to offer

04

Offer every method, or only the ones that suit an order. Customers see just the methods you allowed.

Integration

Redirect to the checkout, or open it on your page

Both use the same payment you create on your server. Pick per page.

Redirect

Send the customer to checkout_url. When they've paid, we bring them back to your redirect_url. No front-end code at all.

// After creating the payment
return redirect($payment['data']['checkout_url']);

Popup

Keep the customer on your site. Add paybeta.js and open the checkout over your page from a button.

<script src="https://checkout.paybeta.ng/v1/paybeta.js"></script>

new PaybetaPop().resumeTransaction('pay_k3j9x2…', {
  onSuccess: (tx) => confirmOnServer(tx.reference),
  onCancel: () => {},
});

How it works

From order to settled in four steps

  1. 01

    Create a payment

    Your server calls POST /api/v1/payments with the amount, your reference and the customer's email.

    pending
  2. 02

    Customer pays

    They open the checkout, choose a payment method and finish in seconds, on desktop or mobile.

    pending
  3. 03

    We verify with Squad

    The payment is marked paid only when Squad confirms the full amount in naira. Then we send your webhook.

    successful
  4. 04

    Money settles

    The amount, less our fee, lands in your Paybeta wallet on the next business day.

    settled

Developers

An API you can integrate in an afternoon

Two endpoints, predictable JSON and amounts in naira. Use the live API key from your Paybeta console.

Test and live on one key
Send "mode": "test" to pay with Squad's test cards, and "mode": "live" for real money.
Safe to retry
The same reference always returns the same payment, so a timed-out request can be sent again.
Signed webhooks
Paybeta's standard webhook format, signed with your secret key, retried until you answer, and listed in your console.
Check any payment
GET /api/v1/payments/{reference} returns its current status at any time.
Read the full documentation
curl https://checkout.paybeta.ng/api/v1/payments \
  -H "P-API-KEY: $PAYBETA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "test",
    "reference": "ORDER-1001",
    "amount": 25000,
    "description": "Pro plan, monthly",
    "customer": { "email": "ada@example.com" },
    "redirect_url": "https://shop.example/thanks"
  }'

Pricing

One simple fee, capped

You only pay on successful payments. The fee is fixed when the payment is created and shown in the API response.

1.4% per payment,
capped at ₦2,000

  • Pass the fee to your customer on any payment with pass_charge
  • Settled to your Paybeta wallet the next business day
  • Test mode is free: test payments never move money
  • Volume pricing for larger businesses. Talk to us.
What you receive
Customer pays Fee You receive
₦5,000 ₦70.00 ₦4,930.00
₦25,000 ₦350.00 ₦24,650.00
₦100,000 ₦1,400.00 ₦98,600.00
₦1,000,000 ₦2,000.00 cap ₦998,000.00

With pass_charge, the customer pays the amount plus the fee and you receive the full amount.

Security

Paid means paid

A payment is only marked paid after Squad confirms the full amount. Never because a browser or a callback says so.

Verified with Squad

Every payment is checked against Squad's records, in naira and for the full amount, before it counts.

No card data stored

Card numbers, CVV, PIN and OTP go straight to Squad and are never saved or logged.

Signed, retried webhooks

Each webhook carries an HMAC signature. If your server is down, we keep retrying for hours.

A locked-down page

Strict content security policy, no third-party scripts, no cookies and no caching of payment pages.

FAQ

Questions, answered

Can't find what you need? The documentation covers every field and event.

Who can use Paybeta Checkout?

Any business with a Paybeta API account. You use the live API key you already have; there is nothing new to sign up for.

How much does it cost?

1.4% of each payment, capped at ₦2,000. You pay the fee by default, or pass it to the customer on any payment with pass_charge.

When do I receive the money?

Successful payments settle into your Paybeta wallet on the next business day. Weekends and public holidays are skipped.

Which payment methods are supported?

Visa, Mastercard and Verve cards with 3-D Secure, GTBank account debit and USSD on 22 Nigerian banks.

Can I test before going live?

Yes. Send "mode": "test" with your live API key and pay with Squad's test cards. Test payments never move money. Switch to "mode": "live" when you are ready.

Can customers pay without leaving my website?

Yes. Add paybeta.js to your page and open the checkout in a popup with PaybetaPop. Or redirect them to the checkout_url and bring them back to your redirect_url.

How do I know a payment really succeeded?

We send a webhook signed with your secret key once Squad has confirmed the full amount. You can also check any payment with GET /api/v1/payments/{reference}.

Do you store card details?

No. Card numbers, CVV, PIN and OTP go straight to Squad and are never saved or logged. We keep only the card brand and last four digits.

Take your first payment today

Already on the Paybeta API? Use your live API key and start with "mode": "test".