Create a payment

Create a hosted checkout session and get a checkout_url to send the customer to.

POST /api/v1/payments

cURL

curl https://pesarc.xyz/api/v1/payments \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "currency": "NGN",
    "reference": "order_1042",
    "merchant_name": "Ada Fabrics",
    "redirect_url": "https://ada-fabrics.com/thanks",
    "webhook_url": "https://ada-fabrics.com/api/pesarc/webhook"
  }'

200

{
  "id": "pay_7Q2m",
  "checkout_url": "https://pesarc.xyz/checkout/pay_7Q2m",
  "status": "pending"
}

Creates a payment session. Redirect the customer to the returned checkout_url; Pesarc hosts the payment page, settles on-chain and sponsors gas.

Request

Authorization · string · required

Bearer sk_live_…

amount · number · required

Amount to charge, in currency. Positive, up to 1,000,000,000.

currency · string · required

Currency code, 2–8 characters (e.g. NGN, GHS, KES).

redirect_url · string · required

Where to send the customer when they finish. Must be a valid URL.

reference · string

Your own id for this payment (max 64 chars). Use it to reconcile and dedupe.

merchant_name · string

Name shown to the customer on the checkout page (max 80 chars).

description · string

Short description of what’s being paid for (max 300 chars).

webhook_url · string

URL Pesarc POSTs settlement events to. See Webhooks.

payout_address · string

Optional 0x EVM address to settle this payment to.

metadata · object

Arbitrary key/value data echoed back to you on reads and webhooks.

ttl_minutes · integer

How long the session stays open, 1–1440 minutes.

Response

checkout_url · string

The hosted page to redirect the customer to.

id · string

The payment id.

status · string

Initial status (e.g. pending).

cURL

curl https://pesarc.xyz/api/v1/payments \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "currency": "NGN",
    "reference": "order_1042",
    "merchant_name": "Ada Fabrics",
    "redirect_url": "https://ada-fabrics.com/thanks",
    "webhook_url": "https://ada-fabrics.com/api/pesarc/webhook"
  }'

200

{
  "id": "pay_7Q2m",
  "checkout_url": "https://pesarc.xyz/checkout/pay_7Q2m",
  "status": "pending"
}

Confirm the final outcome server-side — via webhooks or GET /checkout/:id — rather than trusting the browser redirect.