接入指引

欢迎使用 EnjoyPay 极速支付。本文档将帮助您快速集成我们的支付服务。

快速开始

1. 获取商户号

请联系我们的商务支持团队以获取您的商户号 (mchNo) 和应用ID (appId)。

2. 获取交易密钥

为了保证通信安全，您需要获取MD5签名密钥。

• 获取密钥：请联系商务或登录商户后台查看您的 MD5 Key。

3. 发起第一笔测试请求

配置完成后，您可以根据业务需求选择以下两种模式之一发起测试。

模式一：统一订单创建 (API直连)

适用于商户自建收银台，直接调用 API 并在参数中指定支付方式 (wayCode)。 查看文档

curl -X POST https://gateway.sandbox.enjoypayment.com/payment/api/pay/unifiedOrder \
  -H "Content-Type: application/json" \
  -d '{
    "mchNo": "M162...",
    "appId": "60cc...",
    "mchOrderNo": "TEST001",
    "wayCode": "PIX",
    "amount": 100,
    "currency": "BRL",
    "subject": "Test Order",
    "body": "Test Description",
    "reqTime": 1622016572190,
    "version": "1.0",
    "signType": "MD5",
    "sign": "YOUR_SIGNATURE_HERE"
  }'

模式二：收银台订单创建 (托管收银台)

适用于跳转到 EnjoyPay 托管收银台完成支付，无需指定具体支付方式。 查看文档

curl -X POST https://gateway.sandbox.enjoypayment.com/payment/api/pay/checkoutOrder \
  -H "Content-Type: application/json" \
  -d '{
    "mchNo": "M162...",
    "appId": "60cc...",
    "mchOrderNo": "TEST002",
    "amount": 100,
    "currency": "USD",
    "country": "US",
    "subject": "Checkout Order",
    "body": "Checkout Description",
    "reqTime": 1622016572190,
    "version": "1.0",
    "signType": "MD5",
    "sign": "YOUR_SIGNATURE_HERE"
  }'

---

鉴权说明

EnjoyPay API 使用 MD5 签名方式进行安全认证。

MD5 签名

基于 MD5 对称加密算法。

• 规则：参数排序拼接 + 密钥 (key) 进行 MD5 运算。
• 详情：MD5签名规则

---

服务器信息

所有的 API 请求都应发送到以下服务器地址：

环境	接口API地址	标记	说明
正式环境	https://gateway.enjoypayment.com/payment	生产运营	真实交易环境
测试环境	https://gateway.sandbox.enjoypayment.com/payment	沙箱调试	用于开发调试

正式环境流量出口

安全提示

* 白名单配置：针对正式环境，建议您将以下 IP 添加到防火墙白名单中，以确保能正确接收平台的异步通知。

序号	通知出口 IP
1	47.89.254.99
2	47.251.5.85
3	198.11.177.112