已更新更新时间:2024-10-17 11:15:43文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测(即可查看检测结果)若有未通过的接入检测项,接口将无法调通去登录返回文档目前支付宝对外的常用对账方式有两种:一种是通过在支付宝后台下载账单的方式来对账;一种是通过调用接口的方式来实现对账。服务商的对账管理请进入 。 1 新企业版账单下载商家财务人员登录新企业版 ,可通过账单下载页面,下载登录账号的已完成结算的对账单,并使用该数据完成财务核算。支持下载以下两种类型账单:●资金账单 用于表达支付宝账号的收支变化,对应 alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址接口)下载的 trabill_type = signcustomer账单。●交易账单 用于表达支付宝收单业务中发生的交易订单,对应 alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址接口)下载的 trabill_type = trade账单。1.1 日账单下载进入日账单下载页面,默认显示最近日账单的所在月份,默认选中最近日账单所在日期。鼠标移动到已完成结算的日期,显示可下载链接。点击所在日期可进行下载。1.1.1 特殊说明1账单未生成:前一日的日账单在第二天生成,在第二天生成之前在下载区域提示 账单未生成,不可点击下载。 2本日无收支:若已完成结算的某日无任何收支,则在下载区域提示 本日无收支,不可点击下载。 3日账单下载,支持范围从 2013 年 1 月 1 日开始。1.2 月账单下载月账单下载功能同日账单下载。进入月账单下载页面,默认显示最近月账单的所在年份,默认选中最近月账单所在月份。鼠标移动到已完成结算的日期,显示可下载链接。点击所在月份可进行下载。1.2.1 特殊说明1账单未生成 2月账单下载,支持范围从 2013 年 1 月开始。3每月账单一般会在次月 4 日或之前生成。2 接口对账方式2.1 场景介绍商家/服务商可通过接口下载指定日期(当天除外)的业务明细账单文件,并结合自身业务系统实现自动对账。获取账单技术实现大致分两种模式:收款账号接入模式(开通产品的账号即为收款账号)、主账号开通接入模式(此种模式包括服务商接入模式、一个主账号开通 n 个收款账号接入模式)。2.1.1 收款账号接入模式下载接口中指定 appid 所对应 pid 下所有交易记录的对账单。2.1.2 主账号开通接入模式包括服务商接入模式、一个主账号开通 n 个收款账号接入模式。第一步:该应用在开放平台上添加 第三方应用授权 功能。让收款账号给开通主账号授权。收款账号无需开通账单下载接口权限。第二步:请 获取服务端sdk 进行接口开发,请在请求参数中传入授权 token。开通产品的账号即可查询收款账号的账单。包括账务账单和业务账单。 2.2 调用流程1商家系统调用 alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址接口),传入指定日期,获得该日期账单文件的下载地址。2商家系统通过 http 方式后台访问账单下载链接,将账单 csv 文件下载到本地后自行处理。注意该下载链接仅 30 秒,在得到链接后系统需要立刻请求下载账单文件。2.3 使用sdk快速接入alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址接口)2.3.1 关键入参参数名称参数说明bill_type账单类型,枚举支持:●trade:商家基于支付宝交易收单的业务账单,对应 的 交易账单。●signcustomer:基于商家支付宝余额收入及支出等资金变动的账务账单,对应 的 资金账单。bill_date需要下载的账单日期,最晚是当期日期的前一天。2.3.2 关键出参参数名称参数说明bill_download_url账单文件下载地址,30 秒有效下载账单文件3 附录商家下载账单后,会得到 业务账单 或 财务账单 文件夹,各包含了 明细 和 汇总 两张表。3.1 业务账单3.1.1 汇总3.1.2 业务账单明细3.1.3 账单与支付接口字段对应关系部分业务账单字段与支付相关接口字段对应关系如下:支付宝交易号商户订单号商品名称门店编号门店名称终端号订单金额(元)商家实收(元)集分宝(元)商家优惠(元)券核销金额(元)券名称退款批次号服务费(元)trade_noout_trade_nogoods_detail#goods_namestore_idstore_nameterminal_idtotal_amountreceipt_amountpoint_amountmdiscount_amountvoucher_detail_list#amountvoucher_detail_list#namebatch_nocharge_amount支付宝系统中全局唯一标识用户一笔交易的流水号。商户系统中唯一标识一笔用户交易的流水号。商品名称。商户门店编号。请求交易支付中的商户店铺的名称。商户机具终端编号。订单总金额,单位为 元。商家实收=订单金额 total_amount - 商户出资的优惠金额。该笔交易过程中使用集分宝的付款金额。该笔交易过程中使用的商家优惠金额。该笔交易过程中使用优惠券核销的付款金额。本笔交易使用的券名称。该笔交易产生退款后退款批次识别号,对应退款 out_request_no 字段。该笔交易收取商家服务费(手续费)金额。3.2 账务账单3.2.1 汇总3.2.2 账务账单明细3.3 下载设置商家可在 页面点击 下载设置,设置下载的业务及账务账单语言、包含字段等明细信息。