USEEPAY V1.0
中文
  • 中文
  • English
UseePay官网
产品文档
  • V2.0版本
  • V1.0版本
收单商户平台
UseePay官网
产品文档
  • V2.0版本
  • V1.0版本
收单商户平台
中文
  • 中文
  • English
  1. FAQ
  • 全球收单
    • 产品说明
    • 集成模式
      • 跳转式收银台模式
      • 内嵌式收银台模式
      • 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. FAQ

常见问题解答

1.介绍#

欢迎使用我们的跨境支付服务!本页面旨在帮助您解决在技术对接和运营过程中可能遇到的问题。如果您在以下列表中找不到答案,请联系我们的技术支持团队获取更多帮助。

2.常见问题集合#

2.1签名错误 sign error#

可以参考Demo里面的签名算法,同时通过下方建议进行排查
https://useepay.gitbook.io/developer/reference/demo
1.
检查API密钥和商户ID
操作建议:
● 确保商户在API请求中使用了正确的API密钥和商户ID。错误的API密钥或商户ID会导致签名无法验证通过。
● 平台提供了多个环境(如沙箱环境和生产环境),确保使用的是与当前环境匹配的API密钥。
测试环境:https://mc1.uat.useepay.com/#/home/mainManage/keyManagement
生产环境:https://mc.useepay.com/#/home/mainManage/keyManagement
2.
确认签名算法和签名顺序
操作建议:
● 确保签名加签算法符合文档要求。
● 检查签名生成时,所有的请求参数是否按照正确的顺序拼接
● 确保参数名与参数值都已正确地包含在签名计算中,且没有遗漏。
3.
检查签名字段的编码方式
操作建议:
● 确保所有参数的编码一致。有时,URL编码、字符编码(如UTF-8、ASCII等)不一致也会导致签名错误。
● 确保签名过程中不会对某些字符进行额外的编码或解码。
4.
检查请求中是否包含空格或特殊字符
操作建议:
● 检查所有请求参数,确保没有多余的空格或特殊字符。多余的空格会导致签名不匹配。

2.2 商户号不存在 "the merchant does not exist."#

这个问题通常是由于您请求的环境和您所使用的商户号不一致导致。
例如:
商户号是生产环境,但请求地址是测试环境;
商户号是测试环境,但请求地址是生产环境。
请重点检查您使用的商户号和请求环境是否对应。

3. 测试#

为什么用了测试卡,结果不符合预期#

测试卡: https://openapi-useepay.apifox.cn/doc-1988154
1.
测试卡类型或功能不支持特定操作
解决方法:
● 查看支付平台文档,确认所用的测试卡是否适用于您正在测试的场景。重点注意如果有需要输入email的情况,是否有填写
● 使用不同类型的测试卡,如“支付成功卡”,“支付失败卡”,“拒付卡”等,以测试不同的支付状态。
● 使用平台提供的错误码或状态码来确认模拟失败或拒付的条件。
2.
测试卡信息不完整或格式不正确
问题描述:测试卡信息(如卡号、有效期、CVV等)输入不正确或格式不符合要求,可能导致支付请求失败。
解决方法:
● 确保输入正确的测试卡信息(卡号、有效期、CVV、持卡人姓名等)。通常支付平台会提供正确的测试卡号和其他必要信息。
● 检查是否按照平台要求使用测试卡的特定格式。
3.
测试环境与生产环境的差异
问题描述:测试环境与生产环境之间存在差异,生产环境无法使用测试卡测试

4. 插件报错#

image.png
image.png
两种问题 一种是进来了但是显示报错 是因为密钥错了
一种是订单进不来,大概率是,ip没配置对

5. 支付完成重定向报错#

重定向url只支持post方式和https
修改于 2025-10-15 03:43:35
上一页
本地化汇总
下一页
集成和认证
Built with