Quickstart

Create an API key and take your first hosted payment in about ten minutes.

This guide takes you from zero to a working, hosted checkout you can send a customer to.

1. Get an API key

Open the app, go to Developers, and create a key. The full secret is shown once — copy it immediately and store it somewhere safe. Keys look like:

sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Treat your secret key like a password. Never commit it, never ship it in client-side code, and never paste it into a page or chat. If a key leaks, revoke it in Developers and create a new one.

You can also create a key over the API — see API keys.

2. Confirm the key works

Every request authenticates with an Authorization: Bearer header. Ping the API to check your key and see which account it is scoped to:

cURL

curl https://pesarc.xyz/api/v1/ping \
  -H "Authorization: Bearer sk_live_xxx"

Response

{ "ok": true, "account": "acct_...", "live": true }

3. Create a payment

Create a hosted checkout session. The only required fields are amount, currency and a redirect_url to return the customer to when they are done.

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://your-store.com/thanks",
    "webhook_url": "https://your-store.com/api/pesarc/webhook"
  }'

The response includes a checkout_url. Redirect the customer there.

4. Send the customer to checkout

Redirect to checkout_url. Pesarc hosts the payment page, handles the on-chain settlement and gas sponsorship, then returns the customer to your redirect_url.

5. Confirm the result

Do not trust the browser redirect alone. Confirm the payment server-side:

• Webhook — if you passed a webhook_url, Pesarc notifies your endpoint when the payment settles. See Webhooks.
• Poll — read the session status any time from GET /checkout/:id.

That’s a full loop: key → payment → hosted checkout → confirmation. From here, wire it into your store, your SaaS billing, or an AI agent.