Pincode for Business

Buyers pay with confidence.
You keep every naira.

Escrow-backed checkout that designs out chargebacks and abandoned carts. You’re paid the moment the buyer confirms.

Non-custodial

Funds sit at a licensed partner bank — never with Pincode

3 webhooks

held · released · refunded — that’s the integration

Escrow-backed

Every payment is protected until the buyer confirms

create a protected payment
POST /api/v1/payments
Authorization: Bearer sk_live_…
Idempotency-Key: order-2026-0001

{
  "customerId":  "usr_ada",
  "amountMinor": "4500000",        // ₦45,000 in kobo — integer, never a float
  "reference":   "order-2026-0001",
  "windowHours": 72
}

// → 201 Created
{
  "id": "pay_01HZX9AB…",
  "status": "awaiting_funding",
  "checkoutUrl": "https://checkout.pincode.com/pay/8F2A19"
}

pay_01HZX9 · ₦45,000

Held safely — safe to fulfil

Why merchants switch

Protection is a growth lever, not a cost.

The same escrow that protects buyers is what gets them to check out — and keeps your revenue clean.

More checkouts completed

First-time buyers hesitate at “pay first.” When the payment is protected, they complete — you win sales suspicion used to cost you.

Chargebacks designed out

Money is only released when the buyer confirms delivery or the window lapses. No “item not received” reversals weeks later.

Verified-seller trust

Your KYB-verified identity and the “protected payment” badge tell every buyer you’re the real thing — before they pay.

Integration

Three states. One golden rule.

You integrate against a payment’s lifecycle — not a maze of endpoints. Wire up three webhooks and you’re live.

awaiting_funding01

You create the payment

One API call per order returns a checkout link. Nothing is owed yet — never fulfil at this stage.

held02

Funds held safely

The buyer pays; the money is secured at a licensed partner bank. This is your green light — fulfil the order now, guaranteed.

released03

Released to you

The buyer confirms delivery (or the resolution window lapses in your favour). Recognise revenue; the payout settles to your account.

The golden rule

Fulfil on held. Recognise revenue on released. Never fulfil on awaiting_funding.

See the full webhook guide
payment.held → fulfil the order
POST https://yourstore.com/hooks/pincode
Pincode-Signature: t=1723,v1=6b8a…        // verify in constant time

{
  "event": "payment.held",                 // → fulfil the order
  "data": { "id": "pay_01HZX9AB…", "reference": "order-2026-0001", "status": "held" }
}
The platform

One integration. Every way you sell.

The same protected checkout — explore what it does, who it’s for, and what it costs.

Typed SDK & REST API

A generated, typed client so your team can’t misuse the API. Sandbox first, then flip to live.

Get started

Apply to integrate.

Onboarding is verified and hands-on. We KYB your business, provision your keys, and help you go live — no self-service shortcuts around the money.

  1. 1
    ApplyTell us about your business, volume, and use case.
  2. 2
    KYB verificationWe verify your business — required to go live and to toggle escrow off.
  3. 3
    Get provisionedWe issue your sandbox and live keys, and your dashboard access.
  4. 4
    Integrate & go liveWire up three webhooks, test in sandbox, then flip to live.
Non-custodial by designEscrowed money stays in the partner bank’s segregated account. It never touches Pincode’s balance sheet — or yours — until release.
KYB-verified merchantsGoing live and toggling escrow off are earned by business verification, not a checkbox.
Signed, idempotent webhooksEvery event is HMAC-signed and de-duplicated by id, retried with backoff. Verify in constant time, reject the unsigned.
Reconciliation you can auditAppend-only ledger and a daily reconciliation that pages ops on any drift — corrections are explicit reversing entries, never edits.