1. 文档概览

目的

本文档描述了DiDi BNPL与合作伙伴之间系统交互的所有集成的相关内容，包括但不限于：
1. 相关接口。
2. 环境参数。

人员

本文档的受众是DiDi BNPL的合作伙伴（以下简称“合作伙伴”），包括PSP，电子商务平台或支付合作伙伴。

适用范围

本文件适用于所有与DiDi BNPL合作的合作伙伴，以特殊方式集成的合作伙伴除外。

支持

如对本文档内容有疑问，或在集成过程中遇到技术问题，请及时联系您的DiDi BNPL 的对接联系人，或者邮箱联系：didipaylaternotice@didiglobal.com

2. 开放API消息列表概览

序号	开放API列表	方向	API描述	必需/可选/条件性
1	Token API	合作伙伴 -> 滴滴	基础API，用于获取Token，并放入到其他接口请求Header的Authorization字段中。	必需
2	Prescreen 预热	合作伙伴 -> 滴滴	重要的功能性接口，提高PSR，提前进行用户资质的预校验，强烈建议合作伙伴支持该接口。	强烈建议
3	Create Payment Order 创建支付订单	合作伙伴 -> 滴滴	此API是创建订单的主要API。	必需
4	Cancel Order 取消订单	合作伙伴 -> 滴滴	这是取消订单的API。注：只有PENDING状态的订单才能取消。	可选
5	Payment Order Information Query 支付订单信息查询	合作伙伴 -> 滴滴	查询订单信息。 P.S. 如果支付订单信息查询返回错误，并不意味着交易失败，而是“支付订单信息查询”接口失败。 P.S. 尽管滴滴会向合作伙伴发送 Webhook ，但是我们还是需要合作伙伴支持该查询接口，因为Webhook有时会因为各种原因而投递失败，所以合作伙伴都会需要用Query接口进行支付状态查询。	必需
6	Payment Status Webhook 支付状态 Webhook	滴滴 -> 合作伙伴	滴滴系统将通过发送 Webhook 向合作伙伴告知支付状态。以下四种支付状态将发送给集成方: • 订单已成功支付:`PAYMENT.ORDER.PAID` • 订单已取消:`PAYMENT.ORDER.CANCELED` • 订单被拒绝:`PAYMENT.ORDER.DENIED` • 订单已过期:`PAYMENT.ORDER.EXPIRED`	必需
7	Refund Simulation 退款试算	合作伙伴 -> 滴滴	在合作伙伴提交退款申请之前,合作伙伴可以使用此API模拟退款操作,以核实相关费用。	可选
8	Refund 退款	合作伙伴 -> 滴滴	此API供合作伙伴用于退款交易。它既可用于客户发起的场景,也可用于系统发起的场景。	必需
9	Refund Information Query 退款信息查询	合作伙伴 -> 滴滴	查询退款订单信息。 P.S. 如果退款信息查询返回错误，并不意味着退款失败，而是“退款信息查询”接口失败。 P.S. 尽管滴滴会向合作伙伴发送 Webhook ，但是我们还是需要合作伙伴支持该查询接口，因为Webhook有时会因为各种原因而投递失败，所以合作伙伴都会需要用Query接口进行退款状态查询。	必需
10	Refund Status Webhook 退款状态 Webhook	滴滴 -> 合作伙伴	滴滴系统将通过发送 Webhook 通知合作伙伴退款状态。以下两种退款状态将发送给合作伙伴: • 退款成功:`REFUND.ORDER.SUCCESS` • 退款失败:`REFUND.ORDER.FAILED`	必需

3. DiDi BNPL 环境信息

DiDi BNPL 测试环境域名: https://paylater-sandbox.didiglobal.com
DiDi BNPL 生产环境域名: https://loan-paylater.didifinance.com

文档中心

1. 文档概览

目的

人员

适用范围

支持

2. 开放API消息列表概览

3. DiDi BNPL 环境信息