# 如何将 Culqi 连接到我的店铺？

Culqi 让秘鲁的客户可以使用您自己的 Culqi 账户，在 Culqi 的结账页面上通过银行卡、Yape 或 PagoEfectivo 付款。它以索尔 (PEN) 或美元 (USD) 收款，因此只有当您的价格使用其中一种货币时，它才会在结账页面显示。

## 步骤

1. 在 **CulqiPanel > Development > API keys** 中，复制 **公钥** 和 **私钥**。测试密钥以 `pk_test_` 和 `sk_test_` 开头。
2. 在 Dropify 中，前往 **应用**，找到 **Culqi**，然后点击 **安装并连接**。
3. 在应用页面点击 **连接 Culqi**，输入 **账户名称**，填写 **公钥 (Public Key)** 和 **私钥 (Secret Key)**，然后点击 **添加账户**。保存前，Dropify 会向 Culqi 验证这些密钥。
4. 推荐：在 **Webhook URL** 下方点击 **复制 Webhook URL**，并将其添加到 Culqi 中（**CulqiPanel > Events > Webhooks**，事件为 order.status.changed 和 charge.creation.succeeded）。PagoEfectivo 付款通过它确认。
5. 在 **设置** 部分，选择 **沙盒模式** 进行测试，或选择 **生产模式** 接收真实付款，并使用对应的密钥。
6. 前往 **支付 > 支付方式** 并开启 Culqi。您还可以为它设置 **在线预付款折扣**。
7. 以 PEN 或 USD 下一笔测试订单，并在 Culqi 测试页面上付款。

## 常见问题

- “Culqi 在测试模式下拒绝了这些密钥…” → 密钥属于另一种模式，或复制时带有空格。请重新复制密钥，或在 **设置** 中切换模式。
- Culqi 未在结账页面显示 → 您的价格（或访客的货币）不是 PEN 或 USD，或者 Culqi 在 **支付 > 支付方式** 中处于关闭状态。
- 客户看到“您已取消付款。您可以重试或选择其他支付方式。” → 付款在 Culqi 页面上被取消。如果客户只是离开了页面，订单会保持待处理状态。
- 稍后才付款的订单一直显示未付款 → Culqi 中缺少 Webhook。请添加应用页面上显示的 Webhook URL（第 4 步）。

## 相关文章

- [如何将 Openpay 连接到我的店铺？](https://help.dropify.shop/zh/payments_gateways/openpay/)
- [如何将 PayU 连接到我的店铺？](https://help.dropify.shop/zh/payments_gateways/payu-latam/)
- available payment gateways by country
