> ## Documentation Index
> Fetch the complete documentation index at: https://docs.v2.certopaybrasil.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CertoPay: Brazilian Payment Gateway API

> Accept PIX, Boleto, and Credit Card payments in Brazil with the CertoPay API. Simple integration, real-time webhooks, and full transaction management.

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.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Make your first payment request in minutes with a step-by-step walkthrough.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Learn how to get and use your API Key to authenticate every request.
  </Card>

  <Card title="Payment Methods" icon="credit-card" href="/payments/overview">
    Explore PIX, Boleto, and Credit Card payment flows with code examples.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/payments/process">
    Full reference for every endpoint, request parameter, and response field.
  </Card>
</CardGroup>

## How CertoPay works

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Receive the confirmation">
    Configure a webhook endpoint on your server to receive real-time `transaction.paid` events when payment is confirmed.
  </Step>
</Steps>

## Payment methods

<CardGroup cols={3}>
  <Card title="PIX" icon="bolt" href="/payments/pix">
    Instant payments 24/7. Returns an EMV QR Code and copy-paste code.
  </Card>

  <Card title="Boleto" icon="file-invoice" href="/payments/boleto">
    Banking slips with barcode and PDF. Standard 7-day expiration.
  </Card>

  <Card title="Credit Card" icon="credit-card" href="/payments/credit-card">
    Visa, Mastercard, and Elo with installments up to 12×.
  </Card>
</CardGroup>

<Note>
  All amounts in the CertoPay API are in **centavos** (integer). R\$ 297,00 = `29700`.
</Note>