O que você precisa
| Campo | O que faz |
|---|---|
| API key ID | Identifica a sua chave de API do MakePay para que chamemos a conta certa. |
| API key secret | Nos permite criar checkouts do MakePay na sua conta. Secreto. |
| Webhook secret | Confirma que um webhook realmente veio do MakePay. Secreto. |
| URL de sucesso | Para onde o comprador chega depois de um pagamento concluído. |
| URL de falha | Para onde o comprador chega se o pagamento falhar ou ele cancelar. |
O MakePay emite o API key ID e o secret juntos quando você gera uma chave; o webhook secret é um valor separado das suas configurações de callback.
Por que pedimos cada campo
API key ID
Nomeia qual chave do MakePay autenticamos. Não é secreto por si só, mas é pareado com o secret abaixo.
API key secret
Autoriza a criação do checkout, para que o pagamento corra pela sua conta do MakePay e seja depositado na sua carteira. O MakePay o mostra uma vez, logo após você gerar a chave.
Webhook secret
Prova que um webhook recebido é genuinamente do MakePay, para que ninguém possa forjar um evento de "pago". É um valor separado da chave de API.
URL de sucesso e falha
Configurações simples: para onde o comprador chega depois de pagar ou depois de uma falha ou cancelamento. Não são secretas.
Configurar
- Gere uma chave de API no MakePay
Entre no MakePay e abra API & SDK → API integrations. Em API keys, clique em Generate API Key, dê um nome como "Coin Moebius", e crie-a. O MakePay mostra o API key ID e seu secret uma vez, logo após a geração — copie ambos agora, porque o secret não é mostrado novamente.
MakePay → API & SDK → API integrations → Generate API Key Trate o API key secret como uma senha. Se você perder, gere uma chave nova em vez de tentar recuperar a antiga.
- Encontre o ID do seu projeto no Coin Moebius
Em uma aba separada, abra seu projeto no painel do Coin Moebius e copie o ID do Projeto sob o nome do projeto. Sua URL de callback do MakePay é esse ID inserido no endereço abaixo — você vai colar isso no MakePay na próxima etapa.
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → seu projeto → Project ID O cartão do provedor conectado (último passo) mostra a mesma URL, para que você possa copiá-la novamente a qualquer momento.
- Configure a URL de callback e copie o webhook secret
De volta no MakePay, role até Delivery → Callback URL configuration. Clique em Edit Callback URL, cole a sua URL de webhook do Coin Moebius como o destino ativo, e salve. Então, em Webhook signing, copie o webhook signing secret (use Regenerate secret se não houver nenhum valor ainda) — este é o Webhook secret que o Coin Moebius pede.
MakePay → Delivery → Callback URL configuration O MakePay posta atualizações de entrega para este endereço depois de cada mudança de status visível ao comerciante. O webhook signing secret é separado da chave de API — você precisa dos dois.
- Conecte no painel do Coin Moebius
No Coin Moebius, abra Provedores → Adicionar provedor → MakePay. Cole seu API key ID, API key secret, e Webhook secret, depois defina a URL de sucesso e a URL de falha (para onde os compradores chegam depois de pagar ou depois de uma falha). Clique em Salvar.
Coin Moebius → Adicionar provedor → MakePay Os secrets salvos ficam ocultos. Para mudar um depois, escolha Substituir e insira o novo valor.
- Você está conectado
O MakePay agora aparece na sua aba Provedores com a data em que foi conectado e a URL de webhook que ele espera. Se você ainda não fez, cole essa URL nas configurações de callback do MakePay. Use Editar para girar chaves ou Desconectar para remover, e a alternância Modo de teste para percorrer um pedido sem afetar seus números reais.
Coin Moebius → Provedores → MakePay (conectado)
Depois de conectar
Percorra um pedido antes de ir ao ar:
- Ative a alternância Modo de teste no cartão MakePay conectado para percorrer um pedido sem afetar seus números reais.
- Crie um produto e coloque o botão de compra em uma página (um arquivo HTML local serve) apontado para o seu projeto.
- Conclua o checkout através do MakePay.
- Abra a aba Transações. Quando o status da nova linha chegar a succeeded, suas chaves e webhook estão ambos funcionando de ponta a ponta.
Desative o Modo de teste quando você estiver pronto para pagamentos reais.
Solução de problemas
Comece no painel: confirme que o cartão MakePay mostra conectado e que a URL do webhook coincide com o destino de callback salvo no MakePay.
O pagamento se conclui mas o pedido fica pendente.
O webhook não está chegando ou não está verificando. Confirme que a URL de callback no MakePay coincide exatamente com a URL de webhook do seu projeto, e que o Webhook secret no Coin Moebius coincide com o webhook signing secret no MakePay.
Salvar o provedor é rejeitado.
O API key ID, API key secret e Webhook secret são todos obrigatórios. Copie-os de novo do MakePay — o secret é mostrado uma vez, então gere uma chave nova se você não o tiver mais.
Um pedido de teste nunca aparece em Transações.
Ative a alternância Modo de teste no cartão MakePay antes de executar o botão de compra, e certifique-se de que o produto aponta para o mesmo projeto.
Bom saber
Não-custodiado. O MakePay deposita cripto na sua própria carteira. Coin Moebius nunca retém os fundos e não consegue movê-los.
Girando segredos. Gere uma chave de API nova ou regenere o webhook signing secret a qualquer momento, depois escolha Substituir no painel e cole o novo valor. Os campos de secret ficam em branco na edição.
Dúvidas? Join our Discord