order_site/docs/行业电子凭证/解决方案/相关文档/4.电子凭证检查电子凭证是否有效.md

open.virtual.eticket.checkavailable 需用户授权 POST 查询电子凭证校验结果 更新时间: 2023-11-01 20:02:42 检查电子凭证是否有效 系统环境 环境 域名 线上环境（推荐） https://openapi.kwaixiaodian.com 线上环境（备用） https://open.kwaixiaodian.com 系统参数 参数名 类型 必须 详情描述 appkey String 是 平台分配的appId timestamp Number 是 发起请求的Unix时间戳，单位为毫秒 access_token String 是 访问token，所有需用户授权API使用code模式获取，不需要用户授权API使用client_credentials获取，详情参考《授权说明》文档 version Number 是 请求的API版本号，目前版本为1 param JSON 是 业务参数，详见下方的请求入参 method String 是 请求的API英文名，详见各API定义 sign String 是 API入参的签名结果参数 signMethod String 是 签名算法，支持HMAC_SHA256和MD5，推荐使用HMAC_SHA256 请求参数 参数名 类型 必须 示例值 详情描述 buyerId Long 否 211 买家编号 eticketType String 是 22 电子凭证类型 etickets List 是 [] 电子凭证列表 orderId Long 否 1 订单编号 sellerId Long 是 211 卖家编号 返回参数 参数名 类型 示例值 详情描述 code String 1 主返回码 msg String success 主返回信息 sub_code String 1 子返回码 sub_msg String 1 子返回信息 etickets List [] 电子凭证校验结果 result Integer 1 是否成功 error_msg String 1 错误信息 错误码 错误码 错误类型 错误描述 解决方法 3009 业务错误 电子凭证核销时，可用数量和平台不一致，其中一部分券不可用 电子凭证核销时，可用数量和平台不一致，其中一部分券不可用 请求示例 JAVA CURL package com.kuaishou.merchant.open.api.sdk.demo; import com.kuaishou.merchant.open.api.common.utils.GsonUtils; import com.kuaishou.merchant.open.api.request.industry.OpenVirtualEticketCheckavailableRequest; import com.kuaishou.merchant.open.api.response.industry.OpenVirtualEticketCheckavailableResponse; import com.kuaishou.merchant.open.api.client.AccessTokenKsMerchantClient;

public class AccessTokenKsMerchantClientDemo {

public static void main(String[] args) {
    String url = "https://gw-merchant-staging.test.gifshow.com";
    String appKey = "your appKey";
    String signSecret = "your app signSecret";
    String accessToken = "your accessToken";

    AccessTokenKsMerchantClient client = new AccessTokenKsMerchantClient(url,appKey,signSecret);

    OpenVirtualEticketCheckavailableRequest request = new OpenVirtualEticketCheckavailableRequest();
    request.setAccessToken(accessToken);
    request.setApiMethodVersion(1L);

    request.setSellerId(211);
    request.setBuyerId(211);
    request.setOrderId(112);
    request.setBizTypeCode("22");
    List<AvailableETicketReq> list1 = new ArrayList<>();
    AvailableETicketReq obj1 = new AvailableETicketReq();
    obj1.setId("111");
    obj1.setCode("112");
    obj1.setNum(2);
    list1.add(obj1);
    request.setETicketList(list1);

    OpenVirtualEticketCheckavailableResponse response = client.execute(request);

    System.out.println(GsonUtils.toJSON(response));
}

}

响应示例 JSON { "result": 1, "error_msg": "success", "data": { "sellerId": 1, "buyerId": 1, "orderId": 1, "eticketType": "2" } }