SharePayx
    • 创建订单
      POST
    • 查询订单状态
      POST
    • 支付成功异步通知
      POST

      支付成功异步通知

      POST
      /callback_url
      1.
      异步通知概述 (Webhook Notification)
      支付成功后，平台将通过 POST 请求向商户提供的 callback_url 发送异步通知。通知内容采用 JSON 格式，包含订单的详细支付结果。商户系统接收到通知后，应据此处理内部业务逻辑（如：更新订单状态、发货或加款）。
      2.
      响应规范与重试机制 (Acknowledgement & Retries)
      商户服务器处理成功后，必须返回如下标准的 JSON 响应：{"code": 200, "data": "", "message": "success"}。注意： message 字段值必须为小写字符串 success。
      重试逻辑： 若商户返回 fail、非 200 状态码或响应超时，平台将启动自动重试机制（每隔 1 分钟重试一次，共计 6 次），直到收到 success 为止。
      3.
      安全验签与参数排序 (Security & Signature)
      为确保回调数据的完整性与来源可靠，所有回调请求均包含数字签名。
      验签规范： 商户在验证签名时，必须将所有回调参数按 参数名 ASCII 码升序 排列并拼接，随后按照平台指定的算法进行校验。任何参数顺序的错误都会导致验签失败。

      Request

      Body Params application/jsonRequired

      Example
      {
    "order_no": "string",
    "api_order_no": "string",
    "pay_trade_no": "string",
    "amount": "string",
    "pay_type": "string",
    "success_at": "string",
    "sign": "string"
}

      Request Code Samples

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location --request POST '/callback_url' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_no": "string",
    "api_order_no": "string",
    "pay_trade_no": "string",
    "amount": "string",
    "pay_type": "string",
    "success_at": "string",
    "sign": "string"
}'

      Responses

      🟢200成功
      application/json
      Body

      Example
      {}
      Modified at 2026-02-26 03:08:40
      Previous
      查询订单状态
      Built with