Pré-autorização de transações

Gerando reservas de saldo com intenção de cobrança nos cartões dos portadores

Conceito

A pré-autorização de uma transação nada mais é do que uma reserva temporária de saldo no cartão do portador, indicando uma intenção de cobrança (também chamada de cobrança ainda não confirmada).

Todas as validações de viabilidade de transação realizadas na autorização direta de uma transação também são realizadas na operação de pré-autorização, desde a pré-checagem feita pela Zoop até as validações em cima do cartão feitas pela adquirência, bancos emissores e bandeiras.

Requisição

Registrar pré-autorização

Para registrar uma pré-autorização você realizará uma transação (da forma como preferir) adicionando o parâmetro capture com valor false

POST / v1 /marketplaces/{{marketplace_id}} /transactions

{
   "amount":7,
   "capture": false,
   "currency":"BRL",
   "description":"venda",
   "on_behalf_of":"1e4c8c9b9886419098c60c53f2e7a57e",
   "token":"fc1ed9b54e884d658dc9a4f5d0bf4198",
   "statement_descriptor":"LOJA JOAO",
   "payment_type":"credit"
}
{
  "token": "fc1ed9b54e884d658dc9a4f5d0bf4198",
  "on_behalf_of": "1e4c8c9b9886419098c60c53f2e7a57e",
  "amount": 300,
  "capture": false,
  "description": "Uma descrição breve da motivação da sua transação",
  "statement_descriptor": "Loja do Joao"
}

Capturando pré-autorização

POST / v1 /marketplaces/{{marketplace_id}} /transactions/{{transaction_id}}/capture

{
  "on_behalf_of": "1e5ee2e290d040769806c79e6ef94ee1", //ID do Vendedor
  "amount": 0 // Valor para cobrar do cartão
}

Comportamentos Excepcionais API V2

1. Timeout entre a Zoop e a rede de adquirência:

No processo de autorização a Zoop espera um tempo máximo de 20 segundos pela resposta da autorização. Caso esse tempo seja excedido, a Zoop corta a comunicação com a adquirente, mantém a transação como pendente e armazena um histórico de operação de autorização também pendente.

Assincronamente, a Zoop recupera o estado dessa autorização e emite um evento informando o sucesso ou falha da autorização dessa transação.

2. Timeout entre a rede de adquirência e os bancos emissores ou bandeiras

Nesse caso, a Zoop recebe uma resposta do adquirente com um código referente a uma falha inconclusiva ocasionada por timeout. O comportamento nesse caso é o mesmo descrito na situação 1.

📘

Se o seu modelo de operação não suporta autorização assíncrona de transações, você pode solicitar a alteração do seu cadastro para habilitar a funcionalidade de desfazimento automático com o nosso suporte técnico. Essa funcionalidade faz com que todas as transações que sofram qualquer tipo de timeout sejam consideradas como falhadas e a Zoop executa todas as medidas necessárias para garantir que a fatura do portador não seja sensibilizada.

Updated 6 months ago


Pré-autorização de transações


Gerando reservas de saldo com intenção de cobrança nos cartões dos portadores

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.