Consulta de depósitos

Servicio de consulta de información de depósitos recibidos.

Método GET

{URL_PAYOUTS}/v1/deposits/info?from=<from>&to=<to>&size=<size>&page=<page>&searcher=<searcher>

En las cabeceras debemos declarar la información obtenida previamente en el proceso de Inicio de sesión.

Cabeceras

{
    "Authorization": "eyJr[.....]M2My1h..."
}

Parámetros de entrada

Los parámetros “from” y “to” están relacionados. Si alguno de ellos es incorrecto o no se ingresa, se mostrarán por defecto las 24 horas del día actual. El rango de consulta está limitado a 7 días. Por ejemplo, “from” igual a “01/01/2025” y “to” igual a “13/01/2025” es incorrecto ya que excede el rango de 7 días, por lo tanto, se mostrarán las 24 horas por defecto. En cambio, “from” igual a “11/02/2025” y “to” igual a “16/02/2025” es correcto y mostrará la información de ese rango de fechas. El valor debe ser una cadena de texto con formato de fecha (DD/MM/YYYY**).** Parámetros opcionales.
Los parámetros “size” y “page” permiten consultar la información de los depósitos de manera organizada. El “page” indica la página consultada, mientras que el “size” indica el número de registros de la página, donde este último, está limitado a un máximo de 500 datos por solicitud. Los valores de ambos parámetros deben ser numéricos. Parámetros obligatorios.
El parámetro “searcher” permite realizar una búsqueda por los siguientes atributos de los depósitos: “reference”, “amount”, “user_account_id”, “user_account_token”, “beneficiary_account”, “payer_account” y “tracking_key”. El valor tiene que ser una cadena de texto. Parámetro opcional.

Parámetros de respuesta

Parámetro	Descripción
msg	Descripción de la operación.
total	Total de elementos de la consulta.
totalPages	Total de páginas de la consulta.
size	Indica el número de registros de la página.
page	Indica la página consultada.
tableInfo	Matriz (array) de elementos con todos los depósitos obtenidos en la consulta.

id	Identificador de la operación. Campo numérico.
status	Estatus de la operación. Campo de texto.
merchant_code	Código de comercio. Campo de texto.
merchant_currency	Código de moneda. Campo de texto.
user_account_token	Identificador de la cuenta de usuario. Campo de texto.
beneficiary_account	Cuenta beneficiaria. Campo de texto.
payer_rfc_curp	RFC/CURP del ordenante. Campo de texto.
payer_name	Nombre del ordenante. Campo de texto.
payer_account	Cuenta del ordenante. Campo de texto.
payer_institution	Institución financiera ordenante. Campo numérico.
operation_date	Fecha de la operación. Campo numérico.
amount	Monto de la operación. Campo numérico.
reference	Referencia numérica de la operación. Campo numérico.
tracking_key	Clave de rastreo. Campo de texto.
cep_url	URL de comprobante electrónico de pago. Campo de texto.
bank_name	Nombre del banco ordenante. Campo de texto.
confirmated_at	Fecha de confirmación de la operación en formato ISO. Campo de texto.

Ejemplo de respuesta (exitosa)

{
    "msg": "ok",
    "total": 10,
    "totalPages": 1,
    "size": 10,
    "page": 1,
    "tableInfo": [
        {
            "id": 21485534134,
            "status": "success",
            "merchant_code": "mx_etpay_tesored",
            "merchant_currency": "MXN",
            "user_account_token": "uugB4dVbYwKDF3ndl47c62GIOTD1PaHZ",
            "beneficiary_account": "703271043294421533",
            "payer_rfc_curp": "DEML0508186F11",
            "payer_name": "ARMANDO PELAEZ",
            "payer_account": "127583000000042345",
            "payer_institution": 40127,
            "operation_date": 20250919,
            "amount": 1230.45,
            "reference": 1809250,
            "tracking_key": "MBAN0100250730007227690089",
            "cep_url": "<https://www.banxico.org.mx/cep/go?i=90703&s=20221118&d=HSFkvgV%2FSv474%2FEvMZJxyzu8bc3Db5QxGBmOYNd0ErbSbuDUHgTAtoKkfuQ%2FbnLp%2Fx9F%2Fru4Q%2BExcp2coyqQel0P7qd3s1ynUUiuNXFxmtQ%3D>",
            "bank_name": "Banco Azteca",
            "confirmated_at": "2025-09-19T16:52:20.399Z"
        },
        {
            "id": 21485534133,
            "status": "success",
            "merchant_code": "mx_etpay_tesored",
            "merchant_currency": "MXN",
            "user_account_token": "uugB4dVbYwKDF3ndl47c62GIOTD1PaHZ",
            "beneficiary_account": "703271043294421533",
            "payer_rfc_curp": "DEML0508186F11",
            "payer_name": "ROCKY BALBOA",
            "payer_account": "127583000000042345",
            "payer_institution": 40127,
            "operation_date": 20250919,
            "amount": 1000,
            "reference": 1809250,
            "tracking_key": "MBAN0100250730007227690088",
            "cep_url": "<https://www.banxico.org.mx/cep/go?i=90703&s=20221118&d=HSFkvgV%2FSv474%2FEvMZJxyzu8bc3Db5QxGBmOYNd0ErbSbuDUHgTAtoKkfuQ%2FbnLp%2Fx9F%2Fru4Q%2BExcp2coyqQel0P7qd3s1ynUUiuNXFxmtQ%3D>",
            "bank_name": "Banco Azteca",
            "confirmated_at": "2025-09-19T16:48:54.478Z"
        },
        {
            "id": 21485534132,
            "status": "success",
            "merchant_code": "mx_etpay_tesored",
            "merchant_currency": "MXN",
            "user_account_token": "uugB4dVbYwKDF3ndl47c62GIOTD1PaHZ",
            "beneficiary_account": "703271043294421533",
            "payer_rfc_curp": "DEML0508186F11",
            "payer_name": "ROCKY BALBOA",
            "payer_account": "127583000000042345",
            "payer_institution": 40127,
            "operation_date": 20250919,
            "amount": 975,
            "reference": 1809250,
            "tracking_key": "MBAN0100250730007227690087",
            "cep_url": "<https://www.banxico.org.mx/cep/go?i=90703&s=20221118&d=HSFkvgV%2FSv474%2FEvMZJxyzu8bc3Db5QxGBmOYNd0ErbSbuDUHgTAtoKkfuQ%2FbnLp%2Fx9F%2Fru4Q%2BExcp2coyqQel0P7qd3s1ynUUiuNXFxmtQ%3D>",
            "bank_name": "Banco Azteca",
            "confirmated_at": "2025-09-19T16:48:33.577Z"
        },
        {
            "id": 21485534131,
            "status": "autorefund",
            "merchant_code": "mx_etpay_tesored",
            "merchant_currency": "MXN",
            "beneficiary_account": "703271043294421533",
            "payer_rfc_curp": "DEML0508186F10",
            "payer_name": "RAFAEL VILLASEÑOR",
            "payer_account": "127583000000042345",
            "payer_institution": 40014,
            "operation_date": 20250733,
            "amount": 970.89,
            "reference": 1809250,
            "tracking_key": "MBAN0100250730007227690087",
            "cep_url": "<https://www.banxico.org.mx/cep/go?i=90703&s=20221118&d=HSFkvgV%2FSv474%2FEvMZJxyzu8bc3Db5QxGBmOYNd0ErbSbuDUHgTAtoKkfuQ%2FbnLp%2Fx9F%2Fru4Q%2BExcp2coyqQel0P7qd3s1ynUUiuNXFxmtQ%3D>",
            "bank_name": "Santander",
            "confirmated_at": "2025-09-18T23:13:33.941Z"
        },
        {
            "id": 21485534130,
            "status": "autorefund",
            "merchant_code": "mx_etpay_tesored",
            "merchant_currency": "MXN",
            "beneficiary_account": "703271043294421533",
            "payer_rfc_curp": "DEML0508186F10",
            "payer_name": "DIANA MARROQUIN",
            "payer_account": "014580984674345876",
            "payer_institution": 40014,
            "operation_date": 20250733,
            "amount": 230,
            "reference": 1809250,
            "tracking_key": "MBAN0100250730007227690087",
            "cep_url": "<https://www.banxico.org.mx/cep/go?i=90703&s=20221118&d=HSFkvgV%2FSv474%2FEvMZJxyzu8bc3Db5QxGBmOYNd0ErbSbuDUHgTAtoKkfuQ%2FbnLp%2Fx9F%2Fru4Q%2BExcp2coyqQel0P7qd3s1ynUUiuNXFxmtQ%3D>",
            "bank_name": "Santander",
            "confirmated_at": "2025-09-18T18:20:40.660Z"
        }
    ]
}

Ejemplo de respuesta (error)

{
    "msg": "Algo salió mal. Si el error continúa, ponte en contacto con soporte"
}

Catálogo de errores

Código	Mensaje	Descripción
400	Hacen falta o son incorrectos los parámetros(params), revisa la documentación	Error en la validación de parámetros de entrada
401	Lo sentimos, algo salió mal. Si el error continúa, ponte en contacto con soporte	Credenciales de acceso invalidas
404	Algo salió mal. Si el error continúa, ponte en contacto con soporte	Parámetros incorrectos
500	Algo salió mal. Si el error continúa, ponte en contacto con soporte	Error inesperado