Recarga HTML

Visão Geral#

O Carat possui duas interfaces para integração com a loja virtual, POST/HTML e Web Services (REST ou SOAP), possibilitando a maneira adequada de interação da loja com o Carat, conforme a linguagem e plataforma de execução da loja virtual.

A interface HTML foi definida para ser uma maneira simples e rápida de integração com os meios de pagamentos e serviços existentes no Carat, no entanto sem perder a flexibilidade. A interface padrão possui apenas dois parâmetros obrigatórios, realizando a coleta dos demais no próprio portal ou através de configurações realizadas pelo administrador da loja na retaguarda do Carat, no entanto se a aplicação da loja virtual quiser passar definições ou restrições para um determinado tipo de serviço, rede ou mesmo número de parcelas, isto poderá ser feito através do conjunto de parâmetros passados no início da transação, antes do redirecionamento do cliente.

Fluxo#

O fluxo padrão é iniciado pela loja após o comprador finalizar a compra:

Fluxo de recarga com pagamento Interface HTML 2.0#

A loja deverá iniciar a transação com o Carat enviando os dados da compra através do serviço de criação de transação.

O fluxo de recarga consiste nos seguintes passos:

  1. Após o comprador finalizar a compra, a loja cria uma nova transação no Carat, através de um POST na URL para iniciar uma transação, informando todos os parâmetros necessários. Saiba mais.
  2. Como resposta ao POST, a loja receberá uma URL do Carat a qual o comprador deve ser redirecionado. Esta URL será diferente a cada transação de recarga.
  3. O comprador selecionará os dados de recarga como concessionária/operadora, ddd, número de telefone e valor da recarga, e visualizará dados associados a este valor, como validade, bônus, etc.
  4. Após isto, o comprador seguirá com o fluxo de pagamento, selecionando a autorizadora de pagamento, dentre as disponíveis para a loja.
  5. Na etapa final do pagamento, as transações de pagamento e de recarga serão efetivadas, respectivamente na autorizadora e na concessionária/operadora, nesta ordem.
  6. Ao final do fluxo, o Carat irá redirecionar de volta o comprador para a loja, conforme configuração de URL’s de retorno já cadastrados na loja, ou para as back_url’s (vide Tabela 1) enviadas na criação das transações.

Para cada alteração de status da transação de pagamento no Carat, a loja receberá um POST de aviso de status, informando a situação da mesma. Saiba mais.

Todas as chamadas realizadas serão respondidas de forma síncrona exceto o aviso de status que será realizado pelo Carat de forma assíncrona.

Iniciando uma transação de recarga#

Para iniciar um recarga HTML, veja a documentação de quickstart.

Efetuando uma transação de recarga#

Ao acessar a url retornada pelo serviço de criação de transação, a tela de seleção de valores de recarga será retornada, conforme a figura abaixo:

Fluxo de recarga HTML -no-filter