USEEPAY V1.0
中文
中文
English
UseePay官网
产品文档
V2.0版本
V1.0版本
收单商户平台
UseePay官网
产品文档
V2.0版本
V1.0版本
收单商户平台
中文
中文
English
集成之前
全球收单
产品说明
集成模式
跳转式收银台模式
内嵌式收银台模式
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
集成之前
在SandBox中集成接口
本节内容将指导您在测试环境中集成UseePay收单服务:
步骤流程
#
在对接过程中遇到任何问题,请及时在客户群中向我们反馈,UseePay竭诚为您服务。
1. 激活SandBox环境管理后台账户
#
请在客户对接群中向UseePay运营提供您的email邮箱(对该邮箱无特殊要求,确保能正常接收激活邮件即可),运营收到后会向该邮箱发送一封激活邮件,收到邮件后请按照邮件提示激活SandBox环境后台管理系统账户。
2. 准备基本生产要素
#
📌在激活Sandbox环境的后台管理系统账户后,正式集成支付接口之前,您还需要准备三样必需的生产要素:商户号、商户秘钥以及商户域名,分别对应请求中的三个参数:merchantNo,pKey,appId。其中:
【商户号】merchantNo是商户在UseePay中的唯一标识,同一家商户在同一个开发环境中只拥有一个商户号。
【秘钥】pkey是商户秘钥,请根据实际需要选择相应的秘钥。
【域名】appId是对网站域名的字符串表达。同一家商户的多个网站,使用appId进行区别。
📌注意:
由于SandBox环境和Prod环境是相互独立的,所以即使是同一家商户的生产要素,在两套环境上也是不通用的!都需要各自激活
2.1 获取商户号
#
登录通过邮件注册的商户后台管理系统,在配置中心 → 秘钥管理 → 商户号处可以看到UseePay分配给您的商户号。
2.2 获取密钥(MD5/RSA)
#
再次说明,本文档面向自建站用户,如果您符合该用户类型,请在后台管理系统 → 配置中心 → 秘钥管理 → MD5秘钥/RSA申请MD5密钥或RSA密钥。
(自建站用户请忽略HMAC秘钥)
注:使用RSA秘钥时,您需要在后台管理系统 → 配置中心 → 秘钥管理 → RSA秘钥处提交您的密钥对的公钥
商户系统
📌
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商户系统 网站管理
3. 开始对接接口
#
现在可以根据您自己的实际需求,去集成对应的接口,具体请参考本手册【接口文档目录】
4. 测试接口
#
集成接口后,您需要进行完整的流程测试,可参考
测试案例
5. 上线Prod
#
恭喜你已经走到了这一步,相信,接下来请移步至文档[在Prod中上线服务],祝你成功!
修改于
2025-10-17 06:00:13
上一页
开始之前(必读)📘
下一页
在Prod中上线服务