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

PayMongo 让菲律宾的客户可以使用您自己的 PayMongo 账户，在 PayMongo 的安全结账页面上通过银行卡、GCash、Maya、GrabPay 或 QR Ph 付款。它只以菲律宾比索 (PHP) 收款，因此只有当您的价格使用 PHP 时，它才会在结账页面显示。

## 步骤

1. 在您的 PayMongo 后台 (dashboard.paymongo.com)，打开 **Developers > API Keys**，复制 **私钥**。测试密钥以 `sk_test_` 开头，正式密钥以 `sk_live_` 开头。
2. 在 Dropify 中，前往 **应用**，找到 **PayMongo**，然后点击 **安装并连接**。
3. 在应用页面点击 **连接 PayMongo**，输入 **账户名称**，填写 **私钥 (Secret Key)** 和 **Webhook 密钥 (Webhook Secret)**，然后点击 **添加账户**。保存前，Dropify 会向 PayMongo 验证这些密钥。
4. 推荐：在 **Webhook URL** 下方点击 **复制 Webhook URL**，并将其添加到 PayMongo 中（**Developers > Webhooks**，事件为 checkout_session.payment.paid），再将其密钥粘贴到 **Webhook 密钥 (Webhook Secret)** 中。这样即使客户关闭页面，付款也能得到确认。
5. 在 **设置** 部分，选择 **沙盒模式** 进行测试，或选择 **生产模式** 接收真实付款，并使用对应的密钥。
6. 前往 **支付 > 支付方式** 并开启 PayMongo。您还可以为它设置 **在线预付款折扣**。
7. 以 PHP 下一笔测试订单，并在 PayMongo 测试页面上付款。

## 常见问题

- “PayMongo 在测试模式下拒绝了这些密钥…” → 密钥属于另一种模式，或复制时带有空格。请重新复制密钥，或在 **设置** 中切换模式。
- PayMongo 未在结账页面显示 → 您的价格（或访客的货币）不是 PHP，或者 PayMongo 在 **支付 > 支付方式** 中处于关闭状态。
- 客户看到“您已取消付款。您可以重试或选择其他支付方式。” → 客户未付款就离开了 PayMongo 页面。
- 稍后才付款的订单一直显示未付款 → Webhook 缺失或其密钥不匹配。请将 Webhook URL 粘贴到 PayMongo 中，并重新复制密钥。

## 相关文章

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