营销资金划拨记录查询

订单支付成功后，如果该订单使用了免充值代金券，则每笔券都对应一笔营销资金划拨记录。订单退款成功后，如果免充值代金券发生了退款，则每笔券退款都对应一笔退营销资金划拨记录。注意：不能根据退营销资金划拨记录来判断券是否退还给用户，请调用查询代金券详情来判断券是否退还给用户。

接口说明

请求方式：

post

https://p.wecard.tencent.com/cloudpay/v1/favor/query-favor-transfer-list

请求参数

Request

Body 包体

start_time选填

string

开始时间，RFC3339格式，如 2020-01-01T17:01:01+08:00 按创建时间查询划拨记录。如果 out_order_id 和 out_refund_id 参数为空，则该参数必填。

end_time选填

string

结束时间，可空。RFC3339格式。结束时间与开始时间间隔不超过24小时。

channel_merchant_id选填

string

商户Id。如果 out_order_id 和 out_refund_id 参数为空，则该参数必填。

page_size选填

integer

每页数据量。最大 100，默认 20

page选填

integer

页码。默认 1

out_order_id选填

string

如果按订单查询划拨记录，则会忽略 start_time 和 end_time 参数。

out_refund_id选填

string

查询退款单对应的退划拨记录。如果该参数不为空，则会忽略 out_order_id、start_time、end_time 参数。

请求示例

{
  "start_time": "2024-02-23T15:26:44+08:00",
  "end_time": "2024-02-23T23:26:44+08:00",
  "channel_merchant_id": "CM470781797219762383",
  "page_size": 1,
  "page": 1,
  "out_order_id": "",
  "out_refund_id": ""
}

返回参数

Response

200 OK

array必填

array

数组子类型：object

total_count必填

integer

总数

page_count必填

integer

总页数

page_size必填

integer

每页数据量

page必填

integer

当前页码

返回示例

{
  "array": [
    {
      "channel_merchant_id": "CM470781797219762383",
      "type": "pay",
      "out_order_id": "OutOrderId20210819100000000000000000000001",
      "channel_order_id": "OrderId20210819100000000000000000000001",
      "wechat_transaction_id": "4200001868202307246628884230",
      "promotion_id": "321",
      "amount": 10,
      "transfer_status": "TRANSFERRING",
      "id": "2cl0rXgLWfmx9MRLYobMMdh25xV",
      "create_time": "2024-02-23T15:26:44+08:00"
    }
  ],
  "total_count": 2,
  "page_count": 2,
  "page_size": 1,
  "page": 1
}