Skip to main content
Z2Pay is a payment service provider (PSP). With a single integration you can accept credit cards, PIX, and boleto, create recurring subscriptions, split funds between recipients, and track everything via webhooks in real time. This documentation is written so that anyone who has never touched the API can integrate from scratch — every parameter, every format, and every test scenario is described here.

Get started in 5 minutes

From zero to your first approved payment in the sandbox.

Test with confidence

Sandbox environment with cards that succeed and cards that fail — plus a built-in generator.

Authentication

How to obtain and use your API key.

Webhooks

Receive notifications for every status change.

​
What you do NOT need to build

The complex, regulated parts are handled by us:

PCI Compliance

Card data is tokenized by Z2Pay — it never touches your server.

PIX, boleto, and installments

QR Code generation, the digitized payment line, and installment calculations are all on us.

Routing across acquirers

You configure the gateway once; we choose the best route and handle failover automatically.

Payment page

Use the hosted Checkout and skip building a payment UI entirely.

​
Two ways to integrate

Hosted Checkout (simplest)

You create a link/session and the buyer pays on a page served by Z2Pay. No handling of card data. Ideal for getting up and running quickly.

Direct API (transparent checkout)

You control the entire experience and submit the payment via API, using a token generated by our tokenizer. More control, but requires careful attention to the tokenization flow.
All monetary values are integers in cents (R$ 49.90 = 4990) and dates follow ISO 8601 with timezone. See Conventions.