Transações via cartão

O Gateway de pagamentos da 4all consiste em realizar transações somente com cartões de crédito, porém temos integrações com as principais bandeiras de cartão conforme apresentados na tabela abaixo.

Bandeiras:

• Visa
• Mastercard
• Diners
• Elo
• Amex
• Discover
• Aura
• JCB
• Hipercard
• Maestro

A 4all também trabalha com as principais adquirentes do mercado, como:

• Cielo;
• Getnet;
• Rede;
• Stone/Pagar.me.

Gerando uma transação com cartão de crédito

No gateway de pagamentos 4all existem duas possíveis formas para se realizar uma transação/cobrança via cartão de crédito e em ambas as formas existe um processo de tokenização. A tokenização trata-se de um processo pelo qual um dado sigiloso, como é o caso do número de um cartão de crédito, é substituído por símbolos afim de manter os dados seguros.

Tokenização

Trata-se de um processo pelo qual um dado sigiloso, como é o caso do número de um cartão de crédito, é substituído por símbolos afim de manter os dados seguros.

Caso um cartão seja tokenizado pela rota Criar token do cartão, este cartão não precisará passar pelos fluxos de tokenização novamente. Para transações futuras será necessário apenas informar o cardToken deste cartão.

Token de cartão temporário

Uma das formas de realizar uma transação via cartão é utilizando um token temporário este é obtido no corpo de resposta da rota Informar dados de cartão(/prepareCard). Utilizando essa forma de cobrança é necessário que a cada nova transação o processo de tokenização seja realizado novamente.

graph LR
  subgraph ed_3 [Transação com token de cartão temporário]
    A(Request Vault Key) -->|accessKey| B(Prepare Card)
    B -->|cardNonce e brandId| D(Create Transaction)
  end

Token de cartão permanente

Através do token de cartão permanente é possível realizar transações/cobranças chamando somente o token do cartão obtido na rota Criar token de cartão (/createCardToken). Na primeira transação é necessário cumprir com o fluxo completo conforme ilustrado abaixo:

graph LR
  subgraph ed_3 [Transação com token de cartão permanente]
    A(Request Vault Key) -->|accessKey| B(Prepare Card)
    B -->|cardNonce| C(Create Card Token)
    C --> |cardToken| D(Create Transaction)
  end

Transação Autorizada

Para que a transação seja realizada, é necessário primeiramente sua autorização. Nesta etapa a instituição financeira verifica se o portador do cartão possui crédito suficiente para realizar a transação, e em caso positivo irá autorizá-la.

Uma chamada da API do gateway para criar uma transação, usualmente, apenas a autoriza. É possível informar nos seus parâmetros que a transação deve também ser capturada. Se este for o caso, o gateway captura a transação automaticamente (caso ela seja autorizada com sucesso). > A chamada /createTransaction pode fazer a captura automaticamente se for passado o parametro autoCapture: true, caso o contrario é preciso fazer as duas chamadas.

Nem sempre é interessante realizar a captura instantaneamente. O EC pode estar interessado apenas em saber se o cartão de crédito é valido ou garantir que o seu cliente tenha crédito para pagar pelo serviço que será prestado.

As transações autorizadas que não forem capturadas em até 5 dias serão canceladas.

Transação Capturada

Após a transação ser autorizada, ela estará disponível para captura, termo utilizado para indicar que o valor será cobrado do portador do cartão de crédito.

Transação Cancelada

Quando um cliente contesta uma transação junto à operadora do seu cartão de crédito, isto pode resultar num chargeback , situação em que o valor da transação não será repassado ao EC que fez a transação, mesmo que o produto tenha sido entregue ou o serviço tenha sido prestado.

O chargeback é algo inerente ao mercado. É inevitável que aconteça em algum momento, então é importante que o EC preveja esta situação e saiba como proceder quando isto ocorrer.

Cancelamento de pagamento

Caso haja necessidade de um cancelamento, este pode ser feito de forma simples pela chamada a seguir.

Cofre de cartões

A 4all desenvolveu um cofre de cartões com certificação PCI-DSS (Payment Card Industry – Data Security Standard) que é um padrão de mercado para assegurar o uso de cartões de crédito. O Cofre de Cartões 4all é usado para armazenamento dos dados de cartões de maneira segura.

O envio dos dados do cartão deve ser realizado do FRONTEND diretamente ao servidor do cofre de cartões, desta maneira a informação de cartão não circula em outros ambientes não conformes com o padrão de segurança PCI.

Simulação de pagamento com cartão em desenvolvimento

Em ambiente de desenvolvimento, é possível simular um comportamento mais realista de aprovação/rejeição de pagamento de acordo com o último dígito do cartão. O comportamento segue a seguinte tabela:

Para gerar um número de cartão válido pode ser usado um gerador de cartão de crédito

Tabela de status de uma transação via cartão

Adquirentes

Bandeiras de Cartão

Tipos de uma Operação

Status de uma Operação