1. Descripción General del Documento

Propósito

Este documento describe el contenido relacionado con toda la integración de sistemas entre DiDi BNPL y los socios, incluyendo, entre otros:
1. APIs relevantes.
2. Parámetros de ambiente.

Público objetivo

El público objetivo de este documento son los socios de DiDi BNPL (en adelante, "socio"), incluyendo PSPs, plataformas de comercio electrónico o socios de pago.

Alcance

Este documento aplica a todos los socios que cooperan con DiDi BNPL, con excepción de los socios integrados de forma especial.

Soporte

Si tienes alguna duda sobre el contenido de este documento o encuentras problemas técnicos durante la integración, comunícate a tiempo con tu contacto de DiDi BNPL, o escríbenos por correo electrónico a: didipaylaternotice@didiglobal.com

2. Descripción General de la Lista de Mensajes de la Open API

N.º	Lista de Open APIs	Dirección	Descripción de la API	O/Op/C
1	Token API	Socio -> DiDi	Esta API permite al socio obtener el ACCESS-TOKEN. Este ACCESS-TOKEN se insertará en el header de la API como el campo Authorization.	Obligatoria
2	Prescreen	Socio -> DiDi	El socio puede usar esta API para verificar si el usuario puede utilizar el método de pago DiDi Paga Después. Si se devuelve result = SUCCESS, significa que el método de pago DiDi Paga Después puede ser utilizado por este usuario. Sirve para que los usuarios verifiquen con antelación si tienen permiso para usar DiDi BNPL.	Opcional (muy recomendada)
3	Create Payment Order	Socio -> DiDi	Esta API es la API principal para crear la Orden. Cuando el usuario seleccione el método de pago DiDi Paga Después en tu página de checkout, tu sistema debe activar la API Create Payment Order.	Obligatoria
4	Cancel Order	Socio -> DiDi	Esta es la API para cancelar la orden. Solo se pueden cancelar las órdenes con estado PENDING.	Opcional
5	Payment Order Information Query	Socio -> DiDi	Esta es la API para que el socio consulte la información de la orden de pago, especialmente el estado de la orden. P.D. A veces, la API de consulta de información de la orden de pago puede devolver un error debido a razones imprevisibles. El socio no debe considerar el error de la API de consulta como el resultado de la orden de pago. El socio debe usar el resultado específico devuelto por la API de consulta como el resultado de la orden de pago. Aunque DiDi enviará el Webhook al socio, la API de consulta (Query) es obligatoria. Esta es una estrategia de contingencia para que el socio obtenga el estado de la orden en caso de que el Webhook no se entregue correctamente.	Obligatoria
6	Payment Status Webhook	DiDi -> Socio	El sistema de DiDi informará al socio sobre el estado del pago mediante el envío del webhook. Los cuatro estados de pago a continuación se enviarán a la parte integradora: • Orden pagada con éxito: `PAYMENT.ORDER.PAID` • Orden cancelada: `PAYMENT.ORDER.CANCELED` • Orden rechazada: `PAYMENT.ORDER.DENIED` • Orden expirada: `PAYMENT.ORDER.EXPIRED`	Obligatoria
7	Refund Simulation	Socio -> DiDi	Antes de que el socio envíe la solicitud de reembolso, el socio puede usar esta API para simular el reembolso y verificar las tarifas correspondientes.	Opcional
8	Refund	Socio -> DiDi	Esta API permite al socio reembolsar la transacción. Puede usarse tanto en escenarios iniciados por el cliente como en escenarios iniciados por el sistema.	Obligatoria
9	Refund Information Query	Socio -> DiDi	Esta es la API para que el socio consulte la información del reembolso, especialmente el estado del reembolso. P.D. A veces, la API de consulta de información del reembolso puede devolver un error debido a razones imprevisibles. El socio no debe considerar el error de la API de consulta como el resultado del reembolso. El socio debe usar el resultado específico devuelto por la API de consulta como el resultado del reembolso. Aunque DiDi enviará el Webhook al socio, la API de consulta (Query) es obligatoria. Esta es una estrategia de contingencia para que el socio obtenga el estado del reembolso en caso de que el Webhook no se entregue correctamente.	Obligatoria
10	Refund Status Webhook	DiDi -> Socio	El sistema de DiDi informará al socio sobre el estado del reembolso mediante el envío del webhook. Los dos estados de reembolso a continuación se enviarán al socio: • Reembolso exitoso: `REFUND.ORDER.SUCCESS` • Reembolso fallido: `REFUND.ORDER.FAILED`	Obligatoria

3. Información de Ambiente de DiDi BNPL

Dominio del ambiente Sandbox (prueba) de DiDi BNPL: https://paylater-sandbox.didiglobal.com
Dominio del ambiente de Producción de DiDi BNPL: https://loan-paylater.didifinance.com