Quick Start

Coloque uma cobrança Pix de pé em menos de 5 minutos. Este guia assume que você já tem um API Token (veja Autenticação).

1. Pré-requisitos

Item	Valor
Base URL	`https://api.betpaympix.com`
Prefixo	`/v1`
Autenticação	`Authorization: Bearer <API_TOKEN>`
Valores	em centavos (`1990` = R$ 19,90)

2. Gere uma cobrança Pix

Não há um passo separado para criar o merchant: ele nasce junto da cobrança, pelo objeto merchant (identificado pelo seu externalId).

curl -X POST https://api.betpaympix.com/v1/pix \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "amount": 1990,
    "callbackUrl": "https://sualoja.com/webhooks/payerpix",
    "merchant": { "externalId": "minha-loja", "name": "Minha Loja" }
  }'

A resposta traz o QR Code (copia e cola) e o id da cobrança. Nas próximas cobranças você pode repetir o mesmo externalId ou usar o merchantId retornado.

4. Receba a confirmação

Quando o pagador concluir o Pix, enviamos um webhook para a sua callbackUrl. Não confie em polling como fonte de verdade — o webhook é o evento oficial. Veja Webhooks.

5. Próximos passos

Autenticação — emita e proteja seu token
Ambientes — sandbox vs. produção
Splits — divida a receita automaticamente
Erros — entenda os códigos de retorno

Introdução

Autenticação