Captura uma pré-autorização existente, no valor original ou menor.
Códigos de erro
| HTTP | code | Significado |
|---|---|---|
400 | INVALID_JSON, MISSING_DOCUMENT_ID, MISSING_TRANSACTIONAL_TOKEN, INVALID_AMOUNT | Body inválido (amount deve ser > 0; não envie card/tokenData na captura). |
404 | PAYMENT_NOT_FOUND | paymentId não existe no seu tenant. |
422 | INVALID_STATUS | Pré-autorização não elegível: já capturada, já cancelada, falhou ou expirou. A mensagem diz qual caso. |
422 | INVALID_AMOUNT | amount maior que o valor pré-autorizado. |
422 | AUTHORIZER_REJECTED (em errors[]) | O emissor recusou a captura; msg traz o código de resposta. |
422 | MSG_GENERAL_ERROR (em errors[]) | Erro técnico transitório no processamento — retente; a reserva continua de pé. |
502 | ACQUIRER_COMMUNICATION_ERROR | Não obtivemos resposta do adquirente (a operação não foi recusada). A pré-autorização continua de pé e a reserva segue no limite do portador. Repetir é seguro — veja "Sem resposta do adquirente" abaixo. |
Sem resposta do adquirente
502 ACQUIRER_COMMUNICATION_ERROR significa que a chamada ao adquirente
não respondeu dentro do nosso tempo limite. Não é recusa e não é falha
do pagamento: a autorização original permanece intacta.
Nesse caso, repita a mesma chamada. Esta rota não tem estado terminal:
nós recarregamos o pagamento e reenviamos a operação, inclusive dias
depois. Não é necessário abrir chamado nem criar um novo pagamento.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Body inválido (INVALID_JSON, MISSING_DOCUMENT_ID, MISSING_TRANSACTIONAL_TOKEN, INVALID_AMOUNT)
Token inválido ou IP não autorizado
Pagamento não encontrado
Pré-autorização não elegível (INVALID_STATUS, INVALID_AMOUNT) ou recusa/erro do processamento (errors[])
ACQUIRER_COMMUNICATION_ERROR — sem resposta do adquirente. A pré-autorização continua de pé; repita a mesma chamada.