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.9 Refund Query

2.9 Consulta de información de reembolso

  • Ruta:/external/refund/Query/V1

  • Método: POST

  • Descripción de API: Esta es la API para que el socio consulte la información de reembolso, especialmente el Estado del reembolso.

  • Uso: A veces, La API de consulta de información de reembolso puede devolver el error debido a algunas razones impredecibles.El socio no debe considerar el error de la API de consulta como el resultado del reembolso. El socio debe utilizar el resultado específico devuelto por la API de consulta como resultado del reembolso.

  • Instrucción complementaria: Aunque DiDi enviará el webhook al socio, la API de consulta es obligatoria.Esta es una estrategia de respaldo (respaldo) para que el socio recupere el estado de reembolso en caso de que el Webhook se entregue sin éxito..

Mensaje de solicitud

Encabezado 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

Nombre del campo Tipo Descripción del campo Presente(Obligatorio / Opcional / Condicional) Observaciones
partnerRefundId Cadena ID del formulario de reembolso del comerciante Obligatorio

Ejemplo de solicitud

{
    "partnerRefundId": "f0136e12-8d3f-11ef-b32d-ca3c6358d263"
}

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 del pedido de reembolso Opcional
partnerRefundId Cadena ID del formulario de reembolso del comerciante Obligatorio
partnerOrderId Cadena ID del documento de pago del comerciante Obligatorio
orderId Cadena ID del pedido Opcional Create payment order API on DiDi Paga Después side
refundId Cadena ID de reembolso Opcional DiDi Paga Después-side generation
partnerUid Cadena ID de usuario del comerciante Opcional
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.
refundType Cadena Tipo de reembolso Opcional Enumeración:
PART_REFUND-Reembolso parcial
REEMBOLSO_COMPLETO-reembolso completo
currency Cadena Moneda Opcional Estándar ISO 4217
México MXN
refundStatus Cadena Estado del reembolso Opcional Enumeración:
INICIO: Inicializar
PENDIENTE: Procesando
ÉXITO:ÉXITO
Fallido: Fallido
rejectCode Cadena Código de rechazo Opcional Enumeración:
CantidadNoPermitida-El monto del reembolso no cumple con las condiciones requeridas.
ReembolsoYaRealizado: Solicitud de reembolso duplicada
PaylaterRuleRejected: Rechazado por las reglas de Paylater
UnpaidOrder: El pedido no ha sido pagado
ExistOrder: El pedido no existe
rejectMsg Cadena Motivo de rechazo Opcional
refundTime Cadena Tiempo de reembolso Opcional 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.
createTime Cadena Hora de creación del reembolso Opcional 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.
updateTime Cadena Hora de actualización del reembolso Opcional 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.
test Booleano Etiqueta de la hoja de prueba Opcional
error Objeto Error Opcional
errorCode Cadena Código de error Opcional
errorMessage Cadena Descripción del código de error Opcional

Ejemplo de respuesta

{
    "code": "SUCCESS",
    "message": "SUCCESS",
    "data": {
        "partnerOrderId": "1e1e51a8-8d38-11ef-b32d-ca3c6358d263",
        "partnerRefundId": "f0136e12-8d3f-11ef-b32d-ca3c6358d263",
        "orderId": "189d141e-8d38-11ef-b32d-ca3c6358d263",
        "refundId": "1658fd86-8d41-11ef-b32d-ca3c6358d263",
        "partnerUid": "01213121131",
        "refundAmount": 5000,
        "refundType":"ALL_REFUND",
        "currency": "MXN",
        "refundStatus": "INIT",
        "rejectCode": null,
        "rejectMsg": null,
        "refundTime": "2024-10-14T16:30:39.000+08:00",
        "createTime": "2024-10-14T16:30:39.000+08:00",
        "updateTime": "2024-10-14T16:30:39.000+08:00",
        "test": true
    },
    "error": null
}
Se copió correctamente.