SparkPay OpenAPI 文档
简体中文
  • 简体中文
  • English
简体中文
  • 简体中文
  • English
  1. API列表
  • 产品介绍
  • 快速指引
    • 接入准备
    • 接口加签说明
  • 接入必读
    • 接口规则
    • 异步通知
    • 接口错误码
    • 网络与币种
  • 对接场景
    • 支付
    • 关闭订单
  • API列表
    • 统一收银台付款
      POST
    • 支付订单关闭
      POST
    • 支付订单查询
      GET
    • 统一收银台付款(专业版)
      POST
    • 支付订单查询(专业版)
      GET
  • 常见问题
    • 通知相关问题
    • 跳转失败问题
    • 接口报错提示问题
    • 测试币领取/测试网连接
  • 对接示例
    • 接口签名示例-Postman
    • 接口签名示例-php
  • 版本说明
    • 版本说明
  1. API列表

支付订单查询(专业版)

正式环境
https://api.sparkpay.top
正式环境
https://api.sparkpay.top
GET
https://api.sparkpay.top
/v4/pro/pay/orders/{merchant_no}/{request_no}
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
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.sparkpay.top/v4/pro/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:已关闭
pricing_amount
string 
定价金额
必需
大单位,小数点最小精度位数为6。
pricing_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
必需
available_payment_currency_networks
array [object {2}] 
可用接收网络
必需
枚举值详见网络与币种
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",
        "pricing_amount": "string",
        "pricing_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",
        "available_payment_currency_networks": [
            {
                "currency": "string",
                "networks": [
                    "string"
                ]
            }
        ],
        "pay_network_info": {
            "payer_addr": "string",
            "merchant_ca_addr": "string",
            "merchant_recv_account": "string",
            "tx_hash": "string",
            "pay_network": 0,
            "payment_currency": "string",
            "payment_amount": "string",
            "payment_divide_detail": {
                "seller_amount": "string",
                "seller_addr": "string",
                "merchant_amount": "string",
                "other_details": [
                    {
                        "receiver_addr": "string",
                        "amount": "string"
                    }
                ]
            }
        }
    }
}
修改于 2025-04-14 05:38:02
上一页
统一收银台付款(专业版)
下一页
通知相关问题
Built with