Receber PIX
Crie a cobrança, mostre o código ao cliente e confirme o resultado.
Campos da cobrança
POST /v1/payment-intents exige amountCents (inteiro entre 100 e 100.000.000), method pix e payer com name (2–120 caracteres) e taxId (CPF/CNPJ válido). payer.email é opcional.
Também aceita externalReference (até 100 caracteres), description (até 140), expiresInSeconds (60–86.400; padrão 1.800) e metadata (objeto; padrão vazio). O corpo rejeita campos desconhecidos. 14990 centavos representam R$ 149,90.
Resposta e confirmação
A criação retorna pix.copyPasteCode e pix.expiresAt. Exiba o código ao pagador. Para atualizar o pedido, prefira o webhook payment_intent.paid depois de validar sua assinatura; GET /v1/payment-intents/:id serve para consulta e reconciliação.
Não conclua a venda apenas porque a cobrança foi criada: pending ainda aguarda pagamento.
Consultar e listar
GET /v1/payment-intents/:id consulta pelo UUID. GET /v1/payment-intents aceita limit de 1 a 100 (padrão 25) e cursor em formato ISO de data/hora; a resposta devolve items e nextCursor.