Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ariellukezz/admision-web/llms.txt

Use this file to discover all available pages before exploring further.

The payment endpoints expose records from the banco_pagos table, which stores payment vouchers received from the university’s banking integration. You can query all payments associated with a given DNI or look up a specific payment by its bank sequence number. Both endpoints are public and require no authentication.
Payment data originates from an external bank API integration and is stored locally in the banco_pagos table. Only payments recorded after January 1, 2025 are returned. Earlier records are excluded by a hard-coded date filter applied at query time.

​
POST /api/get-pagos-banco

Returns all bank payment vouchers associated with a given applicant DNI. The DNI is extracted from bytes 8–15 (positions 8 to 8+8) of the num_doc field in the payments table using SUBSTRING(num_doc, 8, 8), which encodes additional bank metadata in the leading characters. Authentication: None.

​
Request Body

​
dni
string
required
The applicant’s 8-digit DNI number. The query matches against SUBSTRING(num_doc, 8, 8).

​
Example Request

curl -X POST https://your-domain.com/api/get-pagos-banco \
  -H "Content-Type: application/json" \
  -d '{"dni": "12345678"}'

​
Response — HTTP 200

{
  "estado": true,
  "datos": [
    {
      "secuencia": "000987654",
      "dni": "12345678",
      "concepto": "01",
      "imp_pag": "150.00",
      "fch_pag": "2025-02-20",
      "nom_cli": "JUAN QUISPE MAMANI",
      "estado": 0,
      "fecha_usado": null,
      "id_usuario": null,
      "id_proceso": 12,
      "proceso": "ADMISIÓN 2024-I JULIACA",
      "id_modalidad_proceso": 1
    }
  ]
}

​
Response Fields

​
estado
boolean
true when the query executed successfully.
​
datos
array
Array of payment voucher objects matching the given DNI.
​
secuencia
string
Unique bank transaction sequence number.
​
dni
string
Applicant DNI extracted from the bank document number field using SUBSTRING(num_doc, 8, 8).
​
concepto
string
Two-character payment concept code extracted from the concepto field using SUBSTRING(concepto, 7, 2).
​
imp_pag
string
Amount paid (as a decimal string).
​
fch_pag
string
Payment date in YYYY-MM-DD format.
​
nom_cli
string
Payer’s full name as recorded by the bank.
​
estado
integer
Payment usage status. 0 = unused (available), 1 = applied to a process.
​
fecha_usado
string | null
Date the voucher was applied to an admission process; null if unused.
​
id_usuario
integer | null
ID of the staff user who applied the voucher; null if unused.
​
id_proceso
integer | null
ID of the admission process the payment is assigned to; null if unassigned.
​
proceso
string | null
Name of the admission process from the joined procesos table.
​
id_modalidad_proceso
integer | null
Modality ID of the linked process.

​
POST /api/get-pagos-banco-secuencia

Returns the bank payment voucher that matches a specific bank sequence number. Returns an array with one element when found, or an empty array when no match exists. Authentication: None.

​
Request Body

​
secuencia
string
required
The bank sequence number of the payment voucher to look up (e.g., "000987654").

​
Example Request

curl -X POST https://your-domain.com/api/get-pagos-banco-secuencia \
  -H "Content-Type: application/json" \
  -d '{"secuencia": "000987654"}'

​
Response — HTTP 200

{
  "estado": true,
  "datos": [
    {
      "secuencia": "000987654",
      "dni": "12345678",
      "concepto": "01",
      "imp_pag": "150.00",
      "fch_pag": "2025-02-20",
      "nom_cli": "JUAN QUISPE MAMANI",
      "estado": 0,
      "fecha_usado": null,
      "id_usuario": null,
      "id_proceso": 12,
      "proceso": "ADMISIÓN 2024-I JULIACA",
      "id_modalidad_proceso": 1
    }
  ]
}
The response fields are identical to those described in POST /api/get-pagos-banco above.

​
Empty result

When no voucher matches the requested sequence number, datos is an empty array: 
{
  "estado": true,
  "datos": []
}
Use the sequence number lookup when the applicant presents a physical payment receipt. The sequence number is printed on bank deposit slips and uniquely identifies a single transaction regardless of DNI.

Build docs developers (and LLMs) love

Get started for freeTalk to us