API

Documentación técnica

Aspectos generales del producto

Integra de forma ágil y segura los servicios de TelePagos a los sistemas de tu empresa.

Nuestra API está diseñada para automatizar operaciones financieras, permitiéndote emitir transferencias, consultar saldos, obtener comprobantes y generar medios de cobro digitales desde tus propias plataformas, con total trazabilidad y sin intervención manual.

Modo de uso

Para empezar a integrarte a nuestros servicios, podrás suscribirte a la API Telepagos Empresas.

Importante: Las credenciales a utilizar NO son las de la Plataforma Web ni las de la Billetera Virtual.
En la Plataforma Web, dentro de la sección API, podés gestionar tus credenciales.

  • El token de autenticación es un bearer token.
  • El token de autenticación debe enviarse a través de un valor de encabezado llamado "Authorization".
  • Los valores de la solicitud se pueden enviar como form-data o Json.
  • Los valores de respuesta se envían como Json.
Ambientes

En TelePagos ofrecemos 2 tipos de ambientes de trabajo.

Incorporá TelePagos

Para ingresar en la plataforma hacé click acá.
¿Aún no tenés cuenta? Creala acá.

Servicios

Accedé a endpoints específicos para ejecutar y gestionar operaciones clave: emisión de transferencias, consultas de saldo, obtención de comprobantes, generación de medios de cobro digitales y recepción de notificaciones automáticas.

Autenticación y generación de credenciales API

Genera un token de autenticación que permite acceder al resto de los endpoints de la API.
Se deben enviar "username" y "password" válidos.
El token devuelto tiene una fecha de expiración (expires_at) que debe ser tenida en cuenta para su renovación automática.
Este paso es obligatorio antes de cualquier otra operación.

Tipo: POST
Ruta: v2/auth/token
Token: NO

{
"username": string,
"password": string
}

{
"status": string,
"token": string,
"expires_at": number
}

{
"status": error,
"message": string
}

Operaciones de consulta de cuenta

Devuelve el saldo disponible (amount) de la cuenta asociada al token actual.
Es útil para verificar fondos antes de realizar transferencias o pagos.

Tipo: GET
Ruta: v2/account/balance
Token: SI

-

{
"status": string,
"amount": integer
}

{
"status": error,
"message": string
}

Devuelve el listado de tipos de operación disponibles para ser usados como filtros en la consulta de transacciones.
Incluye "id", "name" y "type" de cada operación.
Es útil para generar interfaces de filtrado dinámico.

Tipo: GET
Ruta: v2/account/transactions_filters
Token: SI

-

{
"status": "ok",
"operations": [
{
"id": string,
"name": string,
}
]
}

{
"status": error,
"message": string
}

Devuelve un listado de transacciones registradas dentro de un rango de fechas ("date_from" / "date_to").
Opcionalmente se puede filtrar por tipo de operación ("operation").
Retorna información detallada de cada transacción: "monto", "fecha", "titular", "CUIT", "CVU/CBU", "estado" y "punto de venta asociado".

Tipo: GET
Ruta: v2/account/transactions
Token: SI

{
"date_from": date (Y-m-d),
"date_to": date (Y-m-d),
"operation": string (Optional),
"paginate": 0-1 (Optional),
"page": 1 (Optional with paginate)
}

{
"status": "ok",
"transactions": [
{
"income": int,
"date": string,
"amount": string,
"operation": string,
"holder": string,
"cuit": string,
"cvu_cbu": string,
"status": string,
"sale_point_name": string
],
"number_of_results": int (only if paginated),
"page": int (only if paginated),
"pages": int (only if paginated),
"pagination": int (only if paginated)
}

{
"status": error,
"message": string
}

Operaciones de transferencias salientes

Devuelve un listado de los conceptos disponibles que pueden usarse para clasificar operaciones (por ej.:, pagos, cobros, transferencias).
Cada elemento incluye un identificador y su descripción.

Tipo: GET
Ruta: v2/payment/concepts
Token: SI

-

{
"status": string,
"concepts": array
}

{
"status": error,
"message": string
}

Permite obtener el comprobante de una transferencia realizada previamente.
Se debe indicar el identificador de la operación ("id") y el servicio devuelve un "voucher" en formato string.

Tipo: GET
Ruta: v2/payment/cashout/{id}
Token: SI

-

{
"status": string,
"voucher": string
}

{
"status": error,
"message": string
}

Genera una transferencia de fondos hacia un CVU o CBU destino.
Debe enviarse "cvu" o "alias" (no ambos), junto con "cuit", "amount", "concept", "description" y un "reference_id" único que no debe repetirse en otras transacciones.
Si se necesita reintentar o consultar el resultado, se deben usar siempre los mismos datos y el mismo "reference_id".

Tipo: POST
Ruta: v2/payment/cashout
Token: SI

{
"cvu": string,
"alias": string,
"cuit": string,
"amount": decimal,
"reference_id": string,
"concept": string,
"description": string
}

{
"status": string,
"id": integer
}

{
"status": error,
"message": string
}

Operaciones de transferencias entrantes

Devuelve información detallada sobre una acreditación recibida.
Incluye datos del comprador ("buyer"), CUIT, CVU, monto, concepto, descripción y estado actual de la operación.

Tipo: GET
Ruta: v2/payment/cashin/{id}
Token: SI

-

{
"status": string,
"buyer": [
"cuit": string,
"cvu": string
],
"amount": decimal,
"concept": string,
"description": string,
"transaction_id": number,
"qr_order_id": number,
"link_id": number
}

{
"status": error,
"message": string
}

Genera un código QR (como string codificado) para recibir pagos.
Se debe indicar "amount", "concept" y "description".
Devuelve un "qr_code" y un "qr_order_id" asociados.
Es útil para generar cobros presenciales simples.

Tipo: POST
Ruta: v2/payment/cashin/qr/generate
Token: SI

{
"amount": decimal,
"concept": string,
"description": string
}

{
"status": string,
"qr_code": string,
"qr_code_id": number
}

{
"status": error,
"message": string
}

Crea un link único de cobro.
Permite especificar "expiration_date", "amount", "multiple_use", "concept" y, opcionalmente, una "distribution" de montos entre varios CVUs.
Devuelve el "link" generado y su "link_id".
Ideal para compartir por redes o email.

Tipo: POST
Ruta: v2/payment/cashin/link/generate
Token: SI

{
"expiration_date": "Y-m-d H:m:s",
"amount": decimal,
"multiple_use": bool,
"concept": string,
"distribution": (opcional) [
{
"cvu": string,
"amount": decimal
}..
]
}

{
"status": "ok",
"link": string,
"link_id": number
}

{
"status": error,
"message": string
}

Genera un link para iniciar una transferencia desde otra cuenta hacia la cuenta del usuario.
Devuelve un "payment_link" que puede ser compartido o utilizado en flujos externos para facilitar el envío de fondos.

Tipo: POST
Ruta: v2/payment/cashin/transfer/generate
Token: SI

{
"cvu": string,
"cuit": string,
"amount": decimal,
"concept": string,
"description": string
}

{
"status": string,
"payment_link": string
}

{
"status": error,
"message": string
}

Operaciones de cobro y generación de QR

Devuelve el listado de puntos de venta registrados por el usuario.
Cada uno incluye "id", "name" y "status".
Es útil para administrar y mostrar los puntos de venta activos.

Tipo: GET
Ruta: v2/payment/cashin/qr/sale-point
Token: SI

-

{
"status": "ok",
"sale_points": [
{
"id": int,
"name": string,
"status": string
}
]
}

{
"status": error,
"message": string
}

Crea un nuevo punto de venta con el "name" indicado.
Devuelve el "sale_point_id" asignado.
Este punto de venta podrá usarse luego para generar QR o links asociados.

Tipo: POST
Ruta: v2/payment/cashin/qr/sale-point
Token: SI

{
"name": string
}

{
"status": "ok",
"sale_point_id": int
}

{
"status": error,
"message": string
}

Elimina un punto de venta existente enviando su "sale_point_id".
Una vez eliminado, deja de estar disponible para generar cobros o recibir pagos.

Tipo: DELETE
Ruta: v2/payment/cashin/qr/sale-point
Token: SI

{
"sale_point_id": int
}

{
"status": "ok"
}

{
"status": error,
"message": string
}

Devuelve el string de un QR estático asociado a un punto de venta ("sale_point_id").
Se puede indicar "type_amount" como "closed" (la persona que genera el QR define el importe) u "open" (la persona que escanea el QR define el importe).
Ideal para imprimir o mostrar en pantalla.

Tipo: GET
Ruta: v2/payment/cashin/qr/sale-point/static
Token: SI

{
"type_amount": "closed" | "open",
"sale_point_id": int
}

{
"status": "ok",
"qr_code": "string"
}

{
"status": error,
"message": string
}

Genera una orden de cobro asociada a un QR cerrado de un punto de venta específico ("sale_point_id").
Se debe enviar "amount", "concept" y "description".
Devuelve un "qr_order_id" para hacer el seguimiento de la operación.

Tipo: POST
Ruta: v2/payment/cashin/qr/static/order
Token: SI

{
"amount": decimal,
"concept": string,
"description": string,
"sale_point_id": int
}

{
"status": string,
"qr_code_id": number
}

{
"status": error,
"message": string
}

Descargar Documentación    Descargar Collection de Postman