12.1 申请营销补贴 - 汇联开放平台

请求参数

Body 参数application/json

appId

string

应用APPID

必需

商户应用APPID

subSn

string | null

子商户编码

可选

非必传项，目前仅代理商/服务商可传，普通商户和平台商户请勿传入

timestamp

string

时间戳

必需

请求时间戳单位秒，要求timestamp与当前时间间隔在60秒以内

requestId

string

请求id

必需

请求唯一标识，无其他意义，必须每一次请求不允许重复，用于定位问题

version

string

版本号1.01

可选

默认空，2025年2月20日之后接入的可传，最新版本为1.01，可传1.01

signType

string

签名方式

必需

固定值：RSA2

bizContent

object

请求参数

必需

由于工具限制，该字段必须转为JSON 格式字符串，请务必注意

mchOrderNo

string

商户下单订单号

可选

原商户交易订单号，与平台交易订单号必传一项

payOrderNo

string

平台下单订单号

可选

原平台交易订单号，与商户交易订单号必传一项

subsidyRequestId

string

补贴请求单号

必需

全局唯一

assumeMerchantNo

string

出资方商编

必需

出资方商编，机构侧生成的补贴方商编

parentMerchantNo

string

发起方商编

可选

发起方商编，不传将自动读取

merchantNo

string

商户编号

可选

不传将自动读取

subsidyAmount

string

补贴金额

可选

单位元

memo

string

补贴描述

可选

补贴描述

sign

string

签名

必需

参照签名方法

示例

{
    "appId": "string",
    "subSn": "string",
    "timestamp": "string",
    "requestId": "string",
    "version": "string",
    "signType": "string",
    "bizContent": {
        "mchOrderNo": "string",
        "payOrderNo": "string",
        "subsidyRequestId": "string",
        "assumeMerchantNo": "string",
        "parentMerchantNo": "string",
        "merchantNo": "string",
        "subsidyAmount": "string",
        "memo": "string"
    },
    "sign": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.qywh8.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "string",
    "subSn": "string",
    "timestamp": "string",
    "requestId": "string",
    "version": "string",
    "signType": "string",
    "bizContent": {
        "mchOrderNo": "string",
        "payOrderNo": "string",
        "subsidyRequestId": "string",
        "assumeMerchantNo": "string",
        "parentMerchantNo": "string",
        "merchantNo": "string",
        "subsidyAmount": "string",
        "memo": "string"
    },
    "sign": "string"
}'

返回响应

🟢200OK

application/json

Body

code

integer

请求状态

必需

返回200=成功，其他状态均为失败

data

object

返回数据体

可选

subsidyOrderNo

string

渠道补贴订单号

可选

渠道补贴订单号

status

string

补贴状态

可选

SUCCESS:成功
FAIL:失败
PROCESSING:处理中

subsidyAmount

string

补贴金额

可选

assumeMerchantNo

string

出资方商编

可选

failReason

string

失败原因

可选

msg

string

返回信息

必需

appId

string

应用APPID

可选

sn

string

商户编码

可选

sign

string

签名

可选

timestamp

string

时间戳

可选

signType

string

签名方式目前仅支持RSA2

可选

示例

{
    "code": 0,
    "data": {
        "subsidyOrderNo": "string",
        "status": "string",
        "subsidyAmount": "string",
        "assumeMerchantNo": "string",
        "failReason": "string"
    },
    "msg": "string",
    "appId": "string",
    "sn": "string",
    "sign": "string",
    "timestamp": "string",
    "signType": "string"
}