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.