URL base e ambientes

Produção

As rotas da referência são relativas a essa URL base. POST /payment/pix/qrcode vira:

Não monte a URL a partir do domínio da documentação. docs.monkeypay.app serve conteúdo para desenvolvedores; as requisições vão para api.monkeypay.app.

Domínio próprio da marca

Se a sua empresa usa domínio próprio no Portal ou no Backoffice (white label), a URL base da API não muda: as chamadas continuam em https://api.monkeypay.app/api/v2, com as mesmas credenciais e o mesmo contrato. O domínio da marca serve só às telas do Portal e do Backoffice e não responde às rotas desta referência. Para apontar o domínio e configurar a marca, veja Domínio próprio e marca.

Ambientes

Hoje a documentação cobre apenas produção. Ambientes adicionais só devem ser usados quando forem disponibilizados formalmente pela MonkeyPay. Em produção, toda cobrança e todo envio movimentam dinheiro de verdade: valide a integração primeiro com as operações de leitura.

Configuração recomendada

• mantenha a URL base em configuração do servidor;
• não concatene na URL valores recebidos do usuário sem validá-los;
• use o formato de corpo indicado em cada endpoint: application/json para JSON e multipart/form-data para o envio de defesa com anexos;
• no envio multipart, deixe sua biblioteca HTTP definir o Content-Type com o separador dos arquivos (boundary). Com cURL, use -F, como no guia Infrações e MED.