账单确认通知
- 接口(建议后缀): /reconciliation/confirm
- Method: POST
- 数据格式: Json
- 调用方: 每刻
- 接口说明: 每刻将通过该接口通知第三方, 企业已经确认账单
请求参数
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
externalCorpCode | String | Y | 企业唯一标识 |
billCode | String | Y | 账单唯一标识 |
返回结构
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
success | bool | Y | 请求是否成功 |
errorMessage | String | N | 失败信息(当 success 为 false 时,失败信息为必填) |
data | ConfirmResult | N | 账单确认结果(失败不必填写) |
ConfirmResult
参数 | 类型 | 必须 | 描述 |
---|---|---|---|
billConfirmStatus | ConfirmStatus | Y | 账单状态枚举 |
ConfirmStatus
code | 定义 |
---|---|
CONFIRMED | 确认成功 |
LOCKED | 已锁定(账单确认通知发起时,账单在第三方处于锁定状态,返回该枚举) |
[info] 说明:
账单状态不会影响账单在每刻的正常流程,都与 success = true 的逻辑相同,都会在每刻将账单标记为已确认。