电子回单查询
1. 产品介绍
1.1 简介
客户在交易完成后可以获得该笔交易的电子回单,用作凭证提供给自己的用户。可以通过接口和控台获得该笔交易的电子回单。
1.2 应用场景
需要通过接口方式获取电子回单的渠道商、SAAS服务商,可以通过接口和控台获得该笔交易的电子回单。
以上场景可以支持两种类型的电子回单:
- 支持向电商平台提供一张电子回单,展示100元订单金额及交易手续费;
- 支持为两个分账接收方分别生成电子回单,分别是90元与10元,不显示交易手续费;
如有更多场景可以咨询支持人员。
2. 接入前准备
2.1 商务准备
商户入驻开通后默认都是支持调用电子回单接口的。
2.2 对接准备
第一步:密钥获取
联调之前需要先获取公私钥,参见公私解钥参数获取说明;
第二步:公共参数获取
登录服务商/商户控台后,可在开发设置-开发者信息中,获取sys_id,product_id参数信息;
3. 开发指引
3.1 对接规范
调用汇付接口,均采取POST形式提交,数据格式统一为JSON格式,相关SDK及签名方法见链接:
SDK示例:Java 开发工具包
加签验签:v2版接口加签验签
3.2 系统调用流程
3.2.1 交易流程
调用电子回单查询接口获取所需电子回单。
选择不同模板类型会有不同的电子回单效果。
电子回单模板样式
订单模板
订单模板的“金额展示字段”展示为订单金额,不扣除手续费,示例如下。
金额模板
金额模板的“金额展示字段”展示为实际入账金额,已扣除手续费,示例如下。
有分账的模板
分账: 调用方传入主交易流水号,将按每个分账接收方分别生成一张展示对应实际接收方入账金额的电子回单(只生成已经交易确认完成的交易),生成压缩包供调用方下载。注:此时展示手续费为分账手续费而非主交易手续费。其中一方收到电子回单图例如下。
不分账: 调用方传入主交易流水号,将生成出款方到延迟户,展示金额为主交易金额的一张单子回单。
注:此时展示手续费为分主交易手续费。
收费模板
汇付收取支付手续费的电子回单,示例如下:
4. API列表
类型 | 功能 | 描述 |
---|---|---|
应用程序接口 | 电子回单查询 | 获取交易的电子回单 |
5.常见问题
- 下载地址失效。
问题原因:链接超过下载有效期。
当为分账模式时返回的为压缩包下载链接,其他模式均为pdf文件下载链接。分账模式的电子回单下载链接有效期为3天,建议下载保存。其它电子回单下载链接永久有效。
解决方案:
获取到电子发票链接时请及时下载保存。
更多问题详见斗拱开发者社区:https://service.dougong.net/t/qa