Conectando PayTabs ao Mavibot
Para conectar o PayTabs ao Mavibot, você precisa configurar várias opções na sua conta do PayTabs.
1. Criar uma Chave de API
No painel do PayTabs, vá para:
Developers → API Keys
Crie uma nova chave de API.
Após criar a chave de API, salve os seguintes detalhes:
- Server Key — necessária para configurar a integração.
- Profile ID — também necessário para a configuração da conexão.
2. Configurar Notificações de Pagamento
Vá para:
Developers → Configuration
Ative as notificações de pagamento (callbacks).
Clique em "+" e adicione a seguinte URL de callback:
https://chatter.mavibot.ai/paytabs_callback/result
Esta URL é usada para enviar atualizações de status de pagamento para o Mavibot.
3. Configurar PayTabs no Mavibot
Nas configurações do Mavibot:
- Vá para a seção Adquirência
- Selecione PayTabs como provedor de pagamento
- Insira os seguintes detalhes:
- Profile ID
- Server Key
- Selecione a região da sua conta PayTabs
Por favor, observe!
A região selecionada deve corresponder à região onde sua conta PayTabs está registrada.
Assim que as configurações forem salvas, a configuração da integração estará concluída.
Gerando um Link de Pagamento
Para gerar um link de pagamento, use a seguinte função:
get_paytabs_payment_url(amount, description, currency, customer_email, customer_phone, full_name, language)
Parâmetros da Função
| Parâmetro | Descrição |
|---|---|
| ! amount | Valor do pagamento. Parâmetro obrigatório |
| description | Descrição do pagamento. Parâmetro opcional |
| currency | Moeda do pagamento. Parâmetro opcional |
| customer_email | Endereço de e-mail do cliente. Parâmetro opcional |
| customer_phone | Número de telefone do cliente. Parâmetro opcional |
| full_name | Nome completo do cliente. Parâmetro opcional |
| language | Idioma da página de pagamento. Parâmetro opcional |
Moedas Disponíveis
Os seguintes códigos de moeda são suportados:
SAR, AED, BHD, EGP, EUR, GBP, HKD, IDR,INR, IQD, JOD, JPY, KWD, MAD, OMR,PKR, QAR, USD
Idiomas Disponíveis
en — Inglêsar — Árabe
fr — Francês
A função retorna uma URL de pagamento.
Se o parâmetro currency não for fornecido, a moeda será selecionada automaticamente com base na região configurada.
Usando o Link de Pagamento em um Botão
Para enviar um botão de pagamento para um cliente:
- Crie um botão com o tipo Pagamento
- Selecione PayTabs como provedor de pagamento
- Especifique:
- descrição do pagamento;
- valor do pagamento;
- moeda.
Tratamento de Status de Pagamento
Após o cliente abrir o link de pagamento e concluir o pagamento, um evento de callback será enviado para a conversa.
Pagamento Bem-sucedido
Exemplo:
SDJ91MTKTT_success 100
Onde:
- SDJ91MTKTT — os primeiros 10 caracteres da Server Key
- 100 — o valor do pagamento
Para criar uma ação para um pagamento bem-sucedido, vá para Builder e crie um bloco com um gatilho (pode ser um bloco Início ou um bloco Gatilho).
Em seguida, no campo Gatilho, insira:
- o valor completo do callback (se quiser acionar a ação apenas para um valor de pagamento específico), ou
- apenas o valor do callback antes do valor do pagamento (se quiser acionar a ação para todos os pagamentos bem-sucedidos).
Pagamento Falhou
Exemplo:
SDJ91MTKTT_fail 100
O tratamento de pagamento falhou é configurado da mesma forma que o tratamento de pagamento bem-sucedido.
Crie um bloco com um gatilho e insira o valor do callback no campo Gatilho. Isso permite definir ações que serão executadas quando um pagamento falhar.
Variáveis Salvas Após um Pagamento Bem-sucedido
Após um pagamento bem-sucedido, as seguintes variáveis são salvas automaticamente para o cliente:
paytabs_callback_data
Contém o payload completo do webhook recebido do sistema de pagamento.
paytabs_payment_completed
Valor:
True
Indica que o pagamento foi concluído com sucesso.