Bepaid
Como Conectar
Para conectar o bePaid sistema de pagamento, você precisará de um Store ID, chave secreta, e chave pública. Assim que receber essas credenciais, acesse as configurações em Salebot.
Para obter o Store ID, chave secreta, e chave pública, entre em contato com o baPaid suporte técnico para obter ajuda.
No MaviBot, abra a seção "Sistema de pagamento" e selecione bePaid. Em seguida, insira as credenciais que você recebeu.
Observe que o último campo é um seletor que escolhe a hospedagem da API de acordo com o país de uso: Bielorrússia ou Rússia.
Como Gerar um Link de Pagamento
Para gerar um link de pagamento, você precisa definir um valor para a variável payment_sum (por exemplo: 150 ou 100.55 — use um ponto como separador decimal).
Assim que a variável payment_sum for definida, a variável bepaid_pay_url aparecerá automaticamente. Você pode exibir essa variável na tela como um link ou colocá-la em um botão com o texto "Pagar".
O link de pagamento ficará assim: https://checkout.bepaid.by/widget/hpp.html?token=a05eabd3f9368725efbc175614c7d469da08f198cc51916b07fb75e53f9a3e1a
Antes de definir a variável payment_sum , você também pode definir as seguintes variáveis opcionais para personalizar o pagamento.
Por padrão, a moeda é definida como rublo bielorrusso. Se você precisar usar outra moeda, defina um valor para a variável currency .
currency
Moeda do pagamento no formato ISO 4217
Por exemplo: USD
language
Idioma da página de pagamento Padrão: en.
Valores permitidos:
en – Inglês
es – Espanhol
tr – Turco
de – Alemão
it – Italiano
ru – Russo
zh – Chinês
fr – Francês
da – Dinamarquês
sv – Sueco
no – Norueguês
fi – Finlandês
pl – Polonês
ja – Japonês
uk – Ucraniano
be – Bielorrusso
ka – Georgiano
ro – Romeno
payment_description
Descrição do Pagamento
link_expired
Expiração do Link de Pagamento Defina a data de expiração no formato dd.mm.yyyy (por exemplo: 25.06.2025). Por padrão, o pagamento deve ser concluído em até 24 horas.
Você também pode usar o campo "Atribuir Variáveis no Redirecionamento" para definir:
link_expired = current_date + 2— o link será válido por 2 dias até 00:00.Você também pode especificar uma data e hora exatas de expiração no formato dd.mm.yyyy hh:mm (por exemplo: 25.06.2025 12:23). Por padrão, o pagamento deve ser concluído em até 24 horas.
Também é possível usar variáveis padrão. Por exemplo, para definir a validade do link para 30 minutos: time = current_time + 30 link_expired = "#{current_date} #{time}"
russian_host
Indicador para Loja Registrada no Host Russo do bePaid Defina este parâmetro como 1 se sua loja estiver registrada em bepaid.tech.
Se você precisar alternar o host para Belarus, defina este parâmetro como "" (valor vazio).
test_payments
Esta variável é usada para pagamentos de teste. Para realizar um pagamento de teste, adicione-a com qualquer valor.
bepaid_attempts
Especifica o número de tentativas de pagamento. Por padrão, 1 tentativa é permitida.
сustomer_data
Uma matriz contendo o first_name, last_name, e emaildo pagador. Esses dados são necessários para enviar o recibo para o e-mail do pagador e podem ser editados na página de pagamento.
O parâmetro deve ser passado como uma lista de pares chave-valor formatada em JSON. Por exemplo: customer_data = ‘{“first_name”: “Sam”, “last_name”: “Smith”, “email”: “[email protected]” }’
bepaid_contract (condicionalmente obrigatório)
Finalidade do Pagamento por Token
Valores esperados:
“recurring” – para pagamentos recorrentes com frequência definida
“card_on_file” – para pagamentos únicos ou irregulares, por exemplo, pagamento posterior por um serviço
Após a conclusão do pagamento, a variável bepaid_callback_data será adicionada para o cliente. Ela contém a resposta do sistema de pagamento para a transação concluída. Você pode extrair os dados necessários desse dicionário usando o método get .
Como Testar Pagamentos
Para realizar um pagamento de teste, antes de definir a variável payment_sum defina a variável test_payments com qualquer valor. Lembre-se de removê-la ao executar o bot em modo ao vivo!
Cartões de teste:
4200000000000000 — sucesso
4005550000000019 — falha
Se algo não funcionar, compare seus dados com a documentação oficial: https://docs.bepaid.by/ru/test-integration#test-card-number
Exemplo de Geração de um Link de Pagamento
Vamos criar um link de pagamento para 100 rublos bielorrussos (moeda padrão).
Observação: primeiro, defina as variáveis adicionais para a configuração e, em seguida, defina payment_sum. As variáveis também podem ser definidas antes no fluxo, não necessariamente no mesmo bloco — este é apenas um exemplo.
Por fim, exiba a variável bepaid_pay_url no local desejado; ela contém o link de pagamento gerado.
Gerenciamento de Assinaturas
A integração com o sistema de pagamento permite criar assinaturas para seus clientes.
Antes de usar essa funcionalidade no Salebotcrie um plano de assinatura em sua conta bePaid .
Se o “Planos” e “Assinaturas” se os menus não aparecerem em sua conta, entre em contato com seu gerente.
Criando uma Assinatura e Gerando um Link de Pagamento
Use a função get_bepaid_subscription_url , passando o parâmetro plan_id , onde…
plan_id
plan_id é o ID do plano no bePaid sistema.
Como resultado, a função criará uma assinatura e retornará um link de pagamento.
Envie o link ao cliente e aguarde a conclusão do pagamento.
Assim que o pagamento for bem-sucedido, a assinatura será ativada. O negócio receberá as variáveis bepaid_subscription_id e bepaid_subscription_status e um callback será enviado ao bot (veja a seção “Como Tratar o Resultado” ).
Obtendo Informações da Assinatura
Para obter os detalhes atuais da assinatura de um cliente, chame a função get_bepaid_subscription_info e passe o parâmetro subscription_id (o valor pode ser obtido da variável bepaid_subscription_id ).
Cancelando uma Assinatura
Para cancelar uma assinatura, use a função cancel_bepaid_subscription função.
Esta função aceita um único parâmetro: subscription_id (o valor pode ser obtido da variável bepaid_subscription_id ).
Após o cancelamento bem-sucedido, a variável bepaid_subscription_status será definida como “canceled”, e um callback será enviado ao bot (veja a “Como Tratar o Resultado” ).
Status das Assinaturas
trial
Ativa ou cancelada período de teste da assinatura.
active
Assinatura ativa com pagamento realizado no prazo.
failed
Assinatura com falha. bePaid não conseguiu processar o próximo pagamento.
error
Ocorreu um erro durante bePaid tentava processar o pagamento.
canceled
A assinatura foi canceled e não está mais ativa.
Pagamentos Recorrentes
Você também pode configurar um sistema de assinatura sem criar um plano em sua bePaid .
Para isso, você precisará do token do cartão.
do cliente. Para obter o token do cartão, o cliente deve fazer um pagamento inicial usando um link gerado via payment_sum.
Antes de definir a variável payment_sum valor, defina a bepaid_contract variável para especificar a finalidade dos pagamentos futuros por token:
“recurring” – para pagamentos recorrentes com frequência definida
“card_on_file” – para pagamentos únicos ou irregulares, por exemplo, pagamento posterior por um serviço
O “card_on_file” não é compatível com todos os adquirentes. Se quiser usá-la, entre em contato com seu gerente de conta.
Após um pagamento bem-sucedido, a variável bepaid_client_card_token será adicionada ao negócio, armazenando o token do cartão do cliente. Esse token permite cobrar o cartão do cliente sem a participação dele.
Em seguida, configure seu funil e especifique uma data ou condição para a cobrança automática, depois chame a função make_bepaid_token_payment , passando os parâmetros necessários.
Ordem dos parâmetros: amount → currency → description → contract
Descrições dos Parâmetros
amount (obrigatório)
Valor do pagamento – o valor esperado é um número inteiro ou número decimal, por exemplo: 100 ou 100.5.
currency (obrigatório)
Moeda do pagamento no formato ISO 4217 , por exemplo: “USD”.
description (obrigatório)
Descrição da cobrança, por exemplo: “Pagamento semanal de assinatura para participação no clube de hobby”.
contract (obrigatório)
Finalidade do pagamento por token. Valores esperados: “recurring” ou “card_on_file”.
O contract deve corresponder exatamente ao valor especificado ao criar o link de pagamento inicial!
Se o pagamento for bem-sucedido, a função retornará a mensagem “Cobrança bem-sucedida via token bePaid”, você receberá um callback para o pagamento bem-sucedido, e a variável do negócio bepaid_token_payment_completed será definida como “True”.
Se o pagamento falhar, a função retornará uma mensagem indicando o motivo da falha no pagamento, um callback com o sufixo “_fail” será enviado ao bot, e a variável do negócio bepaid_token_payment_completed será definida como “False”.
O banco pode exigir que o cliente conclua o pagamento. Nesse caso, a função retornará um link pedindo ao cliente que passe pela autenticação 3-D Secure.
Como Tratar o Resultado
Em resposta às ações do cliente, o bot receberá callbacks compostos pelos primeiros 20 caracteres da chave secreta e um sufixo, que depende do tipo e do resultado da operação.
No sistema, o callback aparece como uma mensagem do usuário, mas o usuário não a vê.
Para Pagamentos
Para pagamentos não relacionados a assinaturas, você receberá uma das seguintes mensagens:
keyNumber_success – para um pagamento bem-sucedido
keyNumber_fail – para um pagamento com falha
Você também pode acompanhar o status do último pagamento usando as variáveis:
bepaid_payment_completed – para pagamentos envolvendo o cliente
bepaid_token_payment_completed – para pagamentos automáticos com base no token do cartão
Para Assinaturas
Após uma assinatura ser ativada com sucesso, seja no primeiro pagamento ou em um pagamento recorrente, o bot receberá a mensagem keyNumber_success.
Se a assinatura for cancelada, você receberá keyNumber_canceled.
No caso de uma falha no pagamento da assinatura, a mensagem keyNumber_fail será enviada.
Atualizado