Consultar pagamento
Mesma consulta de GET /sales/{identifier}: aceita o id da venda (uuid), o código da venda (10 dígitos, com ou sem o prefixo, ou link terminado nele) ou a external_reference enviada no pedido, testados nesta ordem.
Sem campo de autorização: o portal autentica por você com a sua chave de Homologação e as requisições rodam só no ambiente de testes.
Token de acesso devolvido por POST /auth/token. Envie como "Authorization: Bearer ". Vale 24 horas.
In: header
Path Parameters
Id (uuid), código ou referência externa da venda.
Response Body
curl -X GET "https://pagpolar-api.creativecode.dev.br/v1/payments/string"{
"data": {
"id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"identifier": "PPO9876543210",
"external_reference": "PED-2026-0001",
"status": "PAID",
"type": "BILLING",
"payment_method": "PIX",
"installments": 1,
"total_amount": 197,
"cycle": 1,
"paid_at": "2026-01-20T14:32:10.000Z",
"refund_at": null,
"created_at": "2026-01-20T14:30:00.000Z",
"customer": {
"id": "e6f7a8b9-c0d1-4e2f-3a4b-5c6d7e8f9a0b",
"name": "Maria Souza",
"email": "maria@exemplo.com",
"document": "***.456.***-**",
"phone": "****4321",
"is_active": true,
"created_at": "2026-01-05T08:00:00.000Z"
},
"items": [
{
"quantity": 1,
"amount": 197,
"original_amount": 197,
"discount_value": 0,
"offer": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"identifier": "PPP1234567890",
"title": "Plano Mensal"
},
"product": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "Curso de Marketing Digital",
"type": "DIGITAL"
}
}
],
"shipping": {
"amount": 32.9,
"option_name": "SEDEX",
"address": {
"street": "Rua das Flores",
"number": "123",
"complement": "Apto 4B",
"neighborhood": "Centro",
"city": "São Paulo",
"state": "SP",
"postal_code": "01311000"
}
},
"payment_details": {
"qr_code": "00020126...",
"qr_code_expires_at": "2019-08-24T14:15:22Z",
"billet_barcode": "34191.79001 01043.510047 91020.150008 1 96610000015000",
"billet_link": "https://boletos.pagpolar.com/a1b2c3d4.pdf",
"last_credit_card_digits": "4242"
}
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}Fazer uma venda no PIX POST
Cria uma cobrança PIX em cima de uma oferta existente. O método de pagamento é definido pela própria rota, então não é preciso enviar `payment_method` no corpo. O header `Idempotency-Key` é **obrigatório**. Em caso de timeout, reenvie a requisição com a mesma chave: a resposta original será devolvida sem gerar uma segunda cobrança. A resposta desta rota traz o PIX **gerado** (`pix.qr_code`), não o **pago**. A confirmação do pagamento acontece de forma assíncrona — assine o webhook `TRANSACTION_PAID` para ser notificado assim que o PIX for pago, ou consulte `GET /sales/{identifier}` usando o `transactions[0]` da resposta para checar o `status` a qualquer momento. Esta rota **não cria assinaturas**: mesmo apontando para uma oferta recorrente, o resultado é sempre uma cobrança avulsa (`subscriptions` sempre vem vazio na resposta).
Consultar venda GET
Aceita três formas de referência, testadas nesta ordem: o `id` da venda (uuid, o mesmo que volta em `transactions` na criação do pagamento), o código da venda e a `external_reference` que você enviou no pedido. O valor só é tratado como código quando tem o formato do código: 10 dígitos, com ou sem o prefixo (ex.: `PPO0087103960`), ou um link terminado nele. Se a mesma `external_reference` foi usada em mais de um pedido, volta a venda mais recente.