Garanti BBVA
Para usar o Garanti BBVA (Sanal POS) sistema de pagamento em Mavibot, você precisa obter o terminal virtual POS credenciais do banco e inseri-las nas configurações de integração. O pagamento é processado na página segura do banco com 3D Secure confirmação.
Obtendo as credenciais
Assine um contrato com Garanti BBVA para o Sanal POS (serviço de POS virtual). Ao ativar o serviço, peça ao banco para habilitar Ortak Ödeme (página de pagamento compartilhada) para o seu terminal. Sem esse recurso, os pagamentos via a página de pagamento do banco não funcionarão.
O banco fornecerá:
Merchant ID (Üye İşyeri No) — seu ID do comerciante;
ID do terminal — seu ID do terminal;
ID do usuário de provisionamento — o nome de usuário de provisionamento (geralmente PROVAUT ou PROVOOS);
Senha de provisionamento — a senha do usuário de provisionamento.
A Chave da loja (chave 3D Secure) é criada por você no Sanal POS painel de gerenciamento (Yönetim → 3D Secure). Certifique-se de salvá-la, pois ela também é necessária para a integração.
Como conectar o Garanti BBVA ao Mavibot?
Na Adquirência seção de Mavibot, selecione Garanti BBVA e insira os seguintes detalhes:
ID do comerciante — seu ID do comerciante.
ID do terminal — seu ID do terminal.
ID do usuário de provisionamento — o nome de usuário de provisionamento. Se deixado em branco, PROVAUT será usado.
Senha de provisionamento — a senha do usuário de provisionamento.
Chave da loja — sua chave 3D Secure.
Nome da loja — o nome exibido aos clientes na página de pagamento do banco. Se deixado em branco, "Loja online" será exibido.
Modo de teste — ative esta opção para testar a integração usando as credenciais de teste do banco. Para processar pagamentos reais, esta opção deve estar desativada.
A integração agora está concluída.
Gerando um link de pagamento
Função da calculadora:
get_garanti_payment_url(amount, description, currency, customer_email, language)
Parâmetros:
amount
Valor do pagamento.
✅
—
description
Descrição do pagamento.
Não
—
currency
Moeda do pagamento.
Não
TRY (padrão). Valores suportados: TRY, USD, EUR, GBP, JPY
customer_email
Endereço de e-mail do cliente.
Não
—
language
Idioma da página de pagamento.
Não
tr (padrão). Valores suportados: tr, en
A função retorna uma URL de pagamento.
Link de pagamento em um botão
Para enviar um botão com um link de pagamento, selecione o Pagamento tipo de botão e escolha Garanti BBVA como provedor de pagamento. Em seguida, insira o nome do produto, o valor do pagamento e, se necessário, a moeda do pagamento.
Exemplo 1: Configuração do fluxo de trabalho
Etapa 1. Crie um Start bloco.
O bloco Start é normalmente usado para exibir a primeira mensagem de boas-vindas no fluxo de trabalho, junto com quaisquer informações introdutórias de que o usuário precise.
Etapa 2. Crie o bloco mostrado abaixo.
Etapa 3. Vá para as Conexão configurações.
Você precisará da seguinte expressão regular para verificar se o cliente inseriu um endereço de e-mail válido:
^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$
Além disso, ative a opção Usuário insere dados e insira customer_email.
Etapa 4. Insira a mensagem no segundo bloco.
Etapa 5. Crie um terceiro bloco e abra as Conexão configurações entre os blocos segundo e terceiro.
Ative o temporizador para avançar automaticamente para o próximo bloco.
Etapa 6. No terceiro bloco, insira a função na Calculadora.
Exemplo para copiar:
Se você quiser aceitar pagamentos em uma moeda diferente de lira turca (TRY), especifique a moeda como mostrado abaixo.
Exemplo para copiar:
Exemplo 2. Botão de Cobrança
Este exemplo é quase idêntico ao Exemplo 1.
No entanto, em vez de criar um terceiro bloco com uma função para gerar o link de pagamento, você pode criar um botão no segundo bloco.
Na janela que se abre:
Insira o texto do botão.
Selecione a Cobrança função.
Selecione Garanti BBVA como provedor de pagamento.
Em seguida, insira o seguinte:
Nome do produto.
Valor do pagamento.
Moeda (opcional).
Nome completo do cliente (opcional). Você pode configurar isso da mesma forma que configurou a entrada de e-mail do cliente.
E-mail do cliente — insira a variável
#{customer_email}.
Em seguida, clique em Adicionar.
Notificações após o pagamento
Depois que o cliente seguir o link de pagamento e concluir o pagamento, uma notificação (callback) será enviada à conversa.
Para um pagamento bem-sucedido:
Onde:
SDJ91MTKTTsão os primeiros 10 caracteres do seu Chave da loja.100é o valor do pagamento.
Se o pagamento falhar, a seguinte notificação será enviada:
Como Enviar uma Resposta a um Pagamento Bem-sucedido ou com Falha
Etapa 1. Crie um Gatilho bloco.
Etapa 2. No campo de condição, insira o texto da notificação SDJ91MTKTT_success — sem o valor do pagamento — se você quiser reagir a cada pagamento.
Nesse caso, o Tipo de correspondência deve ser definido como Por palavras-chave.
Como alternativa, insira todo o texto do callback no campo Gatilho se você quiser reagir a um pagamento específico. Nesse caso, o Tipo de correspondência deve ser definido como Correspondência exata.
Se você quiser continuar o fluxo de trabalho após um pagamento bem-sucedido, você pode criar um Start bloco em vez de um Gatilho bloco e continuar construindo o fluxo do seu bot a partir daí.
Variáveis do cliente após um pagamento bem-sucedido
garanti_callback_data
Informações de pagamento recebidas do sistema de pagamento.
garanti_payment_completed
"True" se o pagamento foi processado com sucesso.
garanti_auth_code
O código de autorização da transação do banco.
Atualizado