支付订单查询 - SparkPay OpenAPI 文档

请求参数

Path 参数

merchant_no

string

商户客户号

必需

request_no

string

必需

商户收款请求号,商户平台订单唯一标识

Header 参数

User-Agent

string

内容不能为空

必需

Sparkpay-App-Id

string

商户应用ID

必需

Sparkpay-Signature

string

请求签名

必需

Sparkpay-Timestamp

string

必需

请求时间戳，当前时间（精确到秒）

Sparkpay-Nonce

string

请求随机串

必需

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://api.sparkpay.top/v4/pay/orders//' \
--header 'User-Agent;' \
--header 'Sparkpay-App-Id;' \
--header 'Sparkpay-Signature;' \
--header 'Sparkpay-Timestamp;' \
--header 'Sparkpay-Nonce;'

返回响应

🟢200成功

application/json

Body

code

number

必需

message

string

必需

data

object

必需

payment_order_no

string

支付平台系统支付订单编号

必需

order_time

number

支付订单创建时间，时间戳（精确到秒）

必需

pay_time

number

支付时间，时间戳（精确到秒）

可选

completed_time

number

订单完成时间，时间戳（精确到秒）

可选

closed_time

number

订单关闭时间，时间戳（精确到秒）

可选

pay_status

string

订单支付状态

必需

支付状态 UNPAID:未支付；COMPLETED:已完成; CLOSED:已关闭

real_pay_amount

string

实际支付金额

必需

大单位，小数点最小精度位数为6。

total_amount

string

订单金额

必需

大单位，小数点最小精度位数为6。

currency

string

支付币种

必需

枚举值详见网络与币种

merchant_customer_no

string

商户客户号

必需

merchant_order_no

string

商户原始订单号

必需

merchant_application_user_id

string

商户应用用户id

必需

request_no

string

商户收款请求号

必需

商户平台订单唯一标识

merchant_order_time

number

商户平台下单时间，时间戳（精确到秒）

必需

merchant_order_timeout

number

商户平台订单支付超时时间。单位：时间戳(秒)

必需

merchant_order_desc

string

订单描述，用户支付时会展示在收银台页面

必需

goods_info

string

商品信息

必需

business_info

string

行业相关特殊属性

必需

divide_detail

object

分账信息

可选

如果是分账订单，则该项中每个字段都不能为空

notify_url

string

支付结果异步通知地址

必需

redirect_url

string

支付成功页面回调地址

必需

extension

string

用于扩展请求参数

必需

app_id

string

商户app_id

必需

receive_network

string

支付的接收网络

必需

枚举值详见网络与币种

pay_network_info

object

支付网络信息

可选

示例

{
  "code": 0,
  "message": "string",
  "data": {
    "payment_order_no": "string",
    "order_time": 0,
    "pay_time": 0,
    "completed_time": 0,
    "closed_time": 0,
    "pay_status": "string",
    "real_pay_amount": "string",
    "total_amount": "string",
    "currency": "string",
    "merchant_customer_no": "string",
    "merchant_order_no": "string",
    "merchant_application_user_id": "string",
    "request_no": "string",
    "merchant_order_time": 0,
    "merchant_order_timeout": 0,
    "merchant_order_desc": "string",
    "goods_info": "string",
    "business_info": "string",
    "divide_detail": {
      "seller_amount": "string",
      "seller_addr": "string",
      "merchant_amount": "string",
      "other_details": [
        {
          "receiver_addr": "string",
          "amount": "string"
        }
      ]
    },
    "notify_url": "string",
    "redirect_url": "string",
    "extension": "string",
    "app_id": "string",
    "receive_network": "string",
    "pay_network_info": {
      "payer_addr": "string",
      "merchant_ca_addr": "string",
      "merchant_recv_account": "string",
      "tx_hash": "string",
      "pay_network": 0
    }
  }
}