Iyzico

Para usar o iyzico gateway de pagamento 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 de API

1. Entre no seu Painel do Comerciante iyzico.

2. Acesse 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, a 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- prefixo).

Conectando o iyzico

Na aba 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.

Gerando um link de pagamento

Função calculadora:

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

Parâmetros

Parâmetro	Descrição	Obrigatório	Padrão / Valores permitidos
amount	Valor do pagamento.	✅	—
description	Descrição do pagamento.	Não	—
currency	Moeda do pagamento.	Não	Padrão: TRY Suportadas: TRY, USD, EUR, GBP, CHF, NOK
customer_email	Endereço de e-mail do cliente.	Não	—
customer_phone	Número de telefone do cliente em formato internacional (por exemplo, +905XXXXXXXXX).	Não	—
full_name	Nome completo do cliente.	Não	—
identity_number	Número de identificação do cliente (para clientes na Turquia, este é o TCKN).	Não	—
city	Cidade do cliente.	Não	—
country	País do cliente.	Não	—
address	Endereço do cliente.	Não	—
product_name	Nome do produto exibido na página de pagamento. Se for omitido, description é usado.	Não	Usa description
language	Idioma da página de pagamento.	Não	Padrão: en Suportadas: en, tr

A função retorna uma URL de pagamento.

exemplo

Botão de link de pagamento

Para enviar um botão com um link de pagamento, selecione o Botão de Pagamento tipo 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

Depois que 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 do seu 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 da iyzico
iyzico_payment_completed	"Verdadeiro" se o pagamento foi processado com sucesso
iyzico_payment_id	ID do pagamento da iyzico