Pix
Crie uma cobrança Pix
Crie o PaymentIntent Pix no servidor, com valor, prazo, comprador e URL de webhook.
POST
/api/v1/paymentintentsCrie a cobrança no seu servidor e leia o status e os dados de pagamento devolvidos. Neste exemplo, o valor é R$ 19,90 e o prazo é de 30 minutos.
curl -X POST "$DM_API_BASE/api/v1/paymentintents" \
-H "Authorization: $DM_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pedido-pix-1001-tentativa-1" \
--data-binary @pix.json{
"amount": 1990,
"currency": "BRL",
"paymentMethods": [
{ "type": "Pix", "amount": 1990 }
],
"paymentMethodOptions": {
"pix": { "expiresInMinutes": 30 }
},
"customer": {
"name": "Cliente de Teste",
"email": "cliente@example.com"
},
"postbackUrl": "https://loja.example.com/webhooks/dm",
"metadata": { "orderId": "pedido-pix-1001" }
}Campos
| Campo | Obrigatório | Descrição |
|---|---|---|
amount | Sim | Total em centavos. 1990 é R$ 19,90. |
currency | Sim | BRL. |
paymentMethods | Sim | Um item com type: "Pix" e amount igual ao total. |
paymentMethodOptions.pix.expiresInMinutes | Não | Prazo para pagar, inteiro maior ou igual a 1. Padrão: 30 minutos. |
customer.name, customer.email | Sim | Comprador. CPF/CNPJ e endereço são opcionais no Pix. Veja Dados do comprador. |
postbackUrl | Recomendado | URL HTTPS do seu servidor para os webhooks. Sem ela, você só descobre o pagamento consultando. |
metadata | Não | Pares texto/texto para referências do seu negócio, como orderId. |
description | Não | Descrição da cobrança. |
split | Não | Divisão entre recebedores. Veja Split. |
Os campos completos estão na referência da API.
Próximo passo
Exiba o QR Code e acompanhe o pagamento.