跳转至

支付单详情

功能说明

  • 查询支付单详情

接口地址

HTTP请求方式

  • Method: POST
  • Content-Type: application/x-www-form-urlencoded

参数说明

  • 公有参数

    发送请求是必须传入公共参数，详见公共参数

  • 私有参数

参数名称 是否必须 参数类型 长度限制 描述
enterprise_code 否 string [1,20] 企业编号（集团和运营商必填,企业不填）
trade_no 是 string [16] 关爱通的支付单号

请求示例（HTTP）

 POST /enterprise/consume/get HTTP/1.1
 Host: openapi.guanaitong.tech
 Content-Type: application/x-www-form-urlencoded
 Cache-Control: no-cache

access_token=e26026020539cd186f16ce041ac9cf6c&appid=20110661&sign=5347706e1cfba5d4ed6c041c0aa827897b173acc&version=1.0.0&timestamp=1660640879&trade_no=2022081620000404

请求示例（JAVA SDK）

public class Main {
    public static OpenClient openClient = new OpenClient(Constants.BASE_URL_TEST, "xxx", "xxx");
    public static void main(String[] args) {
        GetConsumeRequest getConsumeRequest = new GetConsumeRequest();
        getConsumeRequest.setTradeNo("2022082220000455");
        GetConsumeResp getConsumeResp = openClient.tradeApi().getConsume(getConsumeRequest);
        System.out.println(JSON.toJSONString(getConsumeResp));
    }
}

返回参数说明

参数名称 描述
code 返回码。详见错误代码。
msg 如果错误，返回错误信息。
data 如果没有错误，返回支付单详情
data.trade_no String类型，关爱通的支付单号
data.out_trade_no String类型，关爱通的业务单号
data.userid String类型，支付人第三方唯一标识
data.payer_name String类型，支付人
data.subject String类型，商品描述或交易描述
data.total_amount BigDecimal类型，交易总金额
data.pay_amount BigDecimal类型，实际支付金额
data.refund_amount BigDecimal类型，退款金额
data.status Integer类型，交易状态。 1、待支付；2、支付中；3、支付完成； 4、待退款；5、退款中；6、退款；7、已冲正
data.create_time String类型，交易创建时间，格式yyyy-MM-dd HH:mm:ss
data.pay_time String类型，交易支付时间，格式yyyy-MM-dd HH:mm:ss
data.refund_time String类型，退款时间，格式yyyy-MM-dd HH:mm:ss
data.assetCode String类型，POINT 积分；QUOTA 额度；CASH 现金；THIRD 第三方资产
data.commerce_order_detail 电商订单详情，只有新版关爱商城的支付单才返回，对象

订单详情（commerce_order_detail）

参数名称 描述
shop_order_code String类型，订单编号
activity_type Integer类型，活动类型 1:普通订单 2:拼团订单
buyer_name String类型，买家姓名
order_price BigDecimal类型，订单总价
logistics_amount BigDecimal类型，运费
trade_status Integer类型，买家订单交易状态
1 等待买家付款
2 买家已付款
3 商家已备货
4 商家已发货
5 买家已收货（交易成功）
6 订单取消（交易关闭）
trade_type Integer类型，交易类型 1:兑换 2：消费
remark String类型，买家留言
cancel_order_reason_desc String类型，订单关闭原因
order_list 订单明细，暂时只有新版关爱商城的支付单才返回，List集合

订单明细（order_list）

参数名称 描述
delivery_name String类型，收货人姓名
delivery_phone String类型，收货人手机号
address String类型，收货地址
order_price BigDecimal类型，订单价格
order_status Integer类型，订单状态1.等待买家付款
2.已付款,待备货
3.已付款，待备货，部分退款中
4.已备货待发货
5.已备货待发货部分退款中
6.已备货待发货退款中
7.已发货待买家确认收货
8.已发货待买家确认收货部分退款中
9.已发货待买家确认收货退款中
10.交易成功
11买家取消交易关闭
12客服取消交易关闭
13超时取消交易关闭
14退款成功交易关闭
trade_status Integer类型，买家订单交易状态
1 等待买家付款
2 买家已付款
3 商家已备货
4 商家已发货
5 买家已收货（交易成功）
6 订单取消（交易关闭）
time_created String类型，订单成交时间，格式yyyy-MM-dd HH:mm:ss
time_delivery String类型，发货时间，格式yyyy-MM-dd HH:mm:ss
time_delivery_end String类型，订单发货截止时间，格式yyyy-MM-dd HH:mm:ss
time_closed String类型，订单关闭时间，格式yyyy-MM-dd HH:mm:ss
logistics_amount BigDecimal类型，运费
product_list 订单商品列表，List集合

订单商品列表（product_list）

参数名称 描述
spu_code String类型，商品code
spu_name String类型，商品名称
product_title String类型，商品标题
sku_code String类型，sku_code
sku_name String类型，sku_name
sku_pic_url String类型，单规格商品的图片，默认取商品的第一张头图
sku_category String类型，规格信息(商品销售属性)
current_price BigDecimal类型，现价
deal_price BigDecimal类型，成交价
purchase_num Integer类型，购买数量

正确返回示例

{
    "trade_no": "2022081620000404",
    "userid": "tom0001",
    "payer_name": "tom0001",
    "subject": "关爱商城订单（202208161897550474918488）",
    "total_amount": 11.00,
    "pay_amount": 11.00,
    "refund_amount": 0.00,
    "status": 3,
    "create_time": "2022-08-16 16:29:50",
    "pay_time": "2022-08-16 16:29:50",
    "asset_code": "POINT",
    "commerce_order_detail": {
        "shop_order_code": "202208161897550474918488",
        "activity_type": 1,
        "buyer_name": "tom0001",
        "order_price": 11.0,
        "logistics_amount": 0.0,
        "trade_status": 2,
        "trade_type": 2,
        "remark": "",
        "cancel_order_reason_desc": "",
        "order_list": [{
            "delivery_name": "tom",
            "delivery_phone": "16898989091",
            "address": "上海上海市黄浦区南京东路街道大钱街999弄",
            "order_price": 10.0,
            "order_status": 2,
            "trade_status": 2,
            "logistics_amount": 0.0,
            "product_list": [{
                "spu_code": "PC22040800000002",
                "spu_name": "商品名456789hello",
                "product_title": "商品名456789hello",
                "sku_code": "KC22040800000005",
                "sku_name": "规格名:规格值",
                "sku_pic_url": "https://img1.guanaitong.com/grus-gfs/test/gmall-seller-mgr/by-days/2022-04-11/b33866b799ae0ad999d6a87a8cc5cc9a.jpeg",
                "sku_category": "规格名:规格值 ",
                "current_price": 5.0,
                "deal_price": 5.0,
                "purchase_num": 2
            }]
        }, {
            "delivery_name": "tom",
            "delivery_phone": "16898989091",
            "address": "上海上海市黄浦区南京东路街道大钱街999弄",
            "order_price": 1.0,
            "order_status": 2,
            "trade_status": 2,
            "logistics_amount": 0.0,
            "product_list": [{
                "spu_code": "PC21122900000003",
                "spu_name": "1229自营测试代收代付商家",
                "product_title": "1229自营测试代收代付商品",
                "sku_code": "KC21122900000010",
                "sku_name": "auto主系统预设色值数值文本框:#8C1A11|酒红色",
                "sku_pic_url": "https://img1.guanaitong.com/grus-gfs/test/gmall-seller-mgr/by-days/2021-12-29/709dad23a623a8bd0ae0211763f45794.jpg",
                "sku_category": "auto主系统预设色值数值文本框:#8C1A11|酒红色 ",
                "current_price": 1.0,
                "deal_price": 1.0,
                "purchase_num": 1
            }]
        }]
    }
}

错误返回示例

{
    "code": 1000220120,
    "data": null,
    "msg": "支付单号不存在"
}

常见错误码

错误码 错误信息
1000220120 支付单号不存在
1000240002 enterprise_code校验失败
其他公共错误码 其他公共错误码
回到页面顶部