cn.jsbintask.wxpay.request.WxPayDownloadBillRequest Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of wxpay-sdk Show documentation

wxpay-sdk is a tool for WX pay.

The newest version!

package cn.jsbintask.wxpay.request;

import cn.jsbintask.wxpay.WxPayConstants;
import cn.jsbintask.wxpay.response.WxPayResponse;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;

/**
 * @author [email protected]
 * @date 2019/9/9 11:26
 * 
 * 商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致，通过对账单核对后可校正支付状态。
 * 注意：
 * 1、微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中，跟原支付单订单号一致；
 * 2、微信在次日9点启动生成前一天的对账单，建议商户10点后再获取；
 * 3、对账单中涉及金额的字段单位为“元”。
 * 4、对账单接口只能下载三个月以内的账单。
 * 5、对账单是以商户号纬度来生成的，如一个商户号与多个appid有绑定关系，则使用其中任何一个appid都可以请求下载对账单。对账单中的appid取自交易时候提交的appid，与请求下载对账单时使用的appid无关。
 * 
 */
@EqualsAndHashCode(callSuper = true)
@Data
@JacksonXmlRootElement(localName = "xml")
@ToString(callSuper = true)
public class WxPayDownloadBillRequest extends AbstractWxPayRawResponseRequest {
    /**
     * 下载对账单的日期，格式：20140603
     */
    private String billDate;
    private String billType;
    /**
     * 非必传参数，固定值：GZIP，返回格式为.gzip的压缩包账单。不传则默认为数据流形式。
     */
    private String tarType;

    @Override
    public Class responseType() {
        return WxPayResponse.class;
    }

    @Override
    public boolean ssl() {
        return false;
    }

    @Override
    public String apiSuffix() {
        return WxPayConstants.DOWNLOADBILL_URL_SUFFIX;
    }
}