# 连接你的 iyzico 账户

> 用你自己的 iyzico 账户在土耳其收取银行卡、分期付款、银行转账和 BKM Express。在 设置 > 支付 中点击 设置 iyzico，粘贴 API Key 和 Secret Key，开启后点击 保存设置。

帮助中心 / 支付 - 更新于 2026年11月19日

iyzico 是土耳其最常用的在线支付方式之一。连接你的 iyzico 账户后，顾客可以用银行卡付款，在银行卡支持时把一笔卡付款拆成分期，用银行转账付款，或者使用 BKM Express 和自己的 iyzico 钱包。款项直接进入你的 iyzico 账户，Shoprocket 收取 0%。

顾客无需离开你的店铺就能付款。他们点击 **立即支付** 后，iyzico 的支付表单会直接出现在你的结账页面中。他们在那里付款，然后看到订单确认。银行卡信息直接发送给 iyzico，不会经过 Shoprocket。

## 开始之前

你需要一个 iyzico 商户账户。你的密钥在 iyzico 商户后台的 **Settings > Company Settings** 下。密钥有两种：

- **沙盒密钥**：来自 iyzico 的测试后台 sandbox-merchant.iyzipay.com，以 `sandbox-` 开头，用于在不动用真钱的情况下试用你的结账流程
- **正式密钥**：来自 merchant.iyzipay.com，在 iyzico 开通你的业务后，用于收取真实款项

每种密钥都是一对：一个 **API Key** 和一个 **Secret Key**。两个都需要，并且来自同一个后台。

## 连接 iyzico

1. 在后台中，前往 **设置 > 支付**。
2. 在 **支付网关** 中 iyzico 的卡片上，点击 **设置 iyzico**。
3. 粘贴你的 **API Key** 和 **Secret Key**。
4. 如果你的 iyzico 账户还接受土耳其里拉以外的币种，请把它们填入 **币种**，例如 `TRY, USD, EUR`。如果只收里拉，就留空。
5. 把 iyzico 的开关切换为 **开启**。
6. 点击 **保存设置**。

![设置 > 支付 中的 iyzico 卡片：已用测试密钥连接，显示账户接受的币种，以及带复制按钮的 Webhook URL](https://shoprocket.io/img/help/connect-iyzico/iyzico-card.webp)

保存时，Shoprocket 会向 iyzico 验证你的密钥。如果 iyzico 拒绝，不会保存任何内容，屏幕顶部会有一条消息说明原因。之后卡片会显示 **已连接**，iyzico 也会出现在你的结账页面中。

## 你的账户接受的币种

每个 iyzico 账户都接受土耳其里拉。如果你向 iyzico 提出申请，它还可以为你的账户开通美元、欧元、英镑、挪威克朗和瑞士法郎。iyzico 不会告诉 Shoprocket 你的账户开通了哪些，所以需要你自己在 **币种** 中列出。

iyzico 只会向使用你列表中币种付款的顾客显示。如果你只列了一种币种，而店铺用另一种币种定价，卡片会提醒你；你仍然可以在 **按币种设置银行卡网关** 中，把 iyzico 提供给使用其币种付款的顾客，详见 [选择支付网关](https://shoprocket.io/zh/help/choose-a-payment-gateway.md)。

## 在 iyzico 中添加你的 webhook 地址

连接 iyzico 后，它的卡片会显示一个 **Webhook URL**。iyzico 用它把稍后才完成的付款告知 Shoprocket，比如顾客离开你的店铺之后才完成的银行转账。

1. 点击 Webhook URL 旁边的复制按钮。
2. 在你的 iyzico 商户后台，前往 **Settings > Merchant Settings > Merchant Notifications**。
3. 粘贴该地址并保存。

即使没有 webhook 地址，你的订单也会被确认，因为 Shoprocket 会自己向 iyzico 核对每一笔付款。添加它能让迟到的银行转账更快显示在对应订单上。

iyzico 还可以对发出的每条消息签名，这样 Shoprocket 就能确认消息确实来自 iyzico。要开启它，请发邮件到 entegrasyon@iyzico.com，申请 webhook 签名。iyzico 一开始发送签名，Shoprocket 就会立即校验。你不需要在这里做任何修改。

## 用沙盒密钥试用

粘贴沙盒密钥，即可在不动用真钱的情况下试用你的结账流程。此时卡片会显示 **测试密钥：不会动用真钱**。iyzico 的开发者文档列出了可用的测试卡，沙盒中任何 3D Secure 验证的验证码始终是 `283126`。

准备好销售时，点击 **编辑 iyzico 凭据**，粘贴正式密钥，然后点击 **保存设置**。

## 顾客如何付款

- **银行卡**：顾客在 iyzico 的表单中输入银行卡。如果卡支持分期，表单会提供分期选项，由顾客选择期数。如果银行需要 3D Secure 验证，也会在同一个表单中完成。
- **银行转账**：iyzico 的表单会显示要转入的银行账户，iyzico 还会通过短信和邮件发送详情。订单在款项到账前保持 **处理中**，商品也会保持预留，到账后才会确认。顾客有 3 个工作日来完成转账。你向 iyzico 申请后，它会为你的账户开通银行转账。
- **BKM Express 或 iyzico 钱包**：顾客在 iyzico 的表单内登录并付款。

如果顾客改变主意，可以点击 iyzico 表单下方的 **返回结账**。他们会带着已填写的全部内容回到你的结账页面，并可以重试。

这些情况你都不需要做任何事。iyzico 确认付款后，Shoprocket 会把订单标记为已支付，并发送你一贯的订单邮件。

## 退款

当你为通过 iyzico 支付的订单退款时，款项会自动退回给顾客，可以全额也可以部分。参见 [为订单退款](https://shoprocket.io/zh/help/refund-an-order.md)。在付款当天进行的全额退款会直接取消这笔付款，所以它不会出现在顾客的银行卡账单上。过了当天，就是一笔普通退款，顾客的银行通常会在几天内显示。

你在 iyzico 商户后台做的退款不会显示在 Shoprocket 的订单上。请从 Shoprocket 退款，这样订单才能保持最新。

## 订阅

iyzico 目前还不能在 Shoprocket 中续订订阅。要为续订保存顾客的银行卡，需要 iyzico 为你的账户开通银行卡存储。包含订阅的结账页面会改为提供你的其他支付网关。

## 更改密钥或关闭

连接 iyzico 后，它的按钮会显示 **编辑 iyzico 凭据**。已保存的密钥会加密存储，且不会再次显示。卡片只显示你的 API Key 的最后四个字符。要保留它们，请让字段留空。要替换，请粘贴两个新密钥并点击 **保存设置**。

要停止提供 iyzico，请把它的开关切换为 **关闭** 并点击 **保存设置**。你的密钥仍然保存着，所以可以随时重新开启。

## 相关文章

- [选择支付网关](https://shoprocket.io/zh/help/choose-a-payment-gateway.md)
- [为订单退款](https://shoprocket.io/zh/help/refund-an-order.md)
- [下测试订单](https://shoprocket.io/zh/help/take-a-test-order.md)

[在后台打开“支付”](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/zh/help/connect-iyzico
- Language: 中文 (zh)
- 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), [Português](https://shoprocket.io/pt/ajuda/conectar-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)
