Integração Síncrona por redirecionamento

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"/>
        <!--Itens do Pedido-->
        <!--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" />
    </form>

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.