Iniciar: pagamento simples

3 etapas são necessárias para integrar um formulário de pagamento no site do Estabelecimento Comercial:

• A inicialização do formulário incorporado
• A exibição do formulário incorporado
• A verificação do status da transação no final do pagamento.

O layout seguinte apresenta as interações entre as diferentes partes (formulário embutido, servidor do Estabelecimento Comercial, plataforma de pagamento) para cada uma destas etapas:

1. Inicializar o formulário

Antes de exibir um novo formulário de pagamento no site de e-commerce, você deve inicializar o formulário gerando um token de formulário (ou formToken ) que vai sintetizar todas as opções relacionadas ao pagamento.

Para criar un formToken, é preciso chamar o Web Service REST Charge/CreatePayment a partir do seu servidor:

Etapa	Descrição
1	Camada do Web Service REST Charge/CreatePayment a partir dos servidores do Estabelecimento Comercial.
2	Recepção do resultado contendo o formToken.

O formToken permanece válido durante 15 minutos.

Consulte a lista de casos de uso para facilitar a inicialização do seu formulário.

2. Exibir o formulário

Para exibir o formulário de pagamento, deve incluir nossa biblioteca JavaScript no header da sua página de pagamento.

É imperativo que a biblioteca principal seja instalada o quanto antes, bem antes das outras livrarias JS usadas na sua página.

O formToken deverá ser adicionado ao código de integração. Será usado pela biblioteca JavaScript para exibir o formulário a partir do formToken definido na etapa anterior:

Etapa	Descrição
3	Download da livraria JavaScript. Solicitação realizada a partir do navegador do comprador.
4	Recuperação do JavaScript, e exibição da página contendo o formulário de pagamento.

Uma vez que o formulário foi exibido, o comprador pode digitar seus dados bancários. Se o pagamento for recusado, o comprador ficará no site do Estabelecimento Comercial. Se o pagamento for aceito, os dados da transações serão enviados ao servidor Estabelecimento Comercial.

3. Verificar o status da transação

Quando a transação for aceita ou que a quantidade máxima de tentativas foi atingida, o cliente JavaScript realiza um POST do formulário de pagamento. É realizado da mesma forma que para um formulário HTML clássico. Você recupera os dados de pagamento nos parâmetros POST enviados para seu servidor.

Etapa	DESCRIÇÃO
5	O comprador clicou no botão “pagar”: apresentação do formulário a partir do navegador do comprador para nossos servidores. Esta chamada é realizada automaticamente pelo nosso cliente JavaScript.
6	Uma vez que a transação foi tratada, chamamos a partir de nossos servidores uma URL que você determinou. O objeto Transaction completo será enviado para que você possa atualizar seu sistema de informação antes da volta para a loja. É a IPN (Instant Payment Notification).
7	Nossos servidores retornam o resultado do pagamento ao cliente JavaScript.
8	O cliente JavaScript envia o formulário de pagamento aos seus servidores.

Tratar a IPN permite atualizar seu sistema de informação com mais segurança e garante que não perca nenhum pagamento no caso da conexão internet do comprador falhar. Para maiores informações, favor consultar o artigo dedicado à IPN aqui: Ipn: Apresentação

Pronto, vamos lá

Após este interlúdio teórico, é hora de passar para coisas concretas: indefinido