创建结算单

POST

/merchantapi/v2/settlements

创建真实结算单。创建前建议先查询创客额度，必要时调用个税试算接口预估税费和实发金额。

POST 请求实际传输加密外壳 {"encryptedData":"..."}；x-business-request-example 为加密前业务 JSON。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "encryptedData": "U2FsdGVkX1+..."
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/merchantapi/v2/settlements' \
--header 'X-App-Id;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Sign;' \
--header 'X-Encrypt-Type;' \
--header 'Content-Type: application/json' \
--data '{
    "encryptedData": "U2FsdGVkX1+..."
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "settlementId": "202603250001",
        "settlementNo": "SET202603250001",
        "merchantSettlementNo": "MERCHANT_SETTLEMENT_001",
        "projectId": "2016422018623922178",
        "projectName": "直播活动推广项目",
        "taxCompanyName": "上海税地",
        "receiveMethod": "bank",
        "totalAmount": 5000,
        "totalCount": 1,
        "totalTax": 500,
        "totalNetAmount": 4520,
        "status": 1,
        "statusDesc": "发放中",
        "paymentInitiated": true,
        "details": [
            {
                "detailId": "30001",
                "detailNo": "SD10001879",
                "merchantDetailNo": "MERCHANT_DETAIL_001",
                "idCardHash": "a1b2c3",
                "amount": 5000,
                "tax": 500,
                "personalIncomeTaxAmount": 400,
                "personalValueAddedTaxAmount": 80,
                "surtaxAmount": 20,
                "netAmount": 4520,
                "status": 2
            }
        ]
    }
}

修改于 2026-06-25 01:45:32

查询结算单列表

查询结算单详情