2.3. 查询接口
接口介绍：
描述：调用此接口查询支付或退款结果。
API endpoint: {api_domain}/api/giftcard/v1/ trade/query
Verb: POST
请求参数:
| 参数 | 必填 | 类型 | 约束 | 描述 |
|---|---|---|---|---|
| brand_code | 1 | String | 数字，最大6 位 | 品牌编号, 由收钱吧提供 |
| trade_no | 0-1 | String | 字符串，最大 64 位 | 收钱吧生成的原始交易编号，从 trade_no 和 out_trade_no 中选择一个 |
| out_trade_no | 0-1 | String | 字符串，最大 64 位 | 商户系统中的交易编号（填写退款交易的申请编号），从 trade_no 和 out_trade_no 中选择一个 |
返回参数:
| 参数 | 必填 | 类型 | 约束 | 描述 |
|---|---|---|---|---|
| brand_code | 1 | String | 数字，最大 6 位 | 品牌编号, 由收钱吧提供 |
| store_sn | 1 | String | 字符串，最大 36 位 | 商户门店编号 |
| workstation_sn | 1 | String | 字符串，最大 36 位 | 门店收银机编号, 如果商户系统没有此参数，则设置为 0 |
| check_sn | 1 | String | 字符串，最大 36 位 | 商户核对账单号码或商户订单号 |
| trade_no | 1 | String | 字符串，最大 64 位 | 收钱吧为此交易生成的交易编号 |
| out_trade_no | 1 | String | 字符串，最大 64 位 | 商户系统的原始交易号 |
| status | 1 | String | 字符串，最大 32 位 | 交易结果状态代码，详情查阅 3.1 |
| trade_detail | 0-1 | String | 对象 | 如果状态是“PAID”，“REFUNDEAD”，“PARTIAL_REFUNDED”， 则返回 |
| external_trade_detail | 0-1 | String | 对象 | 当礼品卡余额不足以支付订单金额时，可由礼品卡收银台采用微信或支付宝小程序付款的方式代为收取剩余金额。此功能是可选项，当启用此功能 时，该字段会随“trade_detail ”一起返回 |
trade_detail的结构定义:
| 参数 | 必填 | 类型 | 约束 | 描述 |
|---|---|---|---|---|
| payer_uid | 0-1 | String | 字符串，最大 64 位 | 付款人 ID |
| total_amount | 1 | String | 数字，最大 10 位 | 订单价格，精确到分 |
| pay_amount | 1 | String | 数字，最大 10 位 | 实际支付的返回价格，精确到分 |
| collect_amount | 1 | String | 数字，最大 10 位 | 实际收款的返回价格，精确到分 |
| payment_list | 0-1 | String | 数组 | 付款成功后，返回该订单的各支付渠道 |
| finish_time | 0-1 | String | 时间 | 交易完成时间 |
payment_list的结构定义:
| 参数 | 必填 | 类型 | 约束 | 描述 |
|---|---|---|---|---|
| total_amount | 1 | String | 数字，最大 10 位 | 订单价格，精确到分 |
| pay_amount | 1 | String | 数字，最大 10 位 | 实际支付的返回价格，精确到分 |
| collect_amount | 1 | String | 数字，最大 10 位 | 实际收款的返回价格，精确到分 |
| type | 1 | String | 字符串，最大 64 位 | 用于支付的卡类型，详见 3.2 |
| pay_account_id | 1 | String | 字符串，最大 64 位 | 此参数值表示卡号 |
External_trade_detail的结构定义:
| 参数 | 必填 | 类型 | 约束 | 描述 |
|---|---|---|---|---|
| trade_no | 1 | String | 字符串，最大 64 位 | 收钱吧为此交易生成的交易编号 |
| payer_uid | 1 | String | 字符串，最大 64 位 | 付款人 ID,微信 Openid 或支付宝 userid |
| total_amount | 1 | String | 数字，最大 10 位 | 订单价格，精确到分 |
| pay_amount | 1 | String | 数字，最大 10 位 | 实际支付的返回价格，精确到分 |
| collect_amount | 1 | String | 数字，最大 10 位 | 实际收款的返回价格，精确到分 |
| channel_type | 1 | String | 字符串，最大 64 位 | 用于支付的渠道类型，详见 3.3 |
| finish_time | 0-1 | String | 时间 | 交易完成时间 |