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.5 Payment Order Query

2.5 Consulta de Información de Pedido de Pago

  • Ruta: /external/Order/queryByPartnerOrderId/V1

  • Método: POST

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

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

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

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

Nombre del campo Tipo Descripción del campo Presente(Obligatorio / Opcional / Condicional) Observaciones
partnerOrderId Cadena Id del documento de pago del lado del comerciante Obligatorio Clave de IDempotent
Identificador del número de serie del pago del comerciante

Ejemplo de solicitud

{
    "partnerOrderId": "1e1e51a8-8d38-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 Datos de la orden de pago Opcional
orderId Cadena ID del pedido Obligatorio DiDi Paga Después-side generation
partnerOrderId Cadena ID del documento de pago del comerciante Obligatorio
partnerUid Cadena ID de usuario del comerciante Obligatorio
applyLoanId Cadena Solicitar el ID del préstamo Opcional Loan ID in the DiDi Paga Después side credit core system
partnerOrderAmount Largo Monto del pedido Obligatorio El importe real del pago multiplicado por 100; este importe es el monto final después de aplicar el descuento del comerciante.
La unidad de cantidad es el céntimo. Por ejemplo, si es 99,99 pesos, el valor aquí debería ser 9999.
currency Cadena Moneda Obligatorio Estándar ISO 4217
México MXN
orderStatus Cadena Estado del pedido Obligatorio Enumeración:
INIT-Inicializar PENDIENTE-PENDIENTE PAGO-PAGO PAGADO-PAGADO CANCELADO-CANCELADO EXPIRADO-EXPIRADO NEGADO-Rechazado
rejectCode Cadena Código de rechazo Opcional El valor existía en el estado DENEGADO.
Enumeración:
ErrorGeneral-ErroreInterno
PaylaterRuleRejected-Rechazado por las reglas de Paylater
RiskRuleRejected-Rechazado por las reglas de control de riesgos
ReembolsoAtrasado: El usuario tiene pagos atrasados.
CréditoInsuficiente-Límite de crédito insuficiente
PaylaterRuleDissatisfy-No cumple con los requisitos de la regla de Paylater
RechazadoPorControlDeRiesgos-Rechazado por el control de riesgos
TradePayFail-Fallo al gastar
rejectMsg Cadena Motivo de rechazo Opcional El valor existía en el estado DENEGADO.
redirectUrl Cadena URL de redireccionamiento Obligatorio Una vez finalizada la operación de pago en la página de DiDi Paga Después, independientemente de si el pago fue exitoso o no, esta URL será analizada y devuelta.
Esta es principalmente una interacción de página a página.
No verificará si la URL puede redirigirse.
redirectAppLink Cadena Enlace de redireccionamiento de la aplicación Obligatorio Invocación DE LA APLICACIÓN: El socio debe incluir elredirectAppLinkEn la solicitud de pago.
fuid Largo DiDi Paga Después financial member domain user ID Opcional
metadata Cadena Información de metadatos Opcional DiDi Paga Después proporcionará esta información mediante la consulta y el callback de pedidos.
Formato JSON
paymentEntryUrl Cadena url redirecting to DiDi Paga Después H5 payment page Opcional
expireTime Cadena Hora de vencimiento de este pedido 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.
finishTime Cadena Tiempo de finalización 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 pedido 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 El estado del pedido está retrasado, hay temor. 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.
orderCreateTime Cadena Hora de creación del pedido en el lado del comerciante Opcional patrón:aaaa-MM-dd'T'HH:mm:ss.SSSXXX
Zona horaria de la Ciudad de México
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": {
        "orderId": "189d141e-8d38-11ef-b32d-ca3c6358d263",
        "partnerOrderId": "1e1e51a8-8d38-11ef-b32d-ca3c6358d263",
        "partnerUid": "01213121131",
        "partnerOrderAmount": 5000,
        "currency": "MXN",
        "orderStatus": "PENDING",
        "redirectUrl": "<https://www.merchant.com/h5/orderInfo/index.html>",
        "redirectAppLink": "clientA://one/webpage?weburl=https%3A%2F%2Fapi.merchant-a.com%2Fcheckout%2Fresult",
        "fuid": 1231413141,
        "metadata": "{}",
        "paymentEntryUrl": "<https://pay.didiglobal.com/global-bnpl/kyc/?credit_type=full&fuid=1231413141&orderId=189d141e-8d38-11ef-b32d-ca3c6358d263>",
        "expireTime": "2026-10-14T18:26:00.000-06:00",
        "finishTime": null,
        "createTime": "2026-10-14T02:30:39.000-06:00",
        "updateTime": "2026-10-14T02:30:39.000-06:00",
        "orderCreateTime": "2026-10-14T02:30:39.000-06:00",
        "test": true
    },
    "error": null
}
Se copió correctamente.