Referência

Devoluções PIX

Solicite devolução e trate processamento ou falha.

POST /v1/payment-intents/:id/refunds

Exige refunds:write e Idempotency-Key. O corpo contém amountCents positivo e reason opcional de 3 a 280 caracteres. O serviço verifica o estado da cobrança e se o provedor oferece devolução.

Responde 201 quando concluída ou 202 quando segue em processamento. O evento payment_intent.refunded indica a devolução; consulte a cobrança para distinguir refunded de partially_refunded.

bash

curl -X POST "$API_BASE_URL/v1/payment-intents/$PAYMENT_ID/refunds" \
  -H "Authorization: Bearer $MINGOPAY_API_KEY" \
  -H "Idempotency-Key: pedido-1024-devolucao-001" \
  -H "Content-Type: application/json" \
  -d '{"amountCents":14990,"reason":"Cancelamento do pedido"}'

Devolução simulada

POST /v1/sandbox/payment-intents/:id/refund simula devolução total de uma cobrança paid criada no sandbox. A rota não recebe valor parcial.