USEEPAY
  1. 全球收单
  2. 通知接口说明
  3. 交易通知
USEEPAY
  • 全球收单
    • 域名说明
    • 集成流程说明
    • 生产账户启用
    • UseePay出口IP说明
    • 签名指导
      • 签名
      • 验签
      • demo
    • 沙盒测试资源
      • 测试卡号
      • 信用卡测试案例
      • 退款测试案例
      • 本地化测试案例
      • ApplePay&& Google Pay测试用例
    • 跳转式收银台接口
      • 跳转收银台paymentMethod参数说明
      • 支付/预授权
    • 内嵌式收银台接口
      • 0.0.1-只支持信用卡
        • 内嵌收银台快捷支付
        • 内嵌收银台新版本更新说明
        • 内嵌收银台对接说明
      • 新版-支持信用卡+AP+GP
        • 内嵌收银台2.0.0版本说明
      • create token 创建JSSDK所需的token
    • 订单通用接口
      • 退款Refund
      • 查询Query
      • 预授权撤销(Void)
      • 预授权完成(Capture)
    • 本地化支付
      • 本地化汇总
      • 本地化接口
        • 便利店支付
          • konbini
            • konbini 收银台模式
            • konbini api模式
          • payeasy
            • payeasy api 模式
            • payeasy 收银台模式
        • 分期付款Pay Later
          • Klarna产品介绍
          • Klarna direct
          • Klarna Redirect
        • 电子钱包
          • Alipay
            • Alipay Direct 文档
            • alipay_cn/alipay_hk direct 文档
          • Wechat-HK
            • 扫码支付
              • 扫码支付
              • direct
                • 扫码支付 Server To Server模式
              • redirect
                • 扫码支付收银台模式(wechat_native)
            • Jsapi支付下单接口
              • 小程序支付
              • 微信公众号支付
              • Jsapi支付下单接口
            • H5支付
              • H5支付
          • Google Pay
            • GoogePay Test card
            • Google Pay 对接可能遇到的问题
            • redirect
              • 跳转式GooglePay收银台
            • api
              • Google Pay API对接
              • Googlepay API 支付
          • applepay
            • ApplePay 扩展
            • ApplePay API
              • ApplePay API接入流程
              • ApplePay API接入流程备份
              • ApplePay支付
              • ApplePay商户Session
            • applepay cashier
              • applepay 跳转收银台
          • applepay&googlepay内嵌
            • 1.0.0 内嵌方式对接 （建议使用“内嵌方式对接2.0.0”版本）
            • 内嵌方式对接2.0.0
        • 银行转账
          • pix
          • Giropay
            • Giropay_Redirect
            • Giropay_Direct
          • sofort
            • sofort_Redirect
            • sofort_Direct
          • bancontact
            • bancontact_Redirect
          • Ideal
            • Ideal_Redirect
            • Ideal_Direct
          • boleto
            • boleto_Direct
        • 本地化Card
        • Cash(Ticket)现金支付
          • oxxo
          • boleto
          • Cash Common
      • 支付方式(国家/地区)
        • 荷兰
        • 巴西
        • 墨西哥
        • 中国香港
        • 日本
        • 德国
        • 奥地利
        • 西班牙
        • 波兰
        • 意大利
        • 哥伦比亚
        • 比利时
        • 瑞士
    • 通用对象参数和规范说明
      • 参数对象说明(过期)
      • 业务结果码（ResultCode）
      • 错误码（ErrorCode）
      • 金额和货币单位
      • 国家信息参考
      • 对象模型
        • userInfo
        • shippingAddress
        • goodsInfo
        • billingAddress
        • deviceInfo
        • transactionInfo
    • 通知接口说明
      • 交易通知
        • 同步通知
        • 异步 webhook版本升级
        • webhook
          POST
      • 拒付
        • 拒付webhook
    • 物流接口
      • 物流信息上送
        • 物流信息上传2.1
        • 物流信息上传(已废弃)
      • 物流信息查询
        • 物流信息查询2.1
        • 物流信息查询(已废弃)
    • 拒付接口
      • 拒付流程说明
      • 拒付查询
    • SFTP
      • SFTP
    • 常见问题
      • 支付和预授权的区别
    • demo
    • 插件安装指导
      • magento插件支付安装
        • Wechat/Alipay/UseePay Payments
    • 订阅
      • 订阅文档
  • 产品说明
    • 收银台
    • 内嵌式收银台
    • Server To Server 直连
  • FAQ
    • 集成和认证
    • 常见问题解答
    • ueeshop配置常见错误
    • ApplePay常见问题
  1. 全球收单
  2. 通知接口说明
  3. 交易通知

webhook

全球收单-SandBox环境
全球收单-SandBox环境
POST
{notifyUrl}

说明#

目前支持两种方式配置webhook
1.
接口中传输notifyUrl (优先级更高，先取接口中传输notifyUrl，如果没传就取在MC商户后台配置通知地址 )
2.
在MC商户后台配置通知地址
https://mc.useepay.com/#/home/mainManage/asynNotification
image.png
提示
被请求方返回 httpstatus 200表示接收通知成功，否则useepay会重新发送通知
通知频率 1m,3m,5m,10m,15m,15m,30m,1h

时序图#

什么情况下会触发webhook?#

订单变成终态时会出发webhook。
resultCode说明
succeed订单成功
failed订单失败
closed订单超时未支付关闭
cancelled指在交易完成之前被取消。通常是发生在预授权订单
pending_review预授权交易ok,等待预授权完成。此状态只有3d动态预授权才会返回

注意事项#

注意
因为UseePay允许商户使用相同订单号进行支付，所以商户可能会收到同一笔订单成功和失败的通知
UseePay并不能保证发送webhook的顺序
请注意此处的参数未来可能会增加，请您不要根据固定参数名验签。应根据响应动态生成加签参数
同样的通知可能会多次发送给机构系统。机构系统必须能够正确处理重复的通知

请求参数

Path 参数
notifyUrl
string 
必需
Header 参数
Content-Type
string 
必需
示例值:
application/x-www-form-urlencoded
Body 参数application/x-www-form-urlencoded
version
string 
可选
max=5 交易异步通知报文版本，固定为：1.0
示例值:
1.0
merchantNo
string 
必需
max=16 商户编号，由USEEPAY 分配
示例值:
500000000007362
transactionId
string 
必需
max=64 商户订单号
示例值:
202212070142347
originalTransactionId
string 
可选
max=64 原始商户订单号
示例值:
originalTransactionId
reference
string 
必需
max=64 USEEPAY 订单号
示例值:
reference
transactionType
string 
必需
max=64 交易类型： pay；authorization; refund; capture;authorizationVoid;
示例值:
pay
amount
string 
必需
max=12 交易金额，单位为对应币种的最小货币单位(详见 ISO 4217)
示例值:
1234
currency
string 
可选
max=3 3 位 ISO 大写字母货币代码((详见 ISO 4217)
示例值:
USD
resultCode
string 
必需
max=32 业务结果业务结果码
示例值:
succeed
errorCode
string 
可选
max=4 [错误码](https://app.apifox.com/link/project/2038036/apis/doc-1990078）
示例值:
0000
errorMsg
string 
可选
max=256 错误码消息描述
示例值:
0000
echoParam
string 
可选
max=256 回声参数，响应报文会原样返回
示例值:
echoParam
signType
string 
MD5/RSA
必需
示例值:
MD5
sign
string 
必需
max=256 商户请求参数的签名串
示例值:
decb3b9b728c7af4251acae23804939b
issuerResponse
string 
可选
发卡行返回的新 Json String的格式
示例值:
{"issuerResponseMsg":"Not sufficient funds","issuerResponseCode":"51"}
reserved
string 
可选
回声参数: UseePay内部使用

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://pay-gateway1.uat.useepay.com' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'version=1.0' \
--data-urlencode 'merchantNo=500000000007362' \
--data-urlencode 'transactionId=202212070142347' \
--data-urlencode 'originalTransactionId=originalTransactionId' \
--data-urlencode 'reference=reference' \
--data-urlencode 'transactionType=pay' \
--data-urlencode 'amount=1234' \
--data-urlencode 'currency=USD' \
--data-urlencode 'resultCode=succeed' \
--data-urlencode 'errorCode=0000' \
--data-urlencode 'errorMsg=0000' \
--data-urlencode 'echoParam=echoParam' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'sign=decb3b9b728c7af4251acae23804939b' \
--data-urlencode 'issuerResponse={"issuerResponseMsg":"Not sufficient funds","issuerResponseCode":"51"}' \
--data-urlencode 'reserved='

返回响应

🟢200成功
application/json
Body
object {0}
示例
amount=1234&resultCode=closed&sign=5cb57302e93b8b2342e7f587437f0855&errorCode=3300&version=1.0&transactionId=202110140304347&errorMsg=Transaction is expired&reference=1012110141504650869&transactionType=pay&echoParam=echoParam&reserved=reserved&signType=MD5&currency=USD&merchantNo=500000000007381
修改于 2024-12-13 06:30:48
上一页
异步 webhook版本升级
下一页
拒付webhook
Built with