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

      支付成功异步通知

      开发中
      POST
      /callback_url
      商户使用API接口创建订单时,必须传入callback_url,平台会主动发送支付结果到callback_url,商户可以根据平台传递的支付结果参数,接收方式是 json,处理自己平台的支付成功后的业务逻辑,处理成功后,返回success(注意是小写,如果是平台重复发送同一订单的异步通知请求,只要商户已经给该订单成功加款,请每次都返回success),如果处理失败,则返回fail
      ********注意:
      1、平台可能会重复多次发送支付结果数据到callback_url,商户平台一定要做重复请求相关的逻辑判断。商户接收到发卡平台重复发送的异步消息,只要订单在商户平台已经处理成功,就需要返回success,一旦返回fail,平台会每1分钟重复异步通知消息,直到重发6次,或者商户返回success,才会停止发送。
      2、验签的签名串连接需要按参数名ASCII码升序排序,如果参数的顺序错误,将无法通过验签
      3、为防止恶意用户伪造回调请求发送给商户,平台强烈要求API商户收到回调请求验签成功后,先不要做业务处理,请再调用本平台“查询订单状态”接口做二次确认,如果“查询订单”接口返回该订单为“已付款”状态,再做加款等业务操作!
      4、收到回调后返回 josn 格式, 如下: {"code": 200, "data":"","message":"success"}

      请求参数

      Body 参数application/json必填

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

      请求示例代码

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      请求示例请求示例
      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"
      }'

      返回响应

      🟢200成功
      application/json
      Body

      示例
      {}
      修改于 2025-12-12 04:03:28
      上一页
      查询订单状态
      Built with