Pasteaza payment infrastructure connecting Nigerian businesses, banks, wallets, and APIs — Pasteaza — payments infrastructure for Africa

Move money. Build what’s next.

Pasteaza gives your business one API for accepting payments, creating customer wallets, and sending funds. Start safely in test mode, then move the same integration to live mode by changing your API key.

Collect payments

Accept bank and crypto payments through a hosted checkout.

Create wallets

Assign monitored temporary or dedicated crypto wallets.

Send funds

Disburse funds through bank or crypto transfers.

Use an sk_test_ secret key while building. Test and live requests use the same API URL; your key selects the environment.

1. Get your test key

Create a Pasteaza merchant account, open the developer section of your dashboard, and copy your test secret key.

Key	Used for	Keep it
`pk_test_...`	Browser and client-side integrations	Public
`sk_test_...`	Server-to-server API requests	Secret

Never expose an sk_test_ or sk_live_ key in frontend code, a mobile application, a public repository, or browser logs.

2. Create a checkout session

Make this request from your backend. Amounts in NGN are sent in kobo, so 50000 means ₦500.00.

curl https://api.oyapasteaza.com/v1/checkout/sessions \
  -X POST \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "currency": "NGN",
    "description": "Order #1042",
    "customer": {
      "name": "Ada Okafor",
      "email": "ada@example.com"
    },
    "redirectUrl": "https://merchant.example/payment-complete",
    "metadata": {
      "orderId": "ORD_1042"
    }
  }'

Pasteaza returns a payment reference and a secure hosted checkout URL:

{
  "status": true,
  "message": "Checkout session created successfully",
  "data": {
    "reference": "ch_Fb8z7rX8r9w2",
    "checkoutUrl": "https://checkout.oyapasteaza.com/ch_Fb8z7rX8r9w2",
    "expiresAt": "2026-08-15T12:30:00.000Z"
  }
}

3. Send your customer to checkout

Redirect the customer to checkoutUrl. Pasteaza presents the payment methods enabled on your account and handles the payment experience for you. You can also open the same session inside your website with the Pasteaza browser SDK.

4. Confirm the payment

Listen for the checkout.payment.success webhook before fulfilling the order. Always verify the webhook signature and store the payment reference so repeated deliveries cannot fulfill an order twice.

Your server creates the session

Send the amount, order details, and optional customer information to Pasteaza.

Your customer completes payment

Redirect to the hosted checkout or open it with the browser SDK.

Pasteaza confirms the result

Your backend receives a signed webhook when the payment is successful.

Your business fulfils the order

Verify the event, match its reference to your order, and continue your workflow.

Production checklist

Keep secret keys in your server environment variables.
Add an Idempotency-Key to supported money-moving requests.
Verify every webhook signature before trusting its payload.
Store Pasteaza references alongside your own order references.
Handle pending, failed, and expired payments explicitly.
Replace the test key with an sk_live_ key only when your integration is ready.

Explore the platform

Authentication

Securely authenticate server-side requests.

Environments

Understand test and live request routing.

Idempotency

Safely retry supported API operations.

Webhooks

Receive and verify real-time payment events.

Getting Started

Collections

Disbursements

Quickstart

Move money. Build what’s next.

Collect payments

Create wallets

Send funds

1. Get your test key

2. Create a checkout session

3. Send your customer to checkout

4. Confirm the payment

Production checklist

Explore the platform

Authentication

Environments

Idempotency

Webhooks

​Move money. Build what’s next.

Collect payments

Create wallets

Send funds

​1. Get your test key

​2. Create a checkout session

​3. Send your customer to checkout

​4. Confirm the payment

​Production checklist

​Explore the platform

Authentication

Environments

Idempotency

Webhooks

Move money. Build what’s next.

1. Get your test key

2. Create a checkout session

3. Send your customer to checkout

4. Confirm the payment

Production checklist

Explore the platform