webhook
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
POST
{notifyUrl}
webhook处理要求
【2】UseePay以post方式请求您notifyUrl所指定的地址
【3】您的系统应在接收到异步通知后向UseePay响应HTTP200,UseePay接收到HTTP200后即认为您成功接受，并结束本次发送任务，否则重试发送。
webhook配置方式
1.
2.
提示
通知频率 1m,3m,5m,10m,15m,15m,30m,1h
时序图
什么情况下会触发webhook?
| resultCode | 说明 |
|---|---|
| succeed | 订单成功 |
| failed | 订单失败 |
| closed | 订单超时未支付关闭 |
| cancelled | 指在交易完成之前被取消。通常是发生在预授权订单 |
| pending_review | 预授权交易ok,等待预授权完成。此状态只有3d动态预授权才会返回 |
注意事项
注意
请求参数
Path 参数
Header 参数
Body 参数application/x-www-form-urlencoded
返回响应
请求示例请求示例
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='响应示例响应示例
closed
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¤cy=USD&merchantNo=500000000007381修改于 2025-10-16 10:11:10