Consulta de transacción

Nota:

Un tiempo de espera en la solicitud de pago solo indica que no se recibió una respuesta dentro del tiempo esperado y no implica un fallo en el negocio. En caso de un tiempo de espera, los comerciantes deben seguir el procedimiento estándar descrito a continuación:

Primero, marque el pedido relevante como pendiente y luego espere al menos 2 minutos antes de recuperar el estado del pedido a través de la interfaz de consulta. No intente volver a enviar la solicitud inmediatamente después de un tiempo de espera, ya que esto puede provocar transacciones duplicadas.

Cualquier pérdida financiera derivada de no seguir el procedimiento mencionado anteriormente será responsabilidad exclusiva de la parte responsable, y nuestra empresa no se hará responsable.

Dirección de solicitud

Nombre del entorno	URL
SandBox	POST https://api.supefina.tech/api/supefina/transactions/search-status
Producción	POST https://api.supefina.net/api/supefina/transactions/search-status

Parámetros de solicitud

Key	Value
Content-Type	application/json

Cuerpo de solicitud

Nombre de variable	Obligatorio	Tipo	Descripción
merId	Sí	String	ID del comerciante Ruta para obtener el ID del comerciante: Panel de comerciantes de Supefina - Gestión de comerciantes - Información básica - ID del comerciante
countryId	Sí	String	Código del país Referencia: Tabla de diccionario - Código de país México: MEX
merOrderNo	Sí	String	Número de pedido del comerciante
nonceStr	Sí	String	Cadena aleatoria La longitud no puede exceder 32 caracteres
supefinaOrderId	No	String	Número del pedido de Supefina
sign	Sí	String	Firma Refenrencia específica: Algoritmo de firma

Ejemplo de solicitud

{
    "countryId": "MEX",
    "merId": "8501088932494545",
    "merOrderNo": "arcus123",
    "supefinaOrderId": "202404290301009a6bb592c072449",
    "nonceStr": "D30FDC30597446FD95B792AC1E1A0AF5",
    "sign": "R9d1Enp0XUS5YMwv0EP$blm9mWTWwyoB"
}

Parámetros de respuesta

Nombre de variable	Tipo	Descripción
code	String	Código de respuesta Referencia específica: Códigos de estado de respuesta
msg	String	Mensaje de respuesta
data	Object	Datos de respuesta
transactionStatus	String	Estado de transacción Referencia específica: Tabla de diccionario - Estado del pedido de transacción
supefinaOrderId	String	Número del pedido de Supefina
merOrderId	String	Número de pedido del comerciante
merId	String	ID del comerciante
transactionType	String	Tipo de transacción 01：Payin 02：Payout
amount	BigDecimal	Monto del pedido
realityAmount	BigDecimal	Monto recibido
fee	BigDecimal	Comisión anticipada
realityFee	BigDecimal	Comisión recibida
successTime	Date	Tiempo de éxito de la transacción
identifier	String	Identificador
stampTime	String	Hora de Éxito de la Transacción (formato de sello de tiempo, preciso hasta segundos)
clave	String	Identificador del Flujo del Banco Central
errorMsg	String	Motivo de la Falla (devuelto en caso de falla de transacción y falla de pedido)

Ejemplo de respuesta

{
    "code": "200",
    "msg": "success ",
    "data": {
        "transactionStatus": "01",
        "supefinaOrderId": "202404290301009a6bb592c072449",
        "merOrderId": "arcus123",
        "merId": "8501088932494545",
        "transactionType": "01",
        "amount": "35.55",
        "realityAmount": "35.00",
        "fee": "1.00",
        "realityFee": "1.00",
        "successTime": "2024-04-29 08:44:26",
        "identifier": "706180220387407414",
        "stampTime": 1714380266000,
        "clave": "TP162841Rep1"
    }
}