Para usar o gateway de pagamento iyzico no Mavibot, você precisa obter suas credenciais de API da sua conta de comerciante iyzico e inseri-las nas configurações de integração.

Obtendo Credenciais da API

  1. Faça login no seu Painel de Comerciante iyzico.
  2. Vá para Configurações → Chaves de API (Chaves de API do Comerciante).
  3. Copie as seguintes credenciais:
    • Chave de API
    • Chave Secreta

Essas credenciais são necessárias para conectar o iyzico ao Mavibot.

Para testes, o iyzico fornece credenciais separadas com o prefixo sandbox-. Se você inserir essas credenciais, todos os pagamentos serão processados automaticamente no modo Sandbox (teste) — nenhuma configuração adicional é necessária. Para aceitar pagamentos reais, use suas credenciais de produção (sem o prefixo sandbox-).

Conectando o iyzico

Na guia Adquirência, selecione iyzico.

Em seguida, insira:

  • Chave de API — sua chave de API.
  • Chave Secreta — sua chave secreta.

A integração está concluída.

Função da calculadora:

get_iyzico_payment_url(amount, description, currency, customer_email, customer_phone, full_name, identity_number, city, country, address, product_name, language)

Parâmetros

A função retorna uma URL de pagamento.

Para enviar um botão com um link de pagamento, selecione o tipo Botão de Pagamento e escolha iyzico como gateway de pagamento. Em seguida, insira o nome do produto, o valor do pagamento e, se necessário, a moeda do pagamento.

Callbacks de Pagamento

Após o cliente abrir o link de pagamento e concluir o pagamento, o seguinte callback é enviado para a conversa em caso de pagamento bem-sucedido:

SDJ91MTKTT_success 100

Onde:

  • SDJ91MTKTT são os primeiros 10 caracteres da sua Chave Secreta.
  • 100 é o valor do pagamento.

Se o pagamento falhar, o seguinte callback é enviado:

SDJ91MTKTT_fail 100

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

Variável Valor
iyzico_callback_data Informações de pagamento recebidas do iyzico
iyzico_payment_completed "True" se o pagamento foi processado com sucesso
iyzico_payment_id ID do pagamento iyzico