微信支付回调

POST

/api/v1/commerce/payments/wechat/notify

处理微信支付平台的支付结果回调通知。

回调处理流程：

验证回调签名和数据完整性

检查订单和支付记录状态

更新支付状态为成功或失败

触发订单状态变更（如待发货）

发送支付成功通知给用户

幂等性保证：

基于商户订单号和回调数据生成指纹

相同回调24小时内只处理一次

返回标准成功响应给微信服务器

回调数据验证：

验证签名正确性

检查订单金额一致性

确认支付状态有效性

记录回调日志用于审计

业务规则：

成功支付：更新订单状态为已支付

支付失败：记录失败原因，允许重试

重复回调：直接返回成功，不重复处理

安全考虑：

验证回调来源IP白名单

记录所有回调日志用于审计

异常情况及时报警处理

注意： 此接口主要由微信支付服务器调用，不建议手动调用

Request

Header Params

Body Params application/jsonRequired

Example

{
    "property1": "string",
    "property2": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/commerce/payments/wechat/notify' \
--header 'X-Tenant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "property1": "string",
    "property2": "string"
}'

Responses

🟢200成功

application/json

Successful Response

Body

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "property1": "string",
        "property2": "string"
    }
}

🟠422无法处理的实体

Modified at 2025-09-26 15:37:19

获取支付详情

获取店铺列表