Boleto Bancário

As transações feitas com Boleto funcionam um pouco diferente das transações com cartão de crédito, pois ao receber os dados do pedido será gerado um boleto, disponível online, e será retornado ao estabelecimento a URL de acesso para este boleto. Ela pode ser acessada a qualquer momento antes do vencimento do boleto e até 60 dias após o vencimento.

O Estabelecimento tem a opção abrir o boleto imediatamente em seu site, fornecer o link para que o comprador abra o boleto ou enviar o link por e-mail. Seja qual for a escolha, recomendamos guardar a URL do boleto caso seja necessária uma 2a.via.

Como gerar suas credenciais do Boleto Itaú

Esse processo funciona exclusivamente para BOLETO ITAÚ, demais bancos seguir pelo fluxo com alinhamento com comercial/cash.

Informe a Chave Pública Abaixo para seu Cash e ele irá te retornar com as chaves de integração

Atenção: somente credenciais geradas a partir dessa chave pública serão válidas no ambiente da Maxipago

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoy0MfqgRWW5+UY+W1BmE
H/DodonktCrUxcTOysrNFfUdZlc+4u62DtbXr6GvxYfmJ/t6UoVT6TS+KO6Ve6ks
pLCAubeZPeqhbyrYs3zDbH6GjXTd8EhJNDG8rz8ECZQ4gE3HGlneAfJ/rcgCkgRG
pIx53QPsbSeXxF8fjfl2+70M55NW6ZKy5XjdNK8Cb38WVEIswXSGDoImvoKqu6cY
HXxZ/AyZTcZuVZciPO7M+FcT5UaW9gTvINIB0uJdjDYJeppkT2vmHMHVf4uKE3sm
XkqpvV7egVDtR9dgXLYKAE80PU18NnbGehh16S1ViyZMgRSkDl8xSGhGWmWa9Uoj
mQIDAQAB

De posse da suas credenciais do Boleto Itaú você deverá acessar o Portal do Lojista da maxiPago:

  • Ambiente de Testes: Para habiltar o serviço de Boleto para testes, entre em contato com a Central E-commerce:
    • Capitais e regiões metropolitanas: (11) 4001-4433
    • Demais localidades: 0800 728 4433
    • E-mail: ecommerce@userede.com.br
  • Ambiente de Produção: https://portal.maxipago.net/vpos

1. Acesse o Portal com suas credencias (enviadas no e-mail de boas-vindas)

Login Portal

2. Acesse a aba: Admin – no menu superior (apenas disponível para perfil SuperUser)

3. Acesse a aba: Boleto

4. Acesse o submenu: Credencias – inclua as suas informações de Agência, Conta e Digito e depois informe Client ID, Token Temporário e Chave de Sessão (Enviados por E-mail pelo seu Cash)

Assim que as credenciais forem registradas, clique em salvar credenciais você já poderá começar a utilizar o boleto =)

Gerando um Boleto

O boleto é uma transação de venda direta, ou seja, utiliza a mesma tag <sale/>. Os dados do boleto, contudo, são passados dentro do elemento <boleto/>. Um boleto é sempre nominal, portanto faz-se necessário o envio dos dados do comprador no elemento <billing/>, sendo obrigatório: nome completo, CPF e endereço completo, uma vez que o boleto será registrado de acordo com as normas da Febraban.

Boleto – URLs Para Envio dos Dados

SANDBOX: https://testapi.maxipago.net/UniversalAPI/postXML

PRODUÇÃO: https://api.maxipago.net/UniversalAPI/postXML

Boleto – Exemplo de Requisição

<?xml version="1.0" encoding="UTF-8"?>
<transaction-request>
  <version>3.1.1.15</version>
  <verification>
    <merchantId>merchantId</merchantId>
    <merchantKey>merchantKey</merchantKey>
  </verification>
  <order>
    <sale>
      <processorID>11</processorID>
      <referenceNum>00987</referenceNum>
      <customerIdExt>86733401010</customerIdExt>
      <ipAddress>123.123.123.123</ipAddress>
      <billing>
        <name>Fulano de Tal</name>
        <address>Av. República do Chile, 230</address>
        <address2>16 Andar</address2>
        <district>Centro</district>
        <city>Rio de Janeiro</city>
        <state>RJ</state>
        <postalcode>20031170</postalcode>
        <country>BR</country>
        <phone>1121218889</phone>
        <email>fulanodetal@email.com</email>
      </billing>
      <transactionDetail>
        <payType>
          <boleto>
            <interestRate>
              <type>percentual</type>
              <value>10.50</value>
              <frequency>daily</frequency>
            </interestRate>
            <charge>
              <type>percentual</type>
              <value>2.00</value>
            </charge>
            <discount>
              <type>amount</type>
              <value>1.50</value>
            </discount>
            <expirationDate>2022-12-25</expirationDate>
            <number>12345678</number>
            <format>pdf</format>
            <financialDocumentType>DM</financialDocumentType>
            <instructions>Pagar até o vencimento</instructions>
          </boleto>
        </payType>
      </transactionDetail>
      <payment>
        <chargeTotal>12.00</chargeTotal>
      </payment>
    </sale>
  </order>
</transaction-request>;

Para realizar download da Tabela de Códigos do Parâmetro <financialDocumentType> Clique Aqui

Boleto – Exemplo de Retorno em Caso de Sucesso

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
  <authCode>0</authCode>
  <orderID>0A011599:01573BB84873:D0E0:566AB457</orderID>
  <referenceNum>00987</referenceNum>
  <transactionID>160376953</transactionID>
  <transactionTimestamp>1475767234</transactionTimestamp>
  <responseCode>0</responseCode>
  <responseMessage>ISSUED</responseMessage>
  <avsResponseCode />
  <cvvResponseCode />
  <processorName>BOLETO ITAU</processorName>
  <processorCode>34191751243456787041430070300006292100000001200</processorCode>
  <processorMessage />
  <processorName>BOLETO ITAU</processorName>
  <errorMessage />
  <boletoUrl>
    https://boletos.maxipago.net/redirection_service/boleto?ref=LmO9fsnOXyUgTcRusHkbMQFQx
  </boletoUrl>
  <processors>
    <processor index="1" type="BOLETO ITAU">
      <code>REGISTERED</code>
    </processor>
  </processors>
</transaction-response>

Boleto – Exemplo de Retorno em Caso de Erro

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<api-error>
  <errorCode>1</errorCode>
  <errorMsg><![CDATA[processor not found ]]></errorMsg>
</api-error>;

Boleto – Tabela de Parâmetros

Conciliando Pagamentos de Boleto

A confirmação de pagamento do boleto é offline. A maxiPago! recebe um arquivo de pagamento do banco listando os boletos pagos para o Estabelecimento. Nós então processamos este arquivo e atualizamos o status do pedido, que pode ser checado pelo Portal ou pela Requisição de Consulta. Para mais informações sobre a confirmação de pagamentos de Boleto contate nossa equipe de Suporte.

PARA BOLETO ITAÚ A CONCILIAÇÃO É ONLINE

*Aplicação de juros banco Itaú

Para operações do banco Itaú somente é possível incluir valor de juros quando o resultado de valor diário foi superior a R$ 0,01. Para valores de títulos baixos, o indicado é inserir o valor de juros em formato de moeda e não percentual.