API Reference
API Reference

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

https://sandbox.mundipaggone.com

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:

.NET
Java
PHP
Ruby
Python