Reembolsos

O reembolso pertence ao pagamento original e é solicitado com POST /v1/refunds, informando o public_id da cobrança.

curl -X POST https://integrate.api.kyvopay.com.br/v1/refunds \
  -H "X-API-Key: ky_XXXXX-XXXXX-XXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_public_id": "SEU_PUBLIC_ID",
    "amount_centavos": 4990,
    "reason": "Pagamento duplicado",
    "idempotency_key": "refund-pedido-4821"
  }'

payment_public_id é obrigatório. amount_centavos é opcional: quando omitido, o reembolso segue as regras do pagamento para o valor restante permitido.

Use uma idempotency_key derivada do pedido — repetir o pedido de reembolso com a mesma chave não devolve o dinheiro duas vezes. Veja Idempotência.

Um reembolso recusado pelo provedor volta com o status failed e o motivo em failure_reason.