H Honor
ES
DiDi finanzas

Documentos

Proporciona pautas de integración, documentación de API, instrucciones de prueba y otra información necesaria a lo largo del proceso de integración

2.7 Refund Simulation

2.7 Simulación de reembolso

  • Ruta: /external/refund/trialPlan/V1

  • Método: POST

  • Descripción DE LA API: Antes de que el socio envíe la solicitud de reembolso, el socio puede usar esta API para simular el reembolso para verificar las tarifas relevantes.

Mensaje de solicitud

Encabezados de la solicitud

Nombre del campo Descripción del campo Valor del parámetro Presente(Obligatorio / Opcional / Condicional) Observaciones
Content-Type Tipo de contenido application/json Obligatorio
Authorization Este es el valor de autenticación de la identidad del socio. Bearer {ACCESS-TOKEN} Obligatorio Para más detalles, consulte la "Parte 2 Configuración de socio de DiDi BNPL y Env. Configuración".
El socio puede obtener el valor del TOKEN DE ACCESO mediante la llamada a la API de tokens.
Cuando caduque el acceso, vuelva a llamar a la API de tokens para obtener el nuevo token de acceso.
X-Paylater-Request-Id UUID uuid.
Example: 550e8400-e29b-41d4-a716-446655440000		 Obligatorio Cadena UUID v4 obligatoria. DiDi rechazará las solicitudes con formato no válido.

Cuerpo de la solicitud

Campo Tipo Descripción del campo Presente(Obligatorio / Opcional / Condicional) Observaciones
partnerOrderId Cadena ID del documento de pago del comerciante Obligatorio
refundAmount Largo Monto del reembolso Obligatorio Importe real del reembolso
La unidad de cantidad es el céntimo. Por ejemplo, si es 99,99 pesos, el valor aquí debería ser 9999.
Importe del reembolso = suma (Precio unitario del reembolso * Cantidad del reembolso)
refundType Cadena Tipo de reembolso Obligatorio Enumeración:
PART_REFUND-Partial refund
ALL_REFUND-full refund
currency Cadena Moneda Obligatorio Estándar ISO 4217
México MXN
refundTime Cadena Tiempo de reembolso Obligatorio patrón:aaaa-MM-dd'T'HH:mm:ss.SSSXXX
por ejemplo, '2025-12-08T01:11:33.000+08:00'. El desfase horario es obligatorio.

Ejemplo de solicitud

{
    "partnerOrderId": "1e1e51a8-8d38-11ef-b32d-ca3c6358d263",
    "refundAmount": 5000,
    "refundType":"ALL_REFUND",
    "currency": "MXN",
    "refundTime": "2024-10-11T17:10:00.000+08:00"
}

Mensaje de respuesta

Encabezado de respuesta

Nombre del campo Descripción del campo Valor del parámetro Presente(Obligatorio / Opcional / Condicional) Observaciones
Content-Type Tipo de contenido application/json Obligatorio

Cuerpo de la respuesta

Nombre del campo Tipo Descripción del campo Presente(Obligatorio / Opcional / Condicional) Observaciones
code Cadena Código de retorno Obligatorio Valor de enumeración:
SUCCESS
FAILED
RATE_LIMIT
INVALID_TOKEN
message Cadena Descripción del código de respuesta Obligatorio
data Objeto Información de la orden de reembolso Opcional
originalFee Largo Costo original Opcional Tarifa original = tarifa efectiva + tarifa de exención
La unidad de cantidad es el céntimo. Por ejemplo, si es 99,99 pesos, el valor aquí debería ser 9999.
Ejemplo: Si el reembolso ha excedido el período de ocupación de capital libre, lo que significa que el usuario debe pagar una tarifa de ocupación de capital, el usuario debe pagar la tarifa efectiva correspondiente al monto reembolsado para este formulario de reembolso.Si el usuario no necesita pagar cuota de ocupación de capital, entonces effectiveFee = 0.
effectiveFee Largo Costo efectivo Opcional La unidad de cantidad es el céntimo. Por ejemplo, si es 99,99 pesos, el valor aquí debería ser 9999.
El importe del reembolso es igual al coste total.
chargeFee Largo Exención de honorarios Opcional La unidad de cantidad es el céntimo. Por ejemplo, si es 99,99 pesos, el valor aquí debería ser 9999.
error Objeto Error Opcional
errorCode Cadena Código de error Opcional Enumeración:
AmountNotAllowed-El monto del reembolso no cumple con las condiciones requeridas
AlreadyRefund-Solicitud de reembolso duplicada
PaylaterRuleRechazado-Rechazado por las reglas de Paylater
UnpaidOrder-No se ha pagado el pedido
NotExistOrder-El orden no existe
errorMessage Cadena Descripción del código de error Opcional

Ejemplo de respuesta

{
    "code": "SUCCESS",
    "message": "SUCCESS",
    "data": {
        "effectiveFee": 0,
        "originalFee": 150,
        "chargeFee": 150
    },
    "error": null
}
Se copió correctamente.