Shopify对接菲律宾支付网关教程
一、菲律宾主流支付方式概述
在菲律宾，除了信用卡(Visa/Mastercard)外，以下本地支付方式非常流行：
- GCash (移动钱包)
- GrabPay
- PayMaya (数字钱包)
- Dragonpay (支持银行转账/OTC现金支付)
- 7-Eleven CLiQQ
- Bayad Center线下网点
- UnionBank在线银行转账
二、Shopify对接步骤
1. 选择适合的支付网关提供商
推荐选项：
- PayMongo – 支持GCash, GrabPay, PayMaya等
- Dragonpay – Shopify有官方插件
- Xendit – 综合型东南亚支付平台
- 2Checkout(Verifone) – 国际方案含本地化选项
2. Shopify后台设置流程(以Dragonpay为例)
-
登录Shopify后台
-
进入"Settings" > "Payment providers"
-
在Alternative payments部分选择"Dragonpay"
- (如未显示可点击"+ See all other providers")
-
填写商户信息
商户ID: [从Dragonpay获取]
密钥: [从Dragonpay获取]
-
配置支持的付款方式
√ GCash
√ PayMaya
√ OTC现金付款
根据需求勾选其他选项 -
保存设置并测试
3.GCash/PayMaya专用集成方法(通过第三方)
如果希望单独集成GCash或PayMaya：
1.使用Paymongo方案:
a)注册Paymongo账户(paymongo.com)
b)安装Shopify插件:"Paymongo Payments"
c)连接API密钥
d)启用GCash/PayMaya渠道
2.使用Xendit方案:
a)申请Xendit商户账户(xendit.co)
b)通过Shopify API自定义集成
c)需开发人员协助完成
三、重要注意事项⚠️
1.合规要求:确保您的业务符合BSP(菲律宾央行规定)，可能需要:
√ SEC公司注册文件
√ BSP支付的许可证
2.结算周期:通常T+3至T+7工作日到账
3.手续费参考:
• GCash: ~3% + ₱15/笔
• Dragonpay: ~4% + ₱20/笔
• OTC现金付款:固定₱50/笔
4.货币设置:建议同时支持PHP和USD显示
5.移动优化:80%菲用户通过手机购物，确保结账页面适配移动端
如需更详细的某个具体网关的设置指南，可以告诉我您选择的提供商名称。
# Shopify对接菲律宾支付网关进阶指南
四、深度集成方案与优化建议
1. Dragonpay高级配置技巧
– 渠道定制化：在Dragonpay商户后台可设置：
– 默认显示渠道（优先展示GCash/PayMaya）
– OTC付款有效期（建议设为48小时）
– 回调URL设置：
“`plaintext
成功回调: https://yourstore.com/checkout/thank_you?session_id={transaction_id}
失败回调: https://yourstore.com/cart?payment_error=true
“`
– 沙盒测试流程：
1. 使用测试商户ID：TESTDRAGONPAY
2. 选择”TEST-BDO”/”TEST-GCASH”等虚拟渠道
3. Dragonpay提供专用测试卡号/凭证
2. PayMongo全渠道集成方案
(适用于同时需要GCash+GrabPay+信用卡)
1. API密钥获取路径：
“`markdown
开发模式 → Settings → API Keys → Create Key
“`
2. Shopify Liquid模板修改示例（结账按钮处）:
“`liquid
{% if checkout.accepted_payment_methods contains ‘GCash’ %}
{% endif %}
“`
3.Webhook配置清单(必需事件):
“`
payment_intent.succeeded
charge.refunded
payment_method.attached
“`
3.Xendit企业级解决方案(适合高交易量店铺)
A.Bank Transfer流程优化:
“`mermaid
sequenceDiagram
Shopify->>Xendit:创建虚拟账户(每个客户唯一)
Xendit–>>Customer:返回BDO/UnionBank账号
Customer->>Bank:完成转账
Xendit->>Shopify:自动核对入账(通过Reference ID)
“`
B.Retail Payment网络扩展:
支持超过15,000个线下网点包括：
√ SM Bills Payment
√ Ministop
√ Cebuana Lhuillier
五、常见问题排障手册
|问题现象|可能原因|解决方案|
|—|—|—|
|GC支付失败但余额充足|Shopify货币设置为USD|后台→Settings→General→PHP本位币|
|Dragonpay订单状态不同步|cronjob未运行|安装`Order Status Updater`插件|
|PayMaya提示”Merchant not found” |未激活移动支付权限 |联系提供商提交SIRF表格 |
|||
六、性能监控与数据分析建议
1.关键指标看板应包含:
✓ GCash转化率 vs OTC转化率
✓各支付方式平均处理时长
✓马尼拉vs外省支付偏好差异
2.推荐工具组合:
• Google Analytics增强电商跟踪 +
• Tableau菲律宾区域模板 +
• Shopify的Finances报表
如需具体某个环节的操作截图或合规文件样本，请告知您需要的具体内容。对于技术集成的代码层面需求，建议由开发人员根据官方API文档操作：
[Dragonpay API Doc](https://www.dragonpay.ph/api/)
[PayMongo开发者门户](https://developers.paymongo.com/docs)
Shopify菲律宾支付网关终极指南：高级配置与本地化策略
七、支付体验深度优化方案
1. 多语言结账界面配置（针对菲律宾市场）
-
推荐语言组合：
- 英语（默认）
- Filipino/Tagalog（关键步骤翻译）
-
实现方法：
{% if checkout.attributes['language'] == 'fil' %}
{{ "Bayad na" | translate }}
{% else %}
{{ "Pay now" | translate }}
{% endif %}
2. GCash快捷支付按钮开发
使用PayMongo JS SDK实现一键支付：
const paymongo = require('paymongo-js')('pk_test_yourkey');
document.getElementById('gcash-btn').addEventListener('click', () => {
paymongo.paymentIntents.create({
amount: {{ checkout.total_price }},
payment_method_allowed: ['gcash'],
description: 'Order #{{ order_number }}'
}).then(res => window.location = res.next_action.url);
});
八、合规与风险管理
BSP (Bangko Sentral ng Pilipinas)核心要求清单
-
商户注册文件：
- SEC/DTI注册证书副本
- BSP签发的EMI许可证（电子货币发行方）
-
交易监控义务：
• ≥₱50,000交易需提交AMLC报告
•保留完整交易记录至少5年
•每月向BSP提交外汇流入报告(如接受美元付款)
-
消费者保护措施：
必须明确展示：
√最终费用明细
√退款政策(法定7天冷静期)
九、本土化运营实战技巧
A.Social Commerce集成方案
1.GCash+Facebook Shop联动:
graph LR;
FB广告-->GCash二维码;
GCash扫码-->Shopify预填订单;
完成支付-->FB像素确认转化;
2.Sari-sari店代理收款网络建设
- Dragonpay合作代理商列表获取路径：
商户后台→Network→Retail Partners
-佣金结构示例：每笔OTC现金存款收取₱15服务费
十、进阶技术架构建议
Webhook安全加固方案
# Flask验证示例(Xendit签名验证)
@app.route('/webhook', methods=['POST'])
def handle_webhook():
received_sig = request.headers.get('X-Callback-Signature')
expected_sig = hmac.new(
os.environ['WEBHOOK_SECRET'].encode(),
request.data,
hashlib.sha256).hexdigest()
if not hmac.compare_digest(received_sig, expected_sig):
abort(403)
CDN加速优化列表（菲律宾境内）:
| 供应商 | 马尼拉POP节点 | 宿务节点 |
|---|---|---|
| Cloudflare | ✅ Globe线路优化 | ✅ PLDT专用通道 |
| Akamai | ✅双重路由备份❌无达沃覆盖 |
十一、新兴支付渠道前瞻部署
1.加密货币合规接入路径
-通过第三方处理器如Coins.ph实现:
Shopify → Coins API → PHP/BTC转换 → BSP定期报备
费率结构:0%手续费 +矿工费浮动
2.BNPL先享后付选项
可集成合作伙伴:
√ Billease (最受欢迎本地方案)
√ Atome (支持SM百货线下扫码)
如需具体某个方案的详细实施流程图或法律文件模板，请说明您需要的具体方向。对于需要开发资源的项目，建议优先考虑以下技术栈：
前端推荐组合: React + TailwindCSS + Shopify Polaris
后端推荐架构: Node.js微服务 + MongoDB Atlas (新加坡区域)
