API v1

An API you'll
actually enjoy.

Predictable. Idempotent. Versioned. A documented REST API and an embeddable checkout widget, with signed webhooks you can actually debug.

● Built on the NIBSS NIP rail● Idempotent by default● Signed webhooks
tagpay-playgroundEditable
import TagPay from '@tagpay/node';



const tp = new TagPay(process.env.TAGPAY_KEY);



const charge = await tp.charges.create({

  amount:    48_250_00,        // kobo

  currency:  'NGN',

  customer:  'cus_A8cFxD2',

  methods:   ['card', 'transfer', 'ussd'],

  metadata:  { order_id: 'ord_1184' },

});



console.log(charge.status);   // 'succeeded'
<- 200 OK · 94ms · x-tagpay-req: req_98ax
{ "id": "ch_1184Xx8", "status": "succeeded", "amount": 4825000, "currency": "NGN", "fee": 48250 }
Webhooks you can debug

Signed. Retried.
Idempotent by default.

Every event is HMAC-signed with your webhook secret, retried on an exponential backoff, and includes a unique Tagpay-Idempotency-Key so you never double-process.

  • ✓ 14 event types
  • ✓ 5-min delay replay from dashboard
  • ✓ CLI forwarder for local dev
  • ✓ Delivery inspector with payload diff
webhook · POST /hooks/tagpay200 OK
POST /hooks/tagpay HTTP/1.1
Host: api.yourstore.ng
Tagpay-Signature: t=1713794412, v1=8fb3...c41
Tagpay-Event: charge.succeeded
Tagpay-Idempotency-Key: evt_9X2a
Content-Type: application/json

{
  "id":      "evt_9X2a",
  "type":    "charge.succeeded",
  "livemode": true,
  "data": {
    "id":     "ch_1184Xx8",
    "amount": 4825000,
    "fee":    48250,
    "method": "card"
  }
}
SDKs

Official SDKs are on the way.

Node, Python and more are in progress. Today, build on the REST API (/v1/) and the embeddable checkout widget — the examples above preview the planned SDK interface.

Read the API docs →
Security & compliance

Built on the
boring kind of trust.

Certifications aren't glamorous. Neither are audits. We invest in both — so you and your customers never have to think about them.

PCI DSSLevel 1

Card data is tokenised and never touches your servers.

CBNLicensed

Licensed by the Central Bank of Nigeria.

ISO 27001Certified

Information security management, certified.

NDPRCompliant

Nigeria Data Protection Regulation.

3DS 2.2Native

Frictionless auth on every supporting card.