A integração por redirecionamento, é a maneira mais simples de habilitar o meio de pagamento iVarejo em seu E-commerce. Segue abaixo um tutorial explicando o passo a passo de como integrar a sua loja.
Como Funciona
A integração é realizada através de um post com alguns parâmetros que são enviados para o ambiente da iVarejo. Após o envio das informações, os dados são processados e o usuário é redirecionado para o sistema da iVarejo, para emitir os boletos e finalizar a transação.
Infográfico sobre o processo de funcionamento da integração
Como Começar 1. Insira o formulário abaixo em seu site com os seguintes campos:
- CodigoEntidade: Solicite para a iVarejo o Código Entidade da sua empresa.
- CodigoCanal: Solicite para a iVarejo o Código Canal do seu E-commerce.
- URLRespostaProcessoPagamento: Url do seu E-commerce que irá receber a resposta do pagamento após ser processado no ambiente da iVarejo.
- NumeroPedido: Número do pedido gerado pelo seu E-commerce.
- ValorPedido: Valor do pedido no formato decimal (Ex: 60.50) com duas casas após o ponto. obs: utilize ponto no lugar da virgula para separar os centavos.
- TipoComprador: Caso o comprador seja uma pessoa jurídica, utilizar a letra J, caso o comprador seja uma pessoa física, utilizar a letra F.
- CpfCnpjComprador: Caso o comprador seja uma pessoa jurídica, informe o CNPJ sem mascara (Ex:15180821000124), caso o comprador seja uma pessoa física, informe o CPF sem mascara (Ex:15875970120).
- TipoCanal: representa o tipo de mercado que seu E-commerce opera, caso sua loja opere no mercado B2B (comércio estabelecido entre empresas), informe no valor do campo a sigla B2B, caso sua loja opere no mercado B2C (efetuado diretamente entre a empresa produtora, vendedora ou prestadora de serviços e o consumidor final), informe no valor do campo a sigla B2C.
- Itens do Pedido: os itens do pedido são representados por um conjunto de campos:
- DescItemPedido1: Descrição do item do pedido.
- QtdItemPedido1: Quantidade deste item.
- ValorItemPedido1: Valor deste item.
Obs: Caso o pedido contenha mais de um item, adicionar novos campos. Ex:ItemPedido[x], QtdItemPedido[x], ValorItemPedido[x].
Segue abaixo o formulário html de exemplo:
<form id="Form1" method="post" action="{Solicitar à iVarejo a url para onde será realizado a emissão dos boletos}">
<input type="hidden" name="CodigoEntidade" value="{Solicitar à iVarejo o CodigoEntidade da sua empresa}" />
<input type="hidden" name="CodigoCanal" value="{Solicitar à iVarejo o CodigoCanal do seu E-commerce}" />
<input type="hidden" name="URLRespostaProcessoPagamento" value="{ URL do seu E-commerce que trata o retorno do pagamento}" />
<input type="hidden" name="NumeroPedido" id="NumeroPedido"/>
<input type="hidden" name="ValorPedido" id="ValorPedido" value="60.00" />
<input type="hidden" name="TipoComprador" id="TipoComprador" value="F"/>
<input type="hidden" name="CpfCnpjComprador" id="CpfCnpjComprador" value="39336858858"/>
<input type="hidden" name="TipoCanal" id="TipoCanal" value="B2C"/>
<!--Caso o pedido contenha mais de um item, adicionar novos campos. Ex:ItemPedido[x], QtdItemPedido[x], ValorItemPedido[x]-->
<input type="hidden" name="DescItemPedido1" value="Guarda-Chuva Super SPC" /><!--Nome do Item do Pedido-->
<input type="hidden" name="QtdItemPedido1" value="1" /><!--Quantidade do Item do Pedido-->
<input type="hidden" name="ValorItemPedido1" value="60.00" /><!--Valor do Item do Pedido-->
<input id="btnComprar" type="submit" value="Comprar" />
2. Tratar a resposta do processo de pagamento no seu E-commerce: após o usuário emitir os boletos no ambiente da iVarejo, o mesmo será redirecionado de volta para o E-commerce através da url de retorno. informada no formulário acima (campo URLRespostaProcessoPagamento). É necessário que tratar as seguintes variáveis de retorno:
- Codigo: retorna o código do status do pagamento, segue os seguintes tipos de código de retorno:
- IVJ.ECOMMERCE.ERR.001: Acesso não autorizado.
- IVJ.ECOMMERCE.ERR.002: Pedido não encontrado.
- IVJ.ECOMMERCE.INTERNALFAULT: Erro interno
- IVJ.ECOMMERCE.RET.002: Proposta aprovada.
- IVJ.ECOMMERCE.RET.003: Proposta reprovada.
- IVJ.ECOMMERCE.RET.004: Pagamento cancelado pelo cliente.
- Mensagem: a mensagem é retornada somente quando existe um erro no processo.
- CodigoPedido: retorna o código do pedido que foi informado anteriormente no post do formulário.
Após finalizar as etapas acima, sua loja estará pronta para operar com o meio de pagamento iVarejo. |
|