#Pagamentos em cripto (beta)

Na página de pagamento, o seu cliente pode pagar uma cobrança em reais com criptomoeda. O valor cai na carteira sua, numa conta NOWPayments que também é sua. A marx cria a cobrança, acompanha o status e avisa o seu sistema. A marx não recebe essas moedas e não consegue devolvê-las.

#Antes de começar

• Uma conta NOWPayments no nome da sua empresa, em nowpayments.io.
• Uma carteira que você controla, de uma destas moedas: USDC na Solana (USDCSOL), USDT na Tron (USDTTRC20) ou bitcoin (BTC).
• Saldo em reais na marx. A taxa de cada pagamento sai desse saldo. Sem saldo suficiente para a taxa, a opção de cripto não aparece na página.
• A liberação vale para empresas que já recebem Pix pela marx. O time marx confirma se a sua pode usar.

A taxa da NOWPayments (conversão e rede) sai do próprio pagamento em cripto, na conta deles. A taxa da marx é outra: um percentual só desta função, combinado na liberação, debitado em reais. Ela não é a taxa do Pix.

#1. Crie a conta

1. Cadastre-se em nowpayments.io.
2. Conclua a verificação que eles pedirem.
3. Entre em Settings → Payments.

Não ative custódia. O restante desta página deixa os pagamentos caírem na sua carteira.

#2. Cadastre uma única carteira de recebimento

Em Payout wallets, adicione uma carteira:

Esse é o único destino. O pagador pode pagar com outra moeda da lista; a NOWPayments converte e envia para esta carteira.

Não adicione uma segunda carteira. Com mais de uma, um pagamento pode cair em outra moeda e a marx não marca a cobrança como paga.

Guarde o endereço. Ele entra na lista do que você envia ao time marx.

#3. Ajuste estas opções

Os nomes abaixo são os da tela da NOWPayments, em inglês. Salve cada bloco que tiver botão Save.

Disable custody faz o pagamento ir para a carteira cadastrada. Com a custódia ligada, o valor fica no saldo da NOWPayments até alguém sacar com a senha e o 2FA da conta. A marx não tem esses dados e não faz esse saque.

Do not optimize manda o valor para a carteira da moeda que foi paga ou, se essa carteira não existir, para a primeira da lista. Com uma carteira só, tudo cai nela.

Payment markup aumentaria o valor cobrado do pagador e deixaria a diferença na sua carteira. A taxa da marx não usa esse campo. Deixe em zero.

Payment covering e Finished fazem um depósito menor que o combinado contar como pago. A marx só marca a cobrança como paga quando o valor recebido cobre o valor cotado. Um depósito curto não libera o pedido. Deixe a cobertura em zero e o status padrão em Partially Paid.

Do not process wrong-asset deposits evita que um envio da moeda errada seja convertido sozinho, num câmbio diferente do que a página mostrou.

Pode ignorar:

• Base fiat currency. Pode ficar em USD. A marx envia o valor de cada cobrança em reais.
• Preferred currencies (invoices e donations). Não mudam a página de pagamento da marx.
• Withdrawal fee paid by. Com a custódia desligada, o saque manual não faz parte do pagamento.

#4. Gere a chave e o segredo

Ainda em Settings → Payments:

1. Em API keys, gere uma chave de API. É a chave de criar pagamentos, não a senha da conta.
2. Em Instant payment notifications, gere o IPN secret.

Não aponte a URL de notificação da NOWPayments para o seu servidor. A marx envia a URL dela em cada pagamento. O segredo serve para a marx confirmar que o aviso veio da NOWPayments.

Não envie senha, e-mail de login, seed de 2FA nem acesso ao painel da NOWPayments.

#5. Cole no painel da marx

No painel, em Integração → Cripto (beta):

1. escolha a moeda de recebimento (a mesma da única carteira);
2. marque as moedas do pagador (USDC na Solana, USDT na Tron e/ou bitcoin);
3. cole a API key e o IPN secret;
4. digite a senha do painel e salve.

Depois de salvar, só os últimos quatro caracteres de cada segredo aparecem. A taxa da marx (percentual separado do Pix) é definida na liberação pelo time marx.

Avise o time marx que as chaves estão no painel e informe o endereço da carteira (para conferência). Eles ligam a função e a taxa. Sem isso, a opção continua oculta na página de pagamento.

#Quando a função estiver liberada

1. O cliente abre o link de pagamento, vê o valor em reais e escolhe Pix ou uma das moedas que você habilitou.
2. A página mostra o valor em cripto, a rede, o endereço e um prazo de cerca de 10 minutos para a cotação.
3. Ele envia pelo menos o valor cotado, na rede indicada. A taxa de rede da carteira dele não entra nesse valor: se a corretora descontar a taxa do montante, o depósito fica curto e a cobrança não é paga.
4. A marx marca a cobrança como paga quando a NOWPayments conclui, o valor cobre a cotação e a moeda que caiu na sua carteira é a que você declarou.
5. Um depósito que chega depois dos 10 minutos ainda pode concluir, no câmbio da hora. Se a moeda e o valor estiverem certos, a cobrança é paga do mesmo jeito.
6. O aviso ao seu sistema é o evento event_type_crypto_payment (webhook v2). Ele não traz amount_to_pay, não traz pix_txid e não aumenta o saldo usado nos repasses. Veja Webhooks.

Pix, devolução de Pix e repasse continuam iguais.

#Se você mudar a conta depois

Avise o time marx antes de trocar a carteira ou a moeda de recebimento. Ligar a custódia, adicionar outra carteira, ativar Optimize, Finished, markup ou covering faz a cobrança deixar de ser reconhecida, ou o valor cair num lugar que a marx não vai tratar como pago.