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.

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.

*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.