提交验收凭证

POST

/merchantapi/v2/settlements/{settlementId}/acceptance

按结算主单提交1至5个验收凭证文件；平台同步下载并转存。提交时必须同时满足结算业务条件（未发放且金额大于0、发放中，或发放完成且成功笔数大于0）和验收状态条件（未提交、审核失败或历史空值）；审核中、审核通过不允许重复提交。fileUrl 必须为公网可匿名下载的 HTTPS 地址，不得依赖 Cookie、Authorization 或其他自定义鉴权头；最多允许 3 次重定向，且每次重定向仍须为公网 HTTPS。平台不提供审核回调，提交后请主动轮询查询接口。POST 请求实际传输加密外壳，x-business-request-example 为加密前业务 JSON。

请求参数

Path 参数

Header 参数

Body 参数application/json必填

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/merchantapi/v2/settlements//acceptance' \
--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": {
        "acceptanceRecordId": "2071000000000000001",
        "settlementId": "2069720243669520385",
        "settlementNo": "JS10088004",
        "acceptanceStatus": 1,
        "acceptanceStatusDesc": "审核中",
        "submitTime": "2026-07-28 15:30:00",
        "fileCount": 2,
        "files": [
            {
                "fileId": "2071000000000000101",
                "fileName": "acceptance-report.pdf",
                "fileUrl": "https://oss.example.com/merchant-acceptance-2071000000000000001-file-1.pdf"
            },
            {
                "fileId": "2071000000000000102",
                "fileName": "acceptance-detail.xlsx",
                "fileUrl": "https://oss.example.com/merchant-acceptance-2071000000000000001-file-2.xlsx"
            }
        ]
    },
    "timestamp": 1785223800000,
    "requestId": "req_example",
    "encrypted": false,
    "signature": "example-signature"
}

修改于 2026-07-30 02:33:40

个税试算

查询验收凭证