Comunidade de Desenvolvedores maxiPago!

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.