Skip to main content
CertoPay is a Brazilian payment gateway (PSP) that lets you accept PIX, Boleto, and Credit Card payments through a single REST API. Create customers, generate payment instructions, track transactions, and receive real-time notifications — all with a single API Key.

Quick Start

Make your first payment request in minutes with a step-by-step walkthrough.

Authentication

Learn how to get and use your API Key to authenticate every request.

Payment Methods

Explore PIX, Boleto, and Credit Card payment flows with code examples.

API Reference

Full reference for every endpoint, request parameter, and response field.

​
How CertoPay works

Every payment follows the same three-step flow: create a customer, create an order, and process the payment.
1

Create a customer

Register the buyer’s name, email, CPF, and phone number. You only need to do this once per buyer — reuse the same customerId for future orders.
2

Create an order

Link the customer to an amount in centavos (e.g., R$ 297.00 = 29700). The order returns an orderId you’ll use at checkout.
3

Process the payment

Call POST /api/payment-gateway/process with the orderId and payment method (PIX, BOLETO, or CARD). CertoPay returns the payment instruction (QR Code, barcode, or approval status) immediately.
4

Receive the confirmation

Configure a webhook endpoint on your server to receive real-time transaction.paid events when payment is confirmed.

​
Payment methods

PIX

Instant payments 24/7. Returns an EMV QR Code and copy-paste code.

Boleto

Banking slips with barcode and PDF. Standard 7-day expiration.

Credit Card

Visa, Mastercard, and Elo with installments up to 12×.
All amounts in the CertoPay API are in centavos (integer). R$ 297,00 = 29700.