针对大量菲律宾本地支付开发者在对接 GCash 时遇到“测试难”“上线易误”“参数混乱”等问题，币付Pay建立了严格区分的开发环境（Dev）与生产环境（Prod）接口体系。本文将系统讲解如何基于币付提供的开发环境完成完整测试流程，并一键迁移至正式环境，避免踩坑，提升上线成功率。

一、开发环境（沙盒）API入口

注意：开发环境默认签名密钥为测试专用key，不可用于正式收款。

二、切换至生产环境配置说明

待开发测试完成后，正式环境接口地址变更如下：

• 正式创建订单接口：https://api.bifu.us/v2/order/create
• 正式订单查询接口：https://api.bifu.us/v2/order/query
• 签名密钥：使用平台分配的 生产商户密钥

推荐采用 .env 配置区分环境：

 # .env.development API_URL=https://dev-api.bifu.us API_KEY=测试商户KEY # .env.production API_URL=https://api.bifu.us API_KEY=正式商户KEY 

三、推荐调试流程

1. 使用 Postman / Insomnia 工具验证接口通畅性
2. 对照文档手动拼接签名并比对系统返回签名
3. 配置 ngrok / frp 将本地调试地址映射为公网回调地址
4. 监听 /v2/notify 回调数据，记录日志
5. 模拟支付完成后，从回调获取支付状态并完成业务逻辑测试

开发阶段建议每一个接口均打印请求内容、响应数据与签名字符串，方便排查。

四、数据示例（完整一套调试数据）

 POST /v2/order/create { "merchant_no": "demo001", "order_no": "T202507030001", "amount": 100.00, "notify_url": "https://yourdomain.com/notify", "sign": "A1B2C3D4..." } 

返回内容：

 { "code": 0, "msg": "success", "data": { "pay_url": "https://dev-gcash.bifu.us/pay/abc123" } } 

五、错误码说明

六、测试后切换流程建议

币付建议使用以下切换步骤：

1. 在测试环境完成 下单 → 模拟支付 → 接收回调 全流程
2. 将正式接口URL及商户key切入项目配置
3. 先部署正式环境但订单量限制1笔，观察状态
4. 观察回调时效、订单状态是否一致
5. 正式开通大批量交易权限

七、联系方式与资料获取

• 客服邮箱：[email protected]
• 通知频道：https://t.me/GcashNativePay
• 申请测试商户号 / 生产环境权限：请联系 @Bifuapp

开发与生产环境的明确分层，是稳定GCash收单系统的前提，币付让你一步到位实现全流程标准化。