Consulta de comprobante

Dirección de solicitud

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

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
supefinaOrderId	Sí	String	Número del pedido de Supefina
nonceStr	Sí	String	Cadena aleatoria La longitud no puede exceder 32 caracteres
sign	Sí	String	Firma Refenrencia específica: Algoritmo de firma

Ejemplo de solicitud

{
    "merId":"8501088932494545",
    "countryId":"MEX",
    "merOrderNo":"luo001",
    "supefinaOrderId":"",
    "sign":"R9d1Enp0XUS5YMwv0EP$blm9mWTWwyoB",
    "nonceStr":"202404111"
}

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
voucher	String	Enlace del comprobante Uno o múltiples

Ejemplo de respuesta

{
    "code": 200,
    "msg": "success",
    "data": {
        "multiple": true,
        "target": [
            {
                "voucher": "https://supefina-official.s3.us-west-2.amazonaws.com/PaymentVoucher-dev/20240429/CEP2024042903020091607b0dee5a44d.pdf"
            },
            {
                "voucher": "https://supefina-official.s3.us-west-2.amazonaws.com/PaymentVoucher-dev/20240429/CEP2024042903020092c2c0482413240.pdf"
            },
            {
                "voucher": "https://supefina-official.s3.us-west-2.amazonaws.com/PaymentVoucher-dev/20240429/CEP2024042903020095ff4592a799048.pdf"
            },
            {
                "voucher": "https://supefina-official.s3.us-west-2.amazonaws.com/PaymentVoucher-dev/20240429/CEP20240429030200971c3b543215940.pdf"
            },
            {
                "voucher": "https://supefina-official.s3.us-west-2.amazonaws.com/PaymentVoucher-dev/20240429/CEP202404290302009864b0e718d7249.pdf"
            },
            {
                "voucher": "https://supefina-official.s3.us-west-2.amazonaws.com/PaymentVoucher-dev/20240429/CEP202404290302009ea51a814a15e4f.pdf"
            }
        ]
    }
}