统一收银台付款（专业版）

正式环境

POST

https://api.sparkpay.top/v4/pro/pay/cashier

/v4/pro/pay/cashier

openapi

请求参数

Header 参数

Content-Type

string

必需

仅支持application/json

默认值:

application/json

User-Agent

string

内容不能为空

必需

Sparkpay-App-Id

string

商户应用ID

必需

Sparkpay-Signature

string

请求签名

必需

Sparkpay-Timestamp

string

必需

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

Sparkpay-Nonce

string

请求随机串

必需

Body 参数application/json

字段说明

merchant_no

string

商户客户号

必需

request_no

string

商户收款请求号

必需

商户平台订单唯一标识，由商家自定义，64个字符以内，大小写不敏感、仅支持字母、数字、下划线且需保证在商户端不重复。注意：一个request_no对应一个支付订单，如果支付人支付没有成功，再次发起支付请求时，商户应该继续使用对应支付人的上次收款请求的request_no

merchant_order_time

integer

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

必需

pricing_amount

string

定价金额

必需

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

pricing_currency

string

定价币种

必需

枚举值详见网络与币种

merchant_order_timeout

integer

商户平台订单支付截止时间。时间戳（精确到秒）

必需

merchant_order_desc

string

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

必需

goods_info

string

商品描述

必需

merchant_order_no

string

商户原始订单号

必需

merchant_application_user_id

string

下单用户ID，即用户在商户应用中的 UserID

必需

notify_url

string

支付结果异步通知地址[post方法]

可选

redirect_url

string

支付成功页面回调地址

可选

business_info

string

行业相关特殊属性

可选

divide_detail

object

分账信息

可选

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

seller_amount

string

卖家金额

必需

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

seller_addr

string

卖家地址

必需

merchant_amount

string

商户服务费

必需

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

other_details

array [object {2}]

可选

extension

string

用于扩展请求参数

可选

available_payment_currency_networks

array [object {2}]

支持的接收网络

可选

枚举值详见网络与币种

currency

string

期望支付币种

必需

networks

array[string]

接收网络

必需

枚举值详见网络与币种

示例

{
  "merchant_no": "string",
  "request_no": "string",
  "merchant_order_time": 0,
  "pricing_amount": "string",
  "pricing_currency": "string",
  "merchant_order_timeout": 0,
  "merchant_order_desc": "string",
  "goods_info": "string",
  "merchant_order_no": "string",
  "merchant_application_user_id": "string",
  "notify_url": "string",
  "redirect_url": "string",
  "business_info": "string",
  "divide_detail": {
    "seller_amount": "string",
    "seller_addr": "string",
    "merchant_amount": "string",
    "other_details": [
      {
        "receiver_addr": "string",
        "amount": "string"
      }
    ]
  },
  "extension": "string",
  "available_payment_currency_networks": [
    {
      "currency": "string",
      "networks": [
        "string"
      ]
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.sparkpay.top/v4/pro/pay/cashier' \
--header 'User-Agent;' \
--header 'Sparkpay-App-Id;' \
--header 'Sparkpay-Signature;' \
--header 'Sparkpay-Timestamp;' \
--header 'Sparkpay-Nonce;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchant_no": "string",
    "request_no": "string",
    "merchant_order_time": 0,
    "pricing_amount": "string",
    "pricing_currency": "string",
    "merchant_order_timeout": 0,
    "merchant_order_desc": "string",
    "goods_info": "string",
    "merchant_order_no": "string",
    "merchant_application_user_id": "string",
    "notify_url": "string",
    "redirect_url": "string",
    "business_info": "string",
    "divide_detail": {
        "seller_amount": "string",
        "seller_addr": "string",
        "merchant_amount": "string",
        "other_details": [
            {
                "receiver_addr": "string",
                "amount": "string"
            }
        ]
    },
    "extension": "string",
    "available_payment_currency_networks": [
        {
            "currency": "string",
            "networks": [
                "string"
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

number

必需

message

string

必需

data

object

必需

cashier_url

string

收银台地址

必需

地址中会附带merchant_ca_addr、request_no、sign参数

request_no

string

商户收款请求号

必需

示例

{
  "code": 0,
  "message": "string",
  "data": {
    "cashier_url": "string",
    "request_no": "string"
  }
}

修改于 2025-04-14 05:37:55

支付订单查询

支付订单查询（专业版）