Checkout parcelado
Crie a cobrança Pix parcelado, redirecione o comprador para a Pagaleve e confirme o pagamento pelo servidor.
/api/v1/paymentintentsCrie a cobrança
Exemplo de R$ 299,90:
curl -X POST "$DM_API_BASE/api/v1/paymentintents" \
-H "Authorization: $DM_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pedido-pagaleve-1001-tentativa-1" \
-d '{
"amount": 29990,
"currency": "BRL",
"paymentMethods": [{ "type": "Pagaleve", "amount": 29990 }],
"customer": {
"name": "Cliente de Teste",
"email": "cliente@example.com",
"document": "12345678909",
"phone": "+5511999999999"
},
"paymentMethodOptions": {
"pagaleve": {
"approveUrl": "https://loja.example.com/pedidos/1001/retorno",
"cancelUrl": "https://loja.example.com/pedidos/1001/cancelado"
}
},
"postbackUrl": "https://loja.example.com/webhooks/dm",
"metadata": { "orderId": "pedido-pagaleve-1001" }
}'| Dado | Requisito |
|---|---|
| Comprador | Nome, e-mail, CPF e telefone são obrigatórios. CPF com 11 dígitos e telefone brasileiro em formato internacional. |
approveUrl | Página do seu checkout para onde o comprador volta ao concluir. |
cancelUrl | Página do seu checkout para onde o comprador volta se cancelar. |
| URLs de retorno | Opcionais na API, mas recomendadas. URLs HTTPS absolutas de até 2048 caracteres. |
As URLs de retorno servem só para navegação. Uma visita a approveUrl não comprova pagamento: qualquer pessoa pode abrir a URL. A confirmação vem do servidor.
Redirecione
{
"id": "b8b31f32-96e7-43a2-91aa-cab38b9d90ca",
"object": "payment_intent",
"amount": 29990,
"currency": "BRL",
"status": "Processing",
"pagalevePayment": {
"checkoutId": "7ba08c1f-3214-4d76-88b4-7326cc4f4ac9",
"checkoutUrl": "URL_RETORNADA_PELA_API",
"expiresAt": "2026-09-08T18:30:00Z",
"status": "NEW"
}
}Redirecione o comprador só se pagalevePayment.checkoutUrl estiver presente. Use o valor completo, sem montar a URL a partir de checkoutId. Se a cobrança voltar Processing sem checkoutUrl, consulte o mesmo PaymentIntent e, se persistir, fale com a equipe de integração. Não crie outra cobrança automaticamente.
Confirme
| Momento | Ação |
|---|---|
| Checkout criado | Grave o PaymentIntent e redirecione o comprador. |
| Comprador conclui o parcelamento | A Accelerazione faz a captura automaticamente. |
| Comprador volta ao seu checkout | O seu servidor consulta o PaymentIntent. Mostre "processando" enquanto não houver confirmação. |
Succeeded | Pagamento confirmado. Conclua o pedido de forma idempotente. |
Failed ou Canceled | Mostre o resultado e, se quiser, permita uma nova tentativa com nova chave de idempotência. |
Use o status da raiz do PaymentIntent como referência. pagalevePayment.status é um registro do checkout e pode continuar NEW mesmo depois que o pagamento evolui.
- A captura confirmada publica
payment_intent.succeeded; a falha de captura,payment_intent.failed. - A expiração segue
expiresAt. Cancelamento e expiração aparecem comoCanceledna consulta, sem webhook específico.
Erros comuns
type | Causa |
|---|---|
pagaleve_customer_document_required | Falta o CPF em customer.document. |
pagaleve_invalid_approve_url, pagaleve_invalid_cancel_url | URL de retorno inválida. |
pagaleve_checkout_failed | A geração do checkout não concluiu. Confira dados, telefone e valor. |