查询人民币结汇额度

POST /v1/mid-open-api/quota/get
需要验证签名

接口描述

该接口用于查询提现和付款至CNY的场景中，可使用的结汇额度。人名币入境需要提供合法证明（如一般贸易合同、跨境电商订单），基于上述证明会限制资金的使用上限，本接口会展示此种上限。

提示

客户额度由不同贸易类型的订单组成，目前分为货物贸易、服务贸易和一般贸易。

额度使用规则： 提现业务可不指定贸易类型，默认所有贸易类型额度可以混用，但可能会根据贸易类型将交易单拆分为多笔支付单据，即可能一次提现多笔到账。 付款业务一般默认一笔到账，则需要指定贸易类型（单一贸易类型可保障一笔到账）。

请求头

Parameter	Type	Required	Description
Authorization	string	M	access_token
Content-Type	string	M	application/json

请求参数

Parameter	Type	Required	Description
client_id	string(64)	M	客户号

返回响应

Parameter	Type	Required	Description
quota_list	list	O
-- trade_type	string	M	贸易类型【取值请见附录】
-- currency	string	M	币种：目前只有CNY
-- amount	string	M	可用额度金额

返回示例

成功
失败

  {
    "code": 200,
    "data": {
      "quota_list" : [
        {
          "trade_type": "GOODS",
          "currency": "CNY",
          "amount": 700.00
        },
        {
          "trade_type": "SERVICES",
          "currency": "CNY",
          "amount": 140.00
        }
      ]
    },
    "message": "SUCCESS"
  }

```json
{
  "code": 900002,
  "data": null,
  "message": "参数不合法"
}
```

附录

payout_type【交易类型】

enum	Description	remark
WITHDRAW	提现	收款账户和KYC主体同名
PAY	付款	收款账户和KYC主体非同名

trade_type【贸易类型】

enum	Description	remark
GOODS	货户贸易
SERVICES	服务贸易
GENERALLY	一般贸易

错误码

返回码	描述	建议
900000	system error	系统错误，请联系PingPong人员核查
900002	illegal param	参数错误，请根据提示更正信息
910001	user not exist	用户不存在，请核对client_id是否正确

接口描述​

请求头​

请求参数​

返回响应​

返回示例​

附录​

payout_type【交易类型】​

trade_type【贸易类型】​

错误码​