INTEGRAÇÃO VIA API

A principal característica da integração via API é que os dados do cartões de crédito são digitados no site do estabelecimento e então enviados para a maxiPago!. Nesse processo não há existência de pop-up ou redirecionamentos. A responsabilidade de coletar os dados do cartão do comprador é do estabelecimento, logo, deve existir uma preocupação com a segurança dos dados. É necessária a compra de um certificado de segurança SSL.

A maxiPago! possui bibliotecas de integração em Java, .NET, PHP, Python e Ruby à disposição para ajudar com o desenvolvimento de sua plataforma, disponíveis em http://www.maxipago.com/api.

NOTA: Para as integrações API e Magento o PCI há um requisito obrigatório em relação a segurança que é a utilização do certificado de segurança TLS 1.2 (Transport Layer Security) ou versão superior. A maxiPago! como parceiro PCI certificado solicita aos seus clientes verificar os requisitos técnicos necessários para a implementação desse certificado de segurança.

O manual para integração básica em inglês pode ser encontrado neste documento

AMBIENTE DE TESTES

No ambiente de testes é possível simular a maioria das requisições e transações. Lembre-se que no ambiente de testes nenhuma transação será de fato processada.

Abaixo temos a lista de cenários que gerarão respostas programadas da nossa plataforma:

Abaixo há uma lista de cartões teste disponíveis. O campo de CVV pode ser preenchido com qualquer número com 3 ou 4 dígitos e a data de vencimento precisa apenas ser válida, ou seja, sempre no futuro:

CREDENCIAIS DO ESTABELECIMENTO

Para qualquer chamada feita em nossa base é preciso que o Estabelecimento se identifique com as suas credenciais. O ID de Loja e a sua Chave são informados pela nossa equipe quando seu cadastro é criado.

Independentemente da requisição que estiver chamando você deverá informar suas credenciais dentro do elemento , da seguinte forma:

<verification>
  <merchantId>store-id</merchantId>
  <merchantKey>secret-key</merchantKey>
</verification>

MEIOS DE PAGAMENTO DISPONÍVEIS

CARTÃO DE CRÉDITO

BOLETOS

TRANSFERÊNCIA BANCÁRIA

TIPOS DE REQUISIÇÕES

A troca de informações com a maxiPago! é feita através de um XML enviado diretamente no corpo do Post, ele não deve estar dentro de nenhum parâmetro e nem ser enviado em um formulário.

O content type deve ser text/xml e o charset deve ser UTF-8.

Há três tipos de requisição que podem ser feitas à maxiPago!:

– Requisição de Transação: Processa pedidos de Cartão de Crédito e Boleto. Nó raiz do XML: <transaction-request/>, retornando <transaction-response/>

– Requisição de Cadastro: Efetua operações cadastrais, como salvar um cartão na base. Nó raiz do XML: <api-request/>, retornando <api-response/>

– Requisição de Consulta: Consultar os pedidos na base. Nó raiz do XML: <rapi-request/>, retornando <rapi-response/>

Cada tipo de requisição tem uma URL de teste específica:

TRANSAÇÕES (teste): https://testapi.maxipago.net/UniversalAPI/postXML
CADASTRO (teste): https://testapi.maxipago.net/UniversalAPI/postAPI
CONSULTA (teste): https://testapi.maxipago.net/ReportsAPI/servlet/ReportsAPI
SMARTPAGE! (HTTPS Redirect) (teste): https://testsecure.maxipago.net/hostpay/HostPay