Skip to main content
POST
/
payments
/
pix
curl --request POST \
  --url https://api.pagozz.com/v1/payments/pix \
  --header 'Content-Type: application/json' \
  --header 'Pagozz-Token: <api-key>' \
  --data '
{
  "link_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "payer": {
    "email": "joao@email.com",
    "name": "João Silva"
  }
}
'
{
  "data": {
    "transaction_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "status": "processing",
    "br_code": "00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "qr_code_image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    "amount": 15000,
    "expires_at": "2026-02-27T14:15:00Z"
  }
}

Authorizations

​
Pagozz-Token
string
header
required

Chave de API no formato pgz_test_* (test mode) ou pgz_live_* (live mode). O ambiente é determinado automaticamente pelo prefixo da chave.

Body

application/json
​
link_id
string<uuid>
required

Obrigatório. ID do link de pagamento.

​
payer
object
required

Dados do pagador.

​
amount
integer | null

Valor em centavos. Obrigatório para links free e minimum. Ignorado para links fixed.

Response

Pagamento PIX criado. Use o br_code para copia-e-cola ou o qr_code_image para exibir o QR code.

​
data
object

Resposta da criação de um pagamento PIX.