Guia do desenvolvedor – Manual de integração via POST

Guia do desenvolvedor – Manual de integração via POST

O Pagamento Ágil possui tecnologia para que você possa integrar o seu software ou aplicação web de forma fácil e prática.

A ideia é que consiga gerar uma cobrança através de um único post por exemplo.

Este guia auxiliará você na integração da sua aplicação com a plataforma Pagamento Ágil.

Uma das formas de integrar o seu site com a plataforma de cobrança é utilizando e método POST do protocolo HTTP ou HTTPS, neste artigo, abordaremos sobre este assunto. logo abaixo, exemplificamos os métodos disponíveis e a sua usabilidade.


Método CheckOut

Url: http://www.pagamentoagil.com.br/webservice/CheckOut
Método: POST
Descrição:
Integração via post, através deste método, você cria uma cobrança, e neste caso,  o usuário do seu site é redirecionado a uma tela de pagamento automaticamente.

Campos mínimos necessários para esta atividade:

  • token
  • cedente_token
  • cliente_nome
  • cliente_telefone
  • cliente_celular
  • cliente_cpfcnpj
  • cliente_email

Exemplo de formulário para fazer um post:

<form accept-charset="UTF-8" action="http://www.pagamentoagil.com.br/webservice/CheckOut" method="post">
        <input type="hidden" name="token" value="codigo_token_conta" />
        <input type="hidden" name="cedente_token" value="cod_token_cedente" />
        <input type="hidden" name="cliente_nome" value="Joaquim Lima S Dutra" />
        <input type="hidden" name="cliente_cpfcnpj" value="68288287395" />
        <input type="hidden" name="cliente_email" value="email@docliente.com" />
        <input type="hidden" name="valor" value="3,00" />
        <input type="submit" value="Enviar" />
    </form>

GetJson

Url: http://www.pagamentoagil.com.br/webservice/GetJson
Método: POST
Descrição: Cria uma cobrança e retorna o link para acesso a tela de pagamento.


Autorização para utilização dos serviços

Para utilizar os serviços , você precisará informar nos formulários os tokens da sua conta de acesso e do cedente o qual será o beneficiário pela cobrança.

  1. Para pegar o token da sua conta de acesso, acesse o Pagamento Ágil, clique na opção Desenvolvedor , note que existe um campo chamado TOKEN, anote este código.
  2. Para pegar o token da conta cedente, acesse o Pagamento Ágil, clique em CEDENTE, acesse a sua ficha, e clique na guia de formulário TOKEN.

Abaixo um exemplo de um formulário básico utilizado para criação de uma cobrança.

<form accept-charset="UTF-8" action="http://www.pagamentoagil.com.br/webservice/GotoCheckOut" method="post">
        <input type="hidden" name="token" value="codigo_token_conta" />
        <input type="hidden" name="cedente_token" value="cod_token_cedente" />
        <input type="hidden" name="cliente_nome" value="Joaquim Lima S Dutra" />
        <input type="hidden" name="cliente_cpfcnpj" value="68288287395" />
        <input type="hidden" name="cliente_email" value="email@docliente.com" />
        <input type="hidden" name="valor" value="3,00" />
        <input type="submit" value="Enviar" />
    </form>

Tabela de descrição dos campos

Campo Tamanho Tipo Descrição Obrigatório
token 50 texto Código token de sua conta do Pagamento Ágil Sim
cedente_token 50 texto Código token encontrado na ficha de cadastro do beneficiário / cedente Sim
cedente_nomefantasia 50 texto Nome do remetente da cobrança Não
cliente_nome 80 texto Nome do cliente Sim
cliente_cpfcnpj 14 texto CPF ou CNPJ sem formatação (somente números) Sim
cliente_telefone 12 texto Telefone do cliente DDD e numero ex: 119955544666 Não
cliente_celular 12 texto Celular do cliente DDD e numero ex: 119955544666 Não
cliente_email 70 texto E-mail do cliente Sim
valor 20 numérico valor da cobrança Sim
grupo 50 texto grupo ou categoria da cobrança Não
descricao1 70 texto campo livre para descricao da cobrança Não
descricao2 70 texto campo livre para descricao da cobrança Não
descricao3 70 texto campo livre para descricao da cobrança Não
descricao4 70 texto campo livre para descricao da cobrança Não
data_vencimento 10 data data do vencimento formato dd/mm/yyyy Não
invoice 10 número envie para pegar o status da cobrança, este código é gerado quando vc cria uma cobrança, é importante que guarde este código para posteriores consulta de status. Não

Deixe um comentário

Faça o login usando um destes métodos para comentar:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair /  Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair /  Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair /  Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair /  Alterar )

Conectando a %s