入账审核
需要验证签名
接口描述
当收到入账待提交审核通知，需要使用此接口，关联材料进行入账审核。
提示
- 该笔交易的业务类型business_type可以按客户实际业务类型填写，并关联对应的材料信息。
- 若使用合同订单关联入账时，一笔入账可关联多笔贸易合同订单，所有合同订单本次关联使用的总金额与币种需要与来账资金一致。
- 当入账审核异步通知结果为DECLINED，可通过此接口再次提交入账审核。注意：当入账审核状态为APPROVED、REJECTED、PROCESSING时，不允许重新提交入账审核。
- 如果是关联合同订单审核，当入账审核状态为DECLINED、REJECTED时，关联使用的合同订单金额会加回到可用余额中。
请求头
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | M | access_token |
| Content-Type | string | M | application/json |
请求参数
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string(64) | M | 注册PingPong返回的客户ID |
| transaction_id | string(64) | M | 入账交易流水 |
| business_type | string(128) | M | 业务类型:E_COMMERCE-平台电商，SELF_STATION-自建站，T_TRADE-一般贸易 |
| relate_order_list | array | C | 关联的合同单列表,business_type=SELF_STATION或T_TRADE必填,查询可用合同订单，币种和本次使用总金额必须与transaction_id对应的来账通知中的一致。 |
| extend_info | json | C | 电商入账通知补充材料，business_type=E_COMMERCE必填 |
relate_order_list
| Parameter | Type | Required | Description |
|---|---|---|---|
| trade_order_no | string(64) | M | 合作伙伴上传合同订单号,唯一幂等。 |
| use_amount | decimal(18,2) | M | 本次关联入账金额 |
| currency | string(3) | M | 合同单币种 |
extend_info
| Parameter | Type | Required | Description |
|---|---|---|---|
| store_url | string(255) | M | 电商店铺链接 |
| file_id_list | array | O | 上传文件：店铺后台绑定PingPong VA的截图;店铺后台绑定支付服务商的截图;支付服务商后台信息详情页截图;支付服务商后台绑定PingPong VA的截图 |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string(64) | M | 注册PingPong返回的客户ID |
| transaction_id | string(64) | M | 合作伙伴请求单号,唯一幂等。 |
| status | string(64) | M | 状态：PROCESSING:审核中，APPROVED：已入账 DECLINED：需要补充材料重新审核，REJECTED：审核不通过，需退款，REFUNDED:已退款 |
| fail_reason | string(128) | C | 失败原因，当状态为DECLINED/REJECTED/REFUNDED/时可能有值。 |
返回示例
- 成功
- 失败
{
"code": 200,
"message": "SUCCESS",
"data": {
"status": "PROCESSING",
"client_id": "IT123444",
"transaction_id": "MTX2312052875278099",
"fail_reason": null
}
}
{
"code": 900002,
"data": null,
"message": "illegal param"
}
错误码
| 返回码 | 描述 | 解决方案 |
|---|---|---|
| 900000 | system error | 系统错误，请联系PingPong技术人员核查 |
| 900002 | illegal param | 参数有误，请根据提示更正信息 |
| 900004 | order not exist | transaction_id对应的交易不存在，请检查单号是否正确 |
| 952002 | transaction_id is invalid | 该笔入账交易状态不允许提交审核，请核查交易状态是否正确 |
| 952003 | contract order is invalid | 关联的合同单状态非available或不存在，请核查关联的合同单是否正确 |
| 952004 | sum of use_amount not equal to transaction amount | 关联的合同单总金额需要跟入账交易的金额一致，请核查关联的合同单是否正确 |
| 952005 | contract order currency not match transaction currency | 关联的合同单币种需要跟入账交易的币种一致，请核查关联的合同单是否正确 |
| 952006 | contract order not belong to transaction client | 关联的合同单不属于对应入账交易的客户，请核查关联的合同单是否正确 |
| 952007 | contract order avail_amount invalid | 关联的合同单的可用余额不足use_amount，请核查关联的合同单是否正确 |
| 952008 | transaction not belong to client_id | 入账交易不属于对应客户，请核查入账交易是否正确 |