可用合同单查询

POST /v1/mid-open-api/material/contract/query
需要验证签名

接口描述

该接口用来查询客户可用来关联入账(剩余可用金额大于0且审核通过)的合同订单集。

提示

1. 这些订单可以组合用于提交入账审核接口中的关联合同单列表。

请求头

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
currency	string(3)	O	订单币种
page_no	long	M	当前查询的页面码，从1开始
page_size	long	M	分页参数，每页返回的条数

返回响应

Parameter	Type	Required	Description
page_no	long	M	当前查询的页面码，从1开始
page_size	long	M	分页参数，每页返回的条数
page_count	long	M	可用合同单总数
page_list	array	C	可用合同单列表,详情见下方合同订单列表

合同订单列表

Parameter	Type	Required	Description
client_id	string(64)	M	注册PingPong返回的客户ID
trade_order_no	string(64)	M	合作伙伴上传合同订单号,唯一幂等。
amount	decimal(18,2)	M	合同订单金额
used_amount	decimal(18,2)	M	合同订单已关联入账金额
remain_amount	decimal(18,2)	M	合同订单剩余金额=amount-used_amount
currency	string(3)	M	合同单币种

返回示例

成功

    {
      "code": 200,
      "data": {
          "page_no": 1,
          "page_size": 10,
          "page_count": 1,
          "page_list": [
              {
                  "client_id": "20220620151628",
                  "trade_order_no": "PO20220620151628",
                  "amount": 123.33,
                  "used_amount": 23.33,
                  "remain_amount": 100
              }
          ]
      },
      "message": "SUCCESS"
    }

失败

{
    "code": 900002,
    "data": null,
    "message": "illegal param"
}

错误码

返回码	描述	解决方案
900000	system error	系统错误，请联系PingPong技术人员核查
900002	illegal param	参数有误，请根据提示更正信息