USEEPAY V1.0
中文
  • 中文
  • English
UseePay官网
产品文档
  • V2.0版本
  • V1.0版本
收单商户平台
UseePay官网
产品文档
  • V2.0版本
  • V1.0版本
收单商户平台
中文
  • 中文
  • English
  1. 集成之前
  • 全球收单
    • 产品说明
    • 集成模式
      • 跳转式收银台模式
      • 内嵌式收银台模式
      • Direct API模式
      • 插件模式
    • 集成之前
      • 开始之前(必读)📘
      • 在SandBox中集成接口
      • 在Prod中上线服务
      • 请求签名指南
        • 加签/验签Demo
        • 加签/验签机制
    • 开始集成
      • UseePay规范
        • 业务结果码(ResultCode)
        • 错误码(ErrorCode)
        • 货币单位和金额规范
        • 国家信息规范
      • 接口集成📗
        • 对象模型
        • 跳转式收银台接口
          • cashier 接口说明
          • paymentMethod参数说明
          • googlepay
            • GoogePay须知
            • googlepay
          • applepay
            • 判断当前设备是否支持applepay
            • applepay
          • wechat_native
            • 关于微信退款
            • wechat_native - 微信扫码支付
          • wechat_h5
            • 关于微信退款
            • wechat_h5 - H5支付
          • cashier 📌
          • credit_card
          • bancontact
          • boleto
          • giropay
          • Ideal
          • klarna
          • konbini
          • oxxo
          • payeasy
          • pix
          • sofort
        • 内嵌式收银台接口
          • 信用卡
            • 2.x 版本内嵌收银台
            • 内嵌订阅收银台
            • 版本更新说明
            • 1.x版本内嵌收银台
          • applepay & googlepay
            • 内嵌方式对接2.0.0
          • create token
        • Direct API接口
          • googlepay
            • GoogePay须知
            • googlepay
          • applepay
            • 判断当前设备是否支持applepay
            • ApplePay API接入流程
            • ApplePay API接入流程备份
            • ApplePay Merchant Identifier
            • applepay
            • ApplePay商户Session
          • wechat_native
            • 关于微信退款
            • wechat_native - 扫码支付
          • wechat_jsapi
            • 关于微信退款
            • 小程序支付
            • 微信公众号支付
            • wechat_jsapi - 微信原生支付
          • konbini
          • payeasy
          • klarna
          • alipay
          • alipay_cn/alipay_hk
          • giropay
          • sofort
          • Ideal
          • boleto
        • 订单相关接口
          • 订单通用接口
            • 订单查询Query
            • 订单退款Refund
            • 订单预授权完成(Capture)
            • 订单预授权撤销(Void)
          • 拒付接口
            • 拒付流程说明
            • 拒付查询
          • 通知接口
            • 交易通知
              • 同步/异步通知
              • webhook版本升级一览
              • webhook
            • 拒付通知
              • 拒付webhook
          • 物流接口
            • 物流信息上传 2.1版
            • 物流信息查询 2.1版
          • 订单数据拉取 - SFTP
            • SFTP
      • 测试资源-SandBox
        • UseePay测试卡💳
        • 信用卡测试案例
        • 本地化测试案例
        • ApplePay&& Google Pay测试用例
        • 退款测试案例
      • 插件集成
        • Shopify(直连内嵌收银台)
        • Shopify(跳转收银台 & Google pay & Apple pay)
        • Shopify(本地化 & Google pay & Apple pay)
        • Shoplazza店匠
        • Shopline
        • Shopline(Google pay & Apple pay)
        • AllValue有赞
        • Shopexpress微盟
        • Shopyy
        • Xshoppy
        • 2cshop
        • Meshop
        • UEESHOP
        • FPP
        • Shopbase(暂停使用)
        • Shoptop
        • Shopastro
        • Magento
        • Woocommerce/WordPress
        • OpenCart
        • PapPal支付绑定
        • Alipay支付绑定
        • 万全云
        • Fecify
        • magento - Wechat/Alipay/UseePay Payments
        • shopify其他
          • Afterpay分期付款组件展示
          • Googlepay&Applepay名称修改
          • 如何增加卡组织logo
          • UseePay商户订单号匹配Shopify店铺订单
    • MC收单平台操作手册
      • 商户号查找
      • Appld查找
      • 域名添加
      • 域名证明下载
      • Shopify-SecurityKey查找
      • 密钥查找
      • 交易订单查找
      • 订单失败原因查看
      • 退款查询
      • 退款处理
      • ARN查询方式
      • 银行账号添加
      • 提现操作
      • 黑名单添加
      • 白名单添加
      • 新增操作员设置
      • 添加邮箱提醒
      • 物流上传
      • 对账单下载&查询
      • 争议订单处理
      • 拒付处理
      • 拒付预警处理
      • 重置密码
    • 附录
      • 本地化汇总
      • FAQ
        • 常见问题解答
        • 集成和认证
        • ueeshop配置常见错误
        • ApplePay常见问题
        • 支付和预授权的区别
      • 过期文档
        • applepay&googlepay 内嵌1.0.0
        • 参数对象说明(过期)
  • 数据模型
    • 示例数据模型
      • Pet
      • OrderInfo
      • Category
      • Tag
  1. 集成之前

在SandBox中集成接口

本节内容将指导您在测试环境中集成UseePay收单服务:

步骤流程#

在对接过程中遇到任何问题,请及时在客户群中向我们反馈,UseePay竭诚为您服务。

1. 激活SandBox环境管理后台账户#

请在客户对接群中向UseePay运营提供您的email邮箱(对该邮箱无特殊要求,确保能正常接收激活邮件即可),运营收到后会向该邮箱发送一封激活邮件,收到邮件后请按照邮件提示激活SandBox环境后台管理系统账户。
image.png

2. 准备基本生产要素#

📌在激活Sandbox环境的后台管理系统账户后,正式集成支付接口之前,您还需要准备三样必需的生产要素:商户号、商户秘钥以及商户域名,分别对应请求中的三个参数:merchantNo,pKey,appId。其中:
【商户号】merchantNo是商户在UseePay中的唯一标识,同一家商户在同一个开发环境中只拥有一个商户号。
【秘钥】pkey是商户秘钥,请根据实际需要选择相应的秘钥。
【域名】appId是对网站域名的字符串表达。同一家商户的多个网站,使用appId进行区别。
📌注意:
由于SandBox环境和Prod环境是相互独立的,所以即使是同一家商户的生产要素,在两套环境上也是不通用的!都需要各自激活

2.1 获取商户号#

登录通过邮件注册的商户后台管理系统,在配置中心 → 秘钥管理 → 商户号处可以看到UseePay分配给您的商户号。
image.png

2.2 获取密钥(MD5/RSA)#

再次说明,本文档面向自建站用户,如果您符合该用户类型,请在后台管理系统 → 配置中心 → 秘钥管理 → MD5秘钥/RSA申请MD5密钥或RSA密钥。
(自建站用户请忽略HMAC秘钥)
注:使用RSA秘钥时,您需要在后台管理系统 → 配置中心 → 秘钥管理 → RSA秘钥处提交您的密钥对的公钥
商户系统
image.png
📌
MD5秘钥和RSA秘钥有何区别?我不知道我该使用哪种秘钥。
答:不同的秘钥对应不同加签/验签的方式,您可根据您具体要使用的加签/验签方式来决定使用使用哪种秘钥,详细内容请参看本手册文档【请求签名指南】
请求签名指南-加签/验签

2.3 准备APPID#

假设您有两个网站A、B,对应的域名是a.com,b.com。则您需要:
1)首先在MC后台管理系统 → 域名管理 → 添加处手动添加这两个域名。
添加完毕后刷新页面,添加好的域名将在当前页面显示。
(这里假设您在添加a.com这个域名之后,在添加b.com时由于手误,添加为了b.com.hello)
2)对于以上例子,网站A的appId为a.com, 而网站B的appId是b.com.hello。也就是说,appId和您在后台管理系统中添加的域名是一一对应的。
提示
任何情况下,appId都要和您在商户后台管理系统中添加的域名保持完全一致。
理想状态下,您在后台管理系统中添加的域名应当和您的真实域名保持完全一致。
强烈建议您不要在添加的appId中携带【https://】和【http://】
SandBox商户系统 网站管理
image.png

3. 开始对接接口#

现在可以根据您自己的实际需求,去集成对应的接口,具体请参考本手册【接口文档目录】

4. 测试接口#

集成接口后,您需要进行完整的流程测试,可参考测试案例

5. 上线Prod#

恭喜你已经走到了这一步,相信,接下来请移步至文档[在Prod中上线服务],祝你成功!
修改于 2025-10-17 06:00:13
上一页
开始之前(必读)📘
下一页
在Prod中上线服务
Built with