O que você precisa
| Campo | O que faz |
|---|---|
| API key | Permite chamarmos o NOWPayments para criar o pagamento. Secreta. |
| IPN secret | Confirma que uma notificação de pagamento realmente veio do NOWPayments. Secreto. |
| URL de sucesso / URL de cancelamento | Onde o comprador chega depois de pagar ou desistir. |
IPN (Instant Payment Notification) é o nome que o NOWPayments dá ao webhook que ele envia quando o status de um pagamento muda.
Por que pedimos cada campo
API key
Autoriza a criação do pagamento, para que os fundos sejam depositados na sua conta.
IPN secret
Comprova que uma notificação recebida é genuinamente do NOWPayments, para que ninguém possa forjar um evento de "pago". É um valor separado da API key.
URL de sucesso e cancelamento
Configurações simples: onde o comprador chega depois de pagar ou desistir. Não são secretas.
Configurar
- Teste: não há sandbox
O NOWPayments não tem sandbox nem ambiente de teste. Para verificar de ponta a ponta, envie um pequeno pagamento real em uma moeda de baixa taxa e confirme que ele aparece no seu painel. Trate esse primeiro pagamento pequeno como o seu teste. Uma conta NOWPayments é gratuita; você paga apenas as taxas normais de rede e de serviço em pagamentos reais.
- Abra as Configurações de Pagamento no NOWPayments
Entre em account.nowpayments.io e vá até Configurações → Pagamentos. Esta única tela contém as três coisas de que você precisa: Carteiras de pagamento (para onde os fundos vão), Chaves de API e Notificações de pagamento instantâneo. Você visitará cada uma delas.
NOWPayments → Configurações → Pagamentos - Adicione uma carteira de pagamento
O NOWPayments libera a API somente após você ter uma carteira de pagamento cadastrada. Em Carteiras de pagamento, clique em Adicionar nova carteira, escolha uma moeda, cole um endereço de carteira que você controla e clique em Adicionar carteira. Este é o endereço para o qual o seu cripto será liquidado.
NOWPayments → Carteiras de pagamento → Adicionar nova carteira - Crie uma chave de API
Abra Chaves de API e clique em Adicionar nova chave de API. As suas chaves são listadas aqui, cada uma com um ícone de copiar, para que você possa voltar e copiar uma chave novamente a qualquer momento.
NOWPayments → Configurações → Chaves de API - Copie a sua chave de API
O NOWPayments exibe a nova chave em um diálogo "Chave de API criada". Clique no ícone de copiar ao lado de Sua chave de API e guarde-a. (A chave pública abaixo dela não é necessária para o Coin Moebius.) Você pode adicionar um rótulo opcional e clicar em Salvar.
NOWPayments → Chave de API criada Esta é a sua chave de API secreta. Trate-a como uma senha.
- Configure o callback do IPN e copie o segredo do IPN
Abra Notificações de pagamento instantâneo. IPN (Instant Payment Notification) é o nome que o NOWPayments dá ao webhook que ele envia quando o status de um pagamento muda.
- No campo URL do Webhook, cole o endereço de webhook do seu projeto NOWPayments (abaixo) e clique em Salvar.
- Copie a chave secreta do IPN exibida no topo (use Regenerar se não houver nenhum valor ainda).
- Em Escolher formato de webhook, selecione Modo clássico para que os valores e IDs permaneçam no formato numérico normal.
https://api.coinmoebius.com/webhook/nowpayments/<your project id>NOWPayments → Notificações de pagamento instantâneo O ID do seu projeto está abaixo do nome do projeto no painel do Coin Moebius; insira-o no endereço acima. O cartão do provedor conectado (último passo) mostra a mesma URL para que você possa copiá-la novamente a qualquer momento.
- De volta no Coin Moebius: Adicionar provedor → NOWPayments
No seu projeto, abra a aba Provedores, clique em Adicionar provedor, escolha Conectar um serviço e selecione NOWPayments. Cole a sua chave de API e o segredo do IPN, defina a URL de sucesso e a URL de cancelamento (para onde os compradores vão após pagar ou desistir) e clique em Salvar.
Coin Moebius → Adicionar provedor → NOWPayments - Você está conectado
O NOWPayments agora aparece na sua aba Provedores com a data em que foi conectado. O cartão mostra a mesma URL de webhook que você colou no NOWPayments, além de Editar e Desconectar. Como o NOWPayments não tem sandbox, não podemos verificar automaticamente o segredo do IPN; portanto, o cartão oferece um teste com micropagamento: envie um pequeno pagamento real para confirmar que tudo funciona de ponta a ponta.
Coin Moebius → Provedores → NOWPayments (conectado)
Depois de conectar
Não há sandbox, então o seu primeiro pequeno pagamento real é o teste:
- Crie um produto e coloque o botão de compra em uma página (um arquivo HTML local serve) apontado para o seu projeto.
- Pague um valor pequeno em uma moeda de baixa taxa.
- Abra a aba Transações. Quando o status da nova linha chegar a succeeded, a sua API key e o IPN secret estão ambos funcionando de ponta a ponta.
Solução de problemas
O pagamento se conclui mas o pedido fica pendente.
O IPN não está chegando ou não está verificando. Confirme que a callback URL coincide e que o IPN secret no painel coincide com a IPN Secret Key nas suas configurações do NOWPayments.
Não há jeito de testar sem pagar.
Correto, não há sandbox. Envie um pequeno pagamento real em uma moeda de baixa taxa para disparar um IPN genuíno, depois observe o pedido atualizar.
O status só muda com atividade real.
O status do NOWPayments reflete entregas de IPN, então uma conta parada não mostra status até um pagamento real se mover.
Bom saber
Sem modo de teste. Verifique com um pequeno pagamento real, não com um sandbox.
Rotacionando segredos. Gere uma nova API key ou IPN secret quando quiser, depois cole o novo valor.
Dúvidas? Join our Discord