Para usar o Clip no MaviBot, você precisa criar um par de credenciais na sua conta Clip e inseri-las nas configurações do sistema de pagamento.

Clip é um serviço de pagamento mexicano.

Obtendo Credenciais

Assine um contrato com o Clip e obtenha acesso ao Painel do Desenvolvedor na sua conta Clip.

Na seção de credenciais, clique em Crear credencial (Criar credenciais), insira um nome e confirme a criação.

Copie as seguintes credenciais:

  • API key
  • Clave secreta (Chave secreta)

Importante! A chave secreta é exibida apenas uma vez, imediatamente após a criação das credenciais. Salve-a em um local seguro. Você não pode visualizá-la novamente na sua conta Clip. Se a perder, precisará criar um novo par de credenciais.

As credenciais são criadas separadamente para ambientes de produção e teste. Você pode criar até 6 aplicações por conta.

Para testes de integração, crie um par de credenciais de teste. Para aceitar pagamentos reais, use credenciais de produção.

Você não precisa configurar uma URL de notificação de pagamento na sua conta Clip. O MaviBot envia automaticamente a URL de notificação quando cada pagamento é criado.

Conectando o Clip

Na guia Adquirência, selecione Clip e insira:

Campo Descrição
API key Identificador da aplicação.
Secret key (Clave secreta) Chave secreta da aplicação.

A conexão está concluída.

Use a seguinte função da Calculadora:

get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)

Parâmetros

Parâmetro Descrição
amount Valor do pagamento. Obrigatório. O valor mínimo é 1 na unidade monetária principal. Especifique o valor como 100.55, não 10055.
description Descrição do pagamento. Opcional. Comprimento máximo: 250 caracteres. O cliente pode vê-la na página de pagamento e no recibo.
currency Código de moeda de três letras (MXN e outras moedas disponíveis para sua conta Clip). Opcional. Padrão: MXN.
customer_email Endereço de e-mail do cliente. Opcional. Inserido automaticamente no formulário de pagamento.
customer_phone Número de telefone do cliente. Opcional. Inserido automaticamente no formulário de pagamento.
full_name Nome do cliente. Opcional. Inserido automaticamente no formulário de pagamento.
product_name Nome do produto. Opcional.
language Idioma da página de pagamento: es para espanhol (padrão) ou en para inglês.

A função retorna uma URL de pagamento.

Para enviar um botão de pagamento ao cliente:

  1. Crie um botão com a função Pagar.
  2. Selecione Clip como sistema de pagamento.
  3. Especifique o nome do produto, valor e moeda.
  4. Se necessário, especifique variáveis contendo o nome, endereço de e-mail e número de telefone do cliente.

Callbacks de Pagamento

Após o cliente seguir o link de pagamento e concluir o pagamento, o MaviBot recebe um callback.

Pagamento Bem-sucedido

Exemplo:

SDJ91MTKTT_success 100.55

Onde:

  • SDJ91MTKTT — os primeiros 10 caracteres da sua API key.
  • 100.55 — o valor do pagamento.

Pagamento Falhou

Se o pagamento não for bem-sucedido, o seguinte callback é enviado:

SDJ91MTKTT_fail 100.55

Importante! Um callback de pagamento falhou é enviado apenas após o link de pagamento ser fechado permanentemente: após 5 tentativas de pagamento sem sucesso ou quando o link expirar.

Enquanto o cliente ainda tiver tentativas de pagamento disponíveis, o link permanece ativo e nenhum callback de pagamento falhou é enviado.

Variáveis do Cliente Após um Pagamento Bem-sucedido

Variável Descrição
clip_callback_data Informações de pagamento recebidas do sistema de pagamento Clip.
clip_payment_completed "True" se o pagamento foi processado com sucesso.
clip_payment_request_id Identificador do link de pagamento no Clip.
clip_receipt_no Número do recibo do Clip.