Consulta de estado de liquidación

Dirección de solicitud

Nombre del entorno	URL
SandBox	POST http://8.130.9.219:8899/api/supefina/transactions/search-order
Producción	POST http://api.supefina.net/api/supefina/transactions/search-order

Parámetros de solicitud

Key	Value
Content-Type	application/json

Cuerpo de solicitud

Nombre de campo	Nombre del variable	Obligatorio	Tipo	Descripción	Ejemplo
merId	ID del comerciante	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	Código del país	Sí	String	Código del país Referencia: Tabla de diccionario - Código de país México: MEX	MEX
merOrderNo	Número de pedido del comerciante	Sí	String	Número de pedido del comerciante
supefinaOrderId	Número del pedido de Supefina	Sí	String	Número del pedido de Supefina
nonceStr	Cadena aleatoria	Sí	String	Cadena aleatoria La longitud no puede exceder 32 caracteres
sign	Firma	Sí	String	Firma Refenrencia específica: Algoritmo de firma

Ejemplo de solicitud

{
	"merId":"8201247036390625",
	"countryId":"COL",
	"merOrderNo":"123456",
	"supefinaOrderId":"20240423000201024a1d9915bb145",
	"sign":"R9d1Enp0XUS5YMwv0EP$blm9mWTWwyoB",
	"nonceStr":"123"
}

Parámetros de solicitud

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
multiple	Boolean	¿Hay múltiples datos? Sí: true No: false
target	Array	Matriz objetiva
settleStatus	String	Estado de liquidación 01：Liquidado 02：No liquidado
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	String	Monto del pedido
realityAmount	String	Monto recibido
fee	String	Comisión anticipada
realityFee	String	Comisión recibida
successTime	Date	Tiempo de éxito de la transacción
identifier	String	Identificador

Ejemplo de respuesta

{
    "code": 200,
    "msg": "success",
    "data": {
        "multiple": false,
        "target": [
            {
                "settleStatus": "00",
                "supefinaOrderId": "20240423000201024a1d9915bb145",
                "merOrderId": "123456",
                "merId": "8201247036390625",
                "transactionType": "02",
                "amount": "3001.00",
                "realityAmount": "3001.00",
                "fee": "304.10",
                "realityFee": "304.10",
                "successTime": "2024-04-24 01:21:17",
                "identifier": ""
            }
        ]
    }
}