# Conecte sua conta do iyzico

> Receba por cartão, parcelado, transferência bancária e BKM Express na Turquia com sua própria conta do iyzico. Em Configurações > Pagamentos, clique em Configurar iyzico, cole sua API Key e sua Secret Key, ative e clique em Salvar configurações.

Central de Ajuda / Pagamentos - Atualizado em 19 de novembro de 2026

O iyzico é uma das formas mais usadas de pagar online na Turquia. Quando você conecta sua conta do iyzico, seus clientes podem pagar com cartão, parcelar um pagamento com cartão quando o cartão permite, pagar por transferência bancária ou usar o BKM Express e a carteira do iyzico. Os pagamentos vão direto para sua conta do iyzico, e o Shoprocket cobra 0%.

Seus clientes pagam sem sair da sua loja. Quando clicam em **Pague agora**, o formulário de pagamento do iyzico aparece dentro do seu checkout. Eles pagam ali e depois veem a confirmação do pedido. Os dados do cartão vão direto para o iyzico e nunca passam pelo Shoprocket.

## Antes de começar

Você precisa de uma conta de lojista do iyzico. Suas chaves ficam no painel de lojista do iyzico, em **Settings > Company Settings**. Há dois tipos de chaves:

- as **chaves sandbox**, do painel de testes do iyzico em sandbox-merchant.iyzipay.com, que começam com `sandbox-`, para testar seu checkout sem dinheiro de verdade
- as **chaves live**, de merchant.iyzipay.com, para receber pagamentos reais depois que o iyzico ativar o seu negócio

Cada tipo vem em par: uma **API Key** e uma **Secret Key**. Você precisa das duas, do mesmo painel.

## Conecte o iyzico

1. No seu painel, vá em **Configurações > Pagamentos**.
2. No cartão do iyzico em **Gateways de pagamento**, clique em **Configurar iyzico**.
3. Cole sua **API Key** e sua **Secret Key**.
4. Se a sua conta do iyzico aceita outras moedas além da lira turca, digite-as em **Moedas**, por exemplo `TRY, USD, EUR`. Deixe em branco se você aceita apenas liras.
5. Mude o interruptor do iyzico para **Ativado**.
6. Clique em **Salvar configurações**.

![O cartão do iyzico em Configurações > Pagamentos: Conectado, com uma chave de teste, a moeda que a conta aceita e a URL do webhook com o botão Copiar](https://shoprocket.io/img/help/connect-iyzico/iyzico-card.webp)

Ao salvar, o Shoprocket verifica suas chaves com o iyzico. Se o iyzico as rejeitar, nada é salvo e uma mensagem no topo da tela explica o motivo. Depois o cartão mostra **Conectado**, e o iyzico aparece no seu checkout.

## As moedas que sua conta aceita

Toda conta do iyzico aceita liras turcas. O iyzico também pode ativar dólares americanos, euros, libras, coroas norueguesas e francos suíços na sua conta, se você pedir. O iyzico não informa ao Shoprocket quais delas a sua conta tem, então você as lista em **Moedas**.

O iyzico aparece no checkout apenas para clientes que pagam em uma moeda da sua lista. Se você listar uma moeda e sua loja tiver preços em outra, o cartão avisa, e você ainda pode oferecer o iyzico a clientes que paguem na moeda dele em **Gateway de cartão por moeda**, como explica [Escolher um gateway de pagamento](https://shoprocket.io/pt/ajuda/escolher-um-gateway-de-pagamento.md).

## Adicione sua URL de webhook no iyzico

Quando o iyzico está conectado, o cartão dele mostra uma **Webhook URL**. O iyzico a usa para avisar o Shoprocket sobre pagamentos que terminam depois, como uma transferência bancária que o cliente faz após sair da sua loja.

1. Clique no botão de copiar ao lado da URL do webhook.
2. No painel de lojista do iyzico, vá em **Settings > Merchant Settings > Merchant Notifications**.
3. Cole a URL e salve.

Seus pedidos continuam sendo confirmados sem a URL do webhook, porque o Shoprocket confere cada pagamento diretamente com o iyzico. Adicioná-la faz uma transferência atrasada aparecer mais cedo no pedido.

O iyzico também pode assinar cada mensagem que envia, para que o Shoprocket saiba que ela realmente veio do iyzico. Para ativar isso, envie um e-mail para entegrasyon@iyzico.com e peça as assinaturas de webhook. O Shoprocket confere a assinatura assim que o iyzico começar a enviá-la. Você não precisa mudar nada aqui.

## Teste com chaves sandbox

Cole suas chaves sandbox para testar seu checkout sem movimentar dinheiro de verdade. O cartão passa a mostrar **Chave de teste: nenhum dinheiro de verdade é movimentado**. A documentação para desenvolvedores do iyzico lista os cartões de teste que você pode usar, e o código de qualquer verificação 3D Secure na sandbox é sempre `283126`.

Quando estiver pronto para vender, clique em **Editar as credenciais de iyzico**, cole suas chaves live e clique em **Salvar configurações**.

## Como os clientes pagam

- **Com cartão**: o cliente digita o cartão no formulário do iyzico. Se o cartão permite parcelamento, o formulário o oferece e o cliente escolhe em quantas vezes. Se o banco exigir uma verificação 3D Secure, ela acontece no mesmo formulário.
- **Com transferência bancária**: o formulário do iyzico mostra a conta bancária para pagar, e o iyzico também envia os dados por SMS e e-mail. O pedido fica **Em processamento**, com os itens reservados, até o dinheiro chegar, e então é confirmado. Os clientes têm 3 dias úteis para fazer a transferência. O iyzico ativa a transferência bancária na sua conta quando você pede a eles.
- **Com BKM Express ou uma carteira do iyzico**: o cliente entra na conta dentro do formulário do iyzico e paga.

Se um cliente mudar de ideia, ele pode clicar em **Voltar ao checkout** abaixo do formulário do iyzico. Ele volta ao seu checkout com tudo o que digitou e pode tentar de novo.

Você não precisa fazer nada em nenhum desses casos. O Shoprocket marca o pedido como pago quando o iyzico confirma o pagamento e envia seus e-mails de pedido de sempre.

## Reembolsos

Quando você reembolsa um pedido pago com o iyzico, o dinheiro volta ao cliente automaticamente, total ou parcialmente. Veja [Reembolsar um pedido](https://shoprocket.io/pt/ajuda/reembolsar-um-pedido.md). Um reembolso total no dia do pagamento cancela o pagamento, então ele nunca aparece na fatura do cartão do cliente. Depois desse dia, é um reembolso normal, que o banco do cliente costuma mostrar em poucos dias.

Um reembolso feito no painel de lojista do iyzico não aparece no pedido no Shoprocket. Reembolse pelo Shoprocket para manter o pedido atualizado.

## Assinaturas

O iyzico ainda não consegue renovar assinaturas no Shoprocket. Salvar o cartão de um cliente para renovações exige que o iyzico ative o armazenamento de cartões na sua conta. Um checkout com uma assinatura oferece seus outros gateways no lugar.

## Trocar suas chaves ou desativar

Quando o iyzico está conectado, o botão dele diz **Editar as credenciais de iyzico**. Suas chaves salvas ficam armazenadas criptografadas e nunca são mostradas de novo. O cartão mostra apenas os quatro últimos caracteres da sua API Key. Para mantê-las, deixe os campos em branco. Para substituí-las, cole as duas chaves novas e clique em **Salvar configurações**.

Para deixar de oferecer o iyzico, mude o interruptor dele para **Desativado** e clique em **Salvar configurações**. Suas chaves continuam salvas, então você pode reativá-lo quando quiser.

## Artigos relacionados

- [Escolher um gateway de pagamento](https://shoprocket.io/pt/ajuda/escolher-um-gateway-de-pagamento.md)
- [Reembolsar um pedido](https://shoprocket.io/pt/ajuda/reembolsar-um-pedido.md)
- [Faça um pedido de teste](https://shoprocket.io/pt/ajuda/fazer-um-pedido-de-teste.md)

[Abrir Pagamentos no seu painel](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/pt/ajuda/conectar-iyzico
- Language: Português (pt)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-iyzico.md), [Deutsch](https://shoprocket.io/de/hilfe/iyzico-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-iyzico.md), [English](https://shoprocket.io/help/connect-iyzico.md), [Español](https://shoprocket.io/es/ayuda/conectar-iyzico.md), [Français](https://shoprocket.io/fr/aide/connecter-iyzico.md), [עברית](https://shoprocket.io/he/help/connect-iyzico.md), [हिन्दी](https://shoprocket.io/hi/help/connect-iyzico.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-iyzico.md), [Italiano](https://shoprocket.io/it/aiuto/collega-iyzico.md), [日本語](https://shoprocket.io/ja/help/connect-iyzico.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-iyzico-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-iyzico-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/iyzico-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-iyzico.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-iyzico.md), [Русский](https://shoprocket.io/ru/help/connect-iyzico.md), [ไทย](https://shoprocket.io/th/help/connect-iyzico.md), [Türkçe](https://shoprocket.io/tr/yardim/iyzico-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-iyzico.md)
