Visão geral
A marx é a plataforma de pagamentos Pix da sua empresa. Com uma única integração você:
- recebe com cobranças Pix (QR Code e copia e cola) e links de pagamento prontos;
- devolve valores total ou parcialmente;
- envia Pix para chaves de terceiros (repasses), quando habilitado no seu contrato;
- cobra de forma recorrente com Pix Automático;
- emite notas fiscais de serviço (NFS-e, beta, quando habilitado no seu contrato);
- é avisado em tempo real por webhooks assinados;
- acompanha tudo pelo painel.
Dica
Primeira vez por aqui? Siga a ordem: credenciais → primeira cobrança → webhook. Em menos de uma hora você tem o fluxo completo funcionando.
Endereço da API
Todas as chamadas usam HTTPS na URL base:
https://marx.loco.ltd
Convenções
| Tema | Regra |
|---|---|
| Formato | JSON em UTF-8. Envie Content-Type: application/json e Accept: application/json. |
| Valores | Reais com até duas casas decimais, como texto: "19.90". Nas respostas, valores também vêm como texto. |
| Datas | ISO 8601 com fuso: 2026-10-06T14:03:22-03:00. Datas puras: AAAA-MM-DD. |
| Identificadores | UUIDs. Na cobrança, a consulta usa o pix_txid (32 caracteres). |
| Campos novos | Podemos adicionar campos às respostas e aos webhooks a qualquer momento. Ignore campos que você não conhece. |
Primeiros passos
1. Pegue suas credenciais
No painel, em Integração, copie o Client ID e gere um Client secret. Veja Credenciais e autenticação.
2. Crie uma cobrança
curl -X POST https://marx.loco.ltd/api/charges \
-H "X-Client-Id: $MARX_CLIENT_ID" \
-H "X-Client-Secret: $MARX_CLIENT_SECRET" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"charge": {"amount": "19.90", "reference": "pedido-1001"}}'
A resposta traz o código copia e cola (pix_qrcode), o identificador pix_txid e um payment_url com uma página de pagamento pronta para enviar ao cliente. Detalhes em Cobranças Pix.
3. Receba a confirmação
Cadastre a URL do seu servidor em Integração → Webhooks. Quando o cliente pagar, você recebe um POST com o status CONCLUIDA (lifecycle_status: "settled"). Veja Webhooks e Validar assinatura.
Funcionalidades por contrato
Algumas funções são liberadas pelo time marx para a sua empresa. Sem a liberação, a API responde 403.
| Funcionalidade | Padrão |
|---|---|
| Cobranças, devoluções, links de pagamento, webhooks | disponível |
| Repasses (envio de Pix) | sob liberação |
| Pix Automático | sob liberação |
| MED (gestão de infrações) | sob liberação |
| NFS-e (notas fiscais de serviço) | beta, sob liberação |
Referência completa
A Referência da API lista todos os endpoints, campos e respostas, e o arquivo openapi.json pode ser importado no Postman, Insomnia ou no seu gerador de SDK.