Cancela um pagamento de cartão, total ou parcialmente. Envie amount com o valor a cancelar (amount > 0): menor que o valor original = cancelamento parcial; igual = cancelamento total.
A elegibilidade do cancelamento (saldo remanescente, janela de prazo, bandeira e situação da transação) é validada pelo adquirente — pedidos inelegíveis retornam 422 com o código do motivo (ex.: AMOUNT_IS_HIGHER_THAN_THE_REMAINING_BALANCE, CANT_REFUND_TRANSACTION_FROM_TODAY, ORIGINAL_TRANSACTION_DATE_IS_TOO_OLD, CARD_BRAND_NOT_SUPPORTED, ORIGINAL_CYCLE_NOT_ACCEPTED).
O cancelamento é assíncrono: a resposta pode ser provisória. O campo status do pagamento pode ser:
VOIDED— cancelamento total aceito (síncrono, mesmo dia).PARTIALLY_VOIDED— cancelamento parcial aceito.REFUND_PENDING/PARTIAL_REFUND_PENDING— aceito para análise; o resultado definitivo chega depois pelo webhookacquiring.financial_cycle, correlacionado porrrn.PENDINGnunca é retornado como erro.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Validação local (INVALID_AMOUNT quando amount <= 0, INVALID_JSON).
Token inválido ou IP não autorizado
Pagamento não encontrado
Cancelamento recusado por regra do adquirente (ex.: saldo insuficiente, fora da janela de prazo, bandeira não suportada).