Quickstart (merchant backend)

The recommended integration is server-to-server: your merchant backend calls WakaPay to create and track a checkout session, then your frontend only displays the resulting checkout UI (or redirects to it).

1) Authenticate

Most merchant/admin endpoints require a bearer token. In the API Reference, each endpoint is marked Auth when the OpenAPI spec declares security requirements.

2) Create a checkout session

Create a session containing amount, currency, merchant identifiers, and any metadata you need for reconciliation.

After creation, your customer is directed to a checkout experience where they can pay via supported crypto rails.

3) Track status until paid / expired

Your system should treat the session as the canonical source of truth for payment state. Poll the session, listen for webhooks (if enabled), and reconcile with matching/invoice flows.

4) Fulfill the order

When the session is marked paid, deliver the product/service and store the final payment reference (transaction hash, matching reference, or invoice reference depending on your flow).

Next: read the checkout lifecycle guide, or jump straight to API Reference.