Autorização direta de transações

Gerando novas cobranças sem necessidade de reservas de saldos anteriores

Conceito

Também chamada de cobrança confirmada, a autorização de uma transação nada mais é do que uma cobrança de um valor no cartão do portador.

No processo de autorização a Zoop realiza uma pré-validação da viabilidade da transação através de um passo-a-passo:

  • O vendedor responsável pela transação precisa ter sido previamente ativado, ou pelo menos habilitado, pela Zoop no processo de Credenciamento;
  • O valor mínimo de uma transação é de R$0,01, ou seja, 1 centavo de real;
  • No fluxo de cobrança de tokens descartáveis, o token informado precisa existir e nunca ter sido usado anteriormente (nem para transação e nem para associação)
  • No fluxo de cobrança do último cartão associado ao comprador, o comprador precisa ter um cartão de crédito previamente associado;
  • No fluxo de cobrança de cartão associado ao comprador, o cartão precisa existir e estar previamente associado à um comprador;
  • No fluxo de cobrança em uma requisição única de um cartão não tokenizado, os dados de cartão precisam estar completamente preenchidos, o número precisa ser aprovado pelo algoritmo de Luhn e as datas de validade do cartão precisam ser futuras.

As validações em cima do cartão, como saldo, possíveis bloqueios, veracidade dos dados, dentre outros são de responsabilidade das adquirentes, bancos emissores e bandeiras, sendo realizadas durante o processo de autorização da transação nas mesmas.

Cobrando em uma requisição única de um cartão não tokenizado

Indicado para parceiros que possuem certificação PCI-DSS e desejam trabalhar num modelo de integração sem tokenização de cartões e nem associação com compradores.

Para realizar essa integração é necessário apenas os seguintes passos:

  1. Colete os dados do cartão do cliente
  2. Crie uma nova transação digital em nome de um vendedor da sua plataforma, fornecendo os dados do cartão a ser debitado.
{
   "source":{
      "usage":"single_use",
      "card":{
         "holder_name":"JOAO SILVA",
         "expiration_month":"9",
         "expiration_year":"2027",
         "card_number":"4539003370725497",
         "security_code":"123"
      },
      "currency":"BRL",
      "type":"card",
      "amount":7
   },
   "amount":7,
   "currency":"BRL",
   "description":"Venda",
   "on_behalf_of":"1e4c8c9b9886419098c60c53f2e7a57e",
   "payment_type":"credit"
}
{
  "source": {
    "type": "card",
    "card": {
      "holder_name": "Fulano de Tal",
      "expiration_month": "9",
      "expiration_year": "2027",
      "card_number": "4539003370725497",
      "security_code": "223"
    }
  },
  "on_behalf_of": "1e4c8c9b9886419098c60c53f2e7a57e",
  "amount": 7,
  "capture": true,
  "description": "Uma descrição breve da motivação da sua transação",
  "reference_id": "822a8bda73c546a8b2f12a5ebcce7732",
  "statement_descriptor": "Loja do Joao"
}

Comportamentos Excepcionais para a 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 procedimento realizado nesse caso é 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


Autorização direta de transações


Gerando novas cobranças sem necessidade de reservas de saldos anteriores

Suggested Edits are limited on API Reference Pages

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