Coinpayments
Как подключить link How to connect
Как сформировать ссылку на оплату link How to generate a payment link
Как обработать результат link How to process the result
Как проверить статус платежа link How to check the payment status
Como conectar
Para conectar o sistema de pagamento Coinpayments, você precisará de quatro valores: o ID do vendedor, o segredo do IPN (para webhooks), a chave privada da API e a chave pública da API. Você também precisará definir a URL do webhook.
Acesse a conta pessoal do Coinpayments -> Configurações da conta https://www.coinpayments.net/index.php?cmd=acct_settings
Na primeira aba, copie o ID do vendedor. (ID do vendedor)
Em seguida, vá para a aba "Seller Settings" e crie e insira uma chave secreta IPN - segredo IPN ( Isso é usado para verificar se o webhook está vindo de nós). Use uma string segura e complexa, difícil de adivinhar
O link IPN - é a URL para webhooks, adicione o seguinte: https://chatter.salebot.pro/coinpayments_callback/result
Em seguida, vá para a seção API Keys e gere um par de chaves para acessar a API.
Salve todas as configurações, copie os dados e vá para as configurações no Mavibot. Abra a seção "Acquiring", selecione Coinpayments.
Você precisa inserir os dados recebidos.
Para gerar um link de pagamento, você precisa definir o valor das variáveis necessárias:
original_currency
A moeda original da transação.
sending_currency
A moeda que o cliente irá enviar.
Por exemplo, se seus produtos estão precificados em USD, mas você recebe BTC, você deve usar original_currency = USD e sending_currency = BTC. original_currency e sending_currency podem ter o mesmo valor se a conversão de moeda não for necessária.
buyer_email
Endereço de e-mail do cliente.
Para enviar notificações se o pagamento for de um valor menor e precisar ser complementado, ou para reembolsos. Se essa variável não for definida, o e-mail será obtido automaticamente da variável email, se o usuário tiver uma no Mavibot.
Depois disso, você precisa definir o valor da payment_sum variável (por exemplo, 10 ou 0.0055 (separado por ponto!)), e a coinpayments_pay_url variável aparecerá imediatamente depois disso. Essa variável pode ser exibida com um link ou colocada em um botão com o texto "Pagar". O link parece com este: https://www.coinpayments.net/index.php?cmd=checkout&id=CPFK5QZ3FKSNWHI75CO8M4BRVD&key=e7782d2ce24f7d03815606a5c4a882eb
Além disso, antes de definir o valor da variável payment_sum, você pode definir as seguintes variáveis opcionais para configurar o pagamento.
payment_description - o nome do produto estará na página de informações de pagamento e no IPN da transação.
buyer_name - nome do cliente
É assim que a página de pagamento se parece.
Como gerar um link de pagamento
Crie um link de pagamento no valor de 0.0256
Atenção: - Primeiro, especifique o endereço de e-mail - Depois, parâmetros opcionais first_name, payment_description e etc. - Por fim, atribua um valor à payment_sum variável.
Observe que primeiro definimos as variáveis para as configurações, depois payment_sum. As variáveis podem ser definidas antes na cadeia, em vez de em um único bloco; este é um exemplo.
Em seguida, exibimos a coinpayments_pay_url variável no lugar certo, que contém o link
Para fazer um pagamento repetido, você precisa redefinir payment_sum, o link gerado anteriormente, e então atribuir novamente a variável payment_sum para obter um link novo.
Como processar o resultado
Após um pagamento bem-sucedido, callbacks serão enviados ao bot, o que permitirá que você saiba que o pagamento foi concluído com sucesso. Você vê esses callbacks no sistema como mensagens do usuário. Para impedir que o usuário os envie, eles consistem nos primeiros 10 caracteres da chave secreta e no pós-escrito _success, por exemplo: 16831CF4b5_success
Esses callbacks NÃO SÃO VISÍVEIS PARA o usuário, eles são exibidos apenas para o operador.
O tipo de comparação deve ser "Correspondência completa"
Além disso, após o pagamento bem-sucedido, a variável coinpayments_payment_completed é definida como True.
Por exemplo, você pode processar um pagamento bem-sucedido em um bloco condicional e exibir a mensagem correspondente ao usuário:
Após a conclusão do pagamento, a variável coinpayments_payment_callback a variável será adicionada ao cliente, contendo os dados da resposta do sistema de pagamento para a transação concluída. Você pode extrair os dados necessários do dicionário resultante usando o get .
Como verificar o status do pagamento
Para verificar o status do pagamento, use coinpayments_get_payment_status() método no campo Calculator.
Exemplo:
Exemplo de status:
Aguardando fundos do comprador...
Fundos recebidos e confirmação do envio para você em breve…
Concluído
Atualizado