Vamos integrar?
Esta versão de API foi descontinuada
A Mundipagg continua a oferecer suporte a clientes já integrados nessa versão mas não haverá novas implementações.
Para migrar para a nova API Mundipagg, acesse esta página.
Bem-vindo,
Queremos que você conheça um novo mundo de pagamentos online!
Essa é a nossa documentação! Nela você encontrará uma descrição das principais tendências no fluxo de pagamentos online, além de ter acesso a nossos métodos, operações e bibliotecas de integração.
Pensamos em cada passo para que você tenha uma experiência única e consiga transacionar com poucas linhas de código.
Você já tem sua MerchantKey?
Para enviar transações é essencial que você tenha uma MerchantKey. Ela é a autenticação necessária para todas as requisições enviadas aos nossos endpoints.
Para começar, vamos disponibilizar a MerchantKey de homologação que deve ser utilizada no nosso Sandbox. Se você ainda não possui uma MerchantKey, entre aqui.
MerchantKey
00000000-0000-0000-0000-000000000000
Endpoint - Sandbox
Nossa API foi construída sobre a arquitetura REST!
Com a MerchantKey em mãos basta enviá-la no campo de cabeçalho HTTP: MerchantKey. Você deve enviar no campo Content-type do cabeçalho o formato JSON (application/json) assim como no campo Accept.
MerchantKey: 00000000-0000-0000-0000-000000000000
Content-type: application/json
Accept: application/json
O endpoint do Sandbox da Mundi é:
Endpoint do Sandbox
Mantendo a segurança da integração
Para manter a segurança na troca de mensagens é necessário que nossos servidores sejam liberados no seu ambiente. Recomendamos fortemente que você libere o domínio mundipaggone.com.
Caso não seja possível a liberação do domínio, segue abaixo a lista de IP's que devem ser liberados:
IP's MundiPagg
52.186.34.80/28
104.45.183.192/28
52.160.136.0/28
13.88.79.144/28
209.134.53.73
208.93.65.183
23.101.169.64
104.209.129.203
52.184.196.158
208.93.65.163
40.143.28.35
208.93.65.185
40.70.66.232
Além disso, por sermos uma empresa PCI precisamos manter a segurança na troca de informações com as nossas APIs. Seguem as configurações aceitas:
Protocolos aceitos
TLS 1.1
TLS 1.2
Hashs Codes
SHA256
SHA384
SHA512
Cipher Suites
Com criptografia igual ou superior a 128 bits
Certificados Digitais SSL
A Mundipagg faz uso de uma tecnologia que provisiona de forma automática os certificados digitais das aplicações dos seus domínios.
Esses certificados tem validade de 1 ano e por isso, recomendamos sempre aos clientes, o envio das transações para o nome (FQDN) dos endpoints das nossas APIs.
Não é recomendado o pinning de certificado, com a chave pública.
Requisições para a API
As requisições enviadas para nossa API são as principais formas de comunicação com o nosso sistema. Para que essa comunicação seja bem sucedida, critérios básicos devem ser respeitados, senão você não conseguirá criar transações.
Dedicamos a seção Enviando requisições válidas para que você configure o seu código de maneira simples e evitando esses tipos de erros!
Bibliotecas de integração
Criamos algumas bibliotecas de diferentes linguagens para cortarmos alguns caminhos na integração. O objetivo é facilitar ainda mais a experiência para que você comece a transacionar rapidamente!
As bibliotecas que temos hoje são: