USEEPAY V1.0
中文
中文
English
UseePay官网
产品文档
产品文档
V2.0版本
V1.0版本
收单商户平台
UseePay官网
产品文档
产品文档
V2.0版本
V1.0版本
收单商户平台
中文
中文
English
中文
中文
English
集成之前
全球收单
产品说明
集成模式
跳转式收银台模式
内嵌式收银台模式
Direct API模式
插件模式
集成之前
开始之前(必读)📘
在SandBox中集成接口
在Prod中上线服务
请求签名指南
加签/验签Demo
加签/验签机制
开始集成
UseePay规范
业务结果码(ResultCode)
错误码(ErrorCode)
货币单位和金额规范
国家信息规范
接口集成📗
对象模型
跳转式收银台接口
跳转式收银台对接流程
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店匠
Shoplazza店匠(ApplePay&GooglePay&Klarna)
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
UseePay官网
产品文档
产品文档
V2.0版本
V1.0版本
收单商户平台
UseePay官网
产品文档
产品文档
V2.0版本
V1.0版本
收单商户平台
中文
中文
English
中文
中文
English
集成之前
在SandBox中集成接口
本节内容将指导您在测试环境中集成UseePay收单服务:
步骤流程
#
在对接过程中遇到任何问题,请及时在客户群中向我们反馈,UseePay竭诚为您服务。
1. 激活SandBox环境管理后台账户
#
请在客户对接群中向UseePay运营提供您的email邮箱(对该邮箱无特殊要求,确保能正常接收激活邮件即可),运营在完成初始配置后,系统会向该邮箱发送一封激活邮件,收到邮件后请按照邮件提示激活SandBox环境的商户后台管理系统(后文简称为MC系统)。
点击链接会进入新用户激活界面:
在该页面输入您的管理员名称,登录密码和支付密码。
注意
1.管理员名称只支持英文,不区分大小写
2.登录密码忘记:可联系UseePay运营重置
3.支付密码忘记:出款需要通过支付密码验证,如果忘记,需要出具盖有贵司公章的说明文件,经UseePay审核后重置,请谨慎保管支付密码。
点击激活按钮成功激活后,将跳转到MC登录界面。
在此界面输入邮箱,操作员名(首次登录操作员只有注册时的管理员,后续可根据贵司实际需要,自己开通不同权限的子操作员),登录密码后验证登录。
成功登入后界面如下:
2. 准备基本生产要素
#
📌在激活Sandbox环境的后台管理系统账户后,集成支付接口之前,您还需要准备三样必需的生产要素:商户号、商户秘钥以及商户域名,分别对应请求中的三个参数:merchantNo,pKey,appId。其中:
【商户号】merchantNo是商户在UseePay系统中的唯一标识。
【秘钥】pkey是商户秘钥,请根据实际需要选择相应的秘钥。
【域名】appId对应您的网站/APP,不同的网站/APP需要在MC分别审核通过才可在UseePay进行交易。
📌注意:
由于SandBox环境和Prod环境是相互独立的,所以即使是同一家商户的生产要素,在两套环境上也是不通用的!都需要各自激活。
2.1 获取商户号
#
登录通过邮件注册的商户后台管理系统,在配置中心 → 秘钥管理 → 商户号处可以看到UseePay分配给您的商户号。
2.2 获取密钥(MD5/RSA)
#
MC系统 → 配置中心 → 秘钥管理 → MD5秘钥/RSA。查看MD5密钥或启用RSA密钥。(自建站用户请忽略HMAC秘钥)
注:使用RSA秘钥时,您需要在后台管理系统 → 配置中心 → 秘钥管理 → RSA秘钥处提交您的密钥对的公钥
商户系统
📌
MD5秘钥和RSA秘钥有何区别?我不知道我该使用哪种秘钥。
答:对开发者而言,不同秘钥最直接的区别是加签/验签方式的不同,您可根据您的实际需要来决定使用使用哪种秘钥,详细内容请参看本手册文档
请求签名指南-加签/验签
2.3 准备APPID
#
请在MC系统 → 配置中心 →域名管理处按照网站/APP类型,添加对应的appId,并等待审核通过。
appId对应您的网站/APP,不同的网站/APP需要在MC分别审核通过才可在UseePay进行交易。
如您是网站:appid可以理解为对网站域名的字符串表达。
例如您有两个网站A、B,对应的域名是a.com,b.com。则您需要:
1)首先在
MC后台管理系统 → 域名管理 → 添加
处手动添加这两个域名。
添加完毕后刷新页面,添加好的域名将在当前页面显示。
(这里假设您在添加a.com这个域 名之后,在添加b.com时,提交的是www.b.com)
2)对于以上例子,这两个网站请求参数中的appId分别为:"a.com","
www.b.com
", 即appId和您在MC后台管理系统中添加的域名字符串是一一对应的。
3)UseePay会对您提交的网站进行审核,只有所有审核通过之后,appid指向的网站才能在UseePay进行交易。
提示
任何情况下,您请求参数中的appId都要和您在商户后台管理系统中添加的域名保持完全一致。
理想状态下,您在后台管理系统中添加的域名应当和您的真实域名保持完全一致。
强烈建议您不要在添加的appId中携带【https://】和【http://】
SandBox商户系统 网站管理
3. 开始对接接口
#
获取到商户号,秘钥且appid审核通过后,即完成了接口集成之前的前置参数处理工作。
支付API统一在【开始集成 → 接口集成】目录下,在此之前,请按顺序阅读文档,以避免疏漏其他问题,如验签工作。
4. 测试接口
#
集成接口后,您需要进行完整的流程测试,可参考
测试案例
5. 上线Prod
#
恭喜你已经走到了这一步,相信,接下来请移步至文档
在Prod中上线 服务
,祝你成功!
修改于
2025-12-25 08:31:58
上一页
开始之前(必读)📘
下一页
在Prod中上线服务