Glosario de pagos digitales
Conoce los términos de la industria de pagos dentro de nuestra documentación
Adobe Commerce (antes Magento)
Adobe Commerce es la evolución comercial de un sistema de código abierto Magento. Permite crear e-commerce medianas y grandes con gran flexibilidad, gestionar un catálogo, inventario, envíos, etc. La integración con Prontopaga a través de un plugin facilita el checkout, tokenización y el flujo completo de pago dentro del e-commerce.
Conoce más acerca de este plugin en el siguiente artículo.
Afiliación
Autorización del método de pago por parte de un usuario para que pueda ser utilizado de forma recurrente sin necesidad de ingresar sus credenciales nuevamente. En la integración de ProntoPaga con Yape, la afiliación permite al cliente registrar su cuenta Yape una vez, y luego la plataforma hace los cobros recurrentes de forma automática.
Este método es muy útil en comercios que usan modelos de suscripción, reduciendo la fricción de UX y mejorando la experiencia de usuario.
API
Conjunto de reglas, protocolos y endpoints que permiten que tu sistema de software se comunique con otro. En el sector de pagos, gracias a las APIs puedes generar operaciones como crear un cobro, consultar el estado de una transacción, iniciar un reembolso o programar un PayOut.
Se basa en estándares como JSON sobre HTTPS, lo que asegura interoperabilidad entre distintas plataformas.
Back-end
La capa del servidor que procesa la lógica de negocio y comunica el sistema del comercio con ProntoPaga.
Aquí se validan los webhooks, se gestionan las llaves secretas, se almacenan órdenes y se realiza la conciliación financiera. Es la parte "invisible" para el cliente final, pero crítica para la seguridad y el flujo de pagos.
Balance Disponible
Es el monto que realmente está listo para ser retirado por el comercio en ese momento. Se calcula restando al saldo neto el saldo diferido y el bloqueado. Representa la liquidez inmediata del comercio.
Balance (Wallet empresarial)
Billetera empresarial que muestra el balance total de tu comercio. Esto incluye saldos disponibles, diferidos y retenidos. Proporciona una visión completa de los montos disponibles en el Portal de servicios de Prontopaga. Para saber más, visita nuestro artículo.
Bearer Token
Es un tipo de credencial de seguridad utilizado en APIs. El cliente incluye este token para demostrar que tiene permiso de acceder al recurso solicitado.
A este tipo de credenciales suele llamárseles "al portador", pues quien posea el token puede usarlo sin restricciones, por lo que deben mantenerse en secreto y transmitirse únicamente por conexiones seguras (HTTPS).
Suelen tener caducidad alcances definidos, limitando qué operaciones puede ejecutar.
BeMovil
Plataforma ecuatoriana que permite realizar retiros de dinero en efectivo mediante una amplia red de puntos físicos autorizados. Funciona como un método alternativo para usuarios que no cuenta con cuenta bancaria. Es ideal para retiros rápidos sin depender del sistema bancario tradicional.
Para conocer más acerca de este método para PayIns (pagos) o PayOuts (retiros), visita nuestros artículos.
Body
Parte del mensaje HTTP que contiene los datos que envías en una petición (request) POST, PUT o GET. Normalmente va en formato JSON e incluye parámetros como monto, moneda, país o método de pago.
Los parámetros del body pueden ser de un tipo de dato distinto, como String, Number o Boolean. Toda la información que necesitas para crear tu petición, puedes encontarla en nuestra sección de API Reference.
Al momento de crearlos, debes asegurarte de que todos los parámetros estén incluidos dentro de su estructura para que la API procese la transacción.
CCI
Siglas de Código de Cuenta Interbancario utilizado en Perú. Se trata de un número único asignado a una cuenta bancaria que permite identificarla para transferencias. Para realizar un PayOut (retiro) instantáneo, el cliente debe ingresar los datos necesarios, en los que se incluye el CCI. Conoce más acerca de cómo funciona este método de retiro en el siguiente artículo.
Certificación
Proceso formal en donde se valida que una integración cumple todos los requisitos técnicos y de seguridad antes de pasar a producción. En muchos casos, esto incluye que se ejecuten casos de prueba (éxito, error, contracargo, etc.) y documentar resultados. Una vez aprobado, se otorgan credenciales de producción.
Changelog
Se trata de un registro cronológico de cambios en la API y la plataforma: nuevas funcionalidades, endpoints deprecados, mejoras de seguridad.
Si quieres conocer más acerca de los cambios que se han hecho en ProntoPaga, visita nuestra pestaña de Changelog.
Checkout
Es la interfaz lista para usarse que verán tus clientes finales para simplificar cobros. Puede ser una página redirigida o un modal embebido. Incluye métodos de pago, validaciones antifraude y cumplimiento PCI.
Reduce tiempo de integración y garantiza que la experiencia cumpla los estándares de calidad necesarios.
Códigos bancarios
Identificadores usados para determinar qué banco y a qué tipo de cuenta se envía un pago. Estos deben incluirse dentro del parámetro bankcode del body request al crear un nuevo PayIn (pago) o PayOut (retiro).
Cada país cuenta con sus propios códigos bancarios.
Código del país (ISO 3166-1 alpha-2)
Código estándar de dos letras para identificar países (por ejemplo: AR, BR y CL). Conoce más acerca de los códigos usados en ProntoPaga en el siguiente artículo.
Código de moneda (ISO 4217)
Código estándar de tres letras para identificar monedas (Por ejemplo: ARS, BRL y CLP). Conoce más acerca de los códigos usados en ProntoPaga en el siguiente artículo.
Colección de Postman
Archivo estructurado (generalmente en formato JSON) que agrupa un conjunto de peticiones a una API. Permite a desarrolladores probar, documentar y compartir endpoints de forma organizada. En el caso de ProntoPaga, nuestra colección de Postman incluye ejemplos listos de endpoints (crear un PayIn, consultar balances, iniciar un PayOut, etc.), con parámetros y credenciales de prueba, facilitando la integración y validación de flujos de pago sin necesidad de escribir código desde cero.
Conoce más acerca en el siguiente artículo.
Cybersource
Es una plataforma de procesamiento de pagos y gestión de fraude adquirida por Visa en 2010. Ofrece servicios de gateway, prevención de fraude, tokenización y orquestación global de medios de pago. Está orientada a comercios grandes y empresas multinacionales, con alcance en más de 190 países.
Dashboard
El Portal de servicios de ProntoPaga contiene un resumen en tiempo real de las transacciones de tu comercio, que incluye información como el monto en depósitos, monto en retiros o los principales métodos de pago, así como filtros por fecha, moneda y comercio. Conoce más sobre el módulo Dashboard en el siguiente artículo.
Datos de prueba
Credenciales, tarjetas o cuentas bancarias que permiten realizar simulaciones de flujos de PayIns (pagos) o PayOuts (retiro) sin necesidad de mover dinero real. En ProntoPaga, los datos de prueba son utilizados en el ambiente Sandbox.
Conoce los datos de prueba de PayIns (pagos) o PayOuts (retiro) en sus artículos correspondientes.
Decision Manager (DM)
Herramienta de prevención de fraude desarrollada por Cybersource (Visa). Funciona como un motor que evalúa cada transacción en tiempo real, aplicando reglas configurables y modelos de machine learning. Permite simular políticas con escenario, ajustar la tolerancia al riesgo y maximizar la tasa de aprobación reduciendo falsos positivos.
Demo
Aplicación o entorno de demostración que simula el flujo de pago real. Permite a comercios y desarrolladores visualizar la experiencia completa que verá el cliente final sin necesidad de escribir código. Suele acompañarse de ejemplos de credenciales y tarjetas de prueba.
Puedes encontrar nuestras demos de PayIns o PayOuts en los enlaces correspondientes.
Devoluciones
Reembolsos o reversos de fondos a un cliente o comercio cuando la transación debe ser revertida (pedido cancelado, error, contracargo, etc.). Las devoluciones dependen del método de pago o retiro utilizado, pues cada uno cuenta con sus propias políticas de devolución y tiempos disponibles para solicitarlas.
En ProntoPaga contamos con un endpoint para devoluciones disponible en el siguiente enlace.
Efectivo
Dentro de ProntoPaga, es un método de pago donde el usuario usa efectivo para realizar su pago en puntos físicos, haciendo que la transacción se refleje como PayIn en la plataforma.
Puedes conocer acerca de este método de pago en los siguientes artículos de Perú y Ecuador.
Endpoint
Es una URL concreta de la API que permite ejecutar una operación.
Ejemplo:
- https://sandbox.prontopaga.com/api/payment/new para crear un cobro.
- https://sandbox.prontopaga.com/api/balance para consultar saldos.
Cada endpoint define el tipo de HTTP (los más usados en ProntoPaga son POST, y GET), los parámetros requeridos y las respuestas posibles ( las más conocidas son la respuesta 200: exitosa y 400: rechazada).
Environments / Entornos
Se trata de espacios aislados en los que se ejecutan las pruebas y operaciones de pago. Los ambientes usados por ProntoPaga son:
- Sandbox, donde se simulan transacciones sin dinero real.
- Producción, donde fluyen los pagos reales.
Estos entornos suelen usar credenciales diferentes (como tu Bearer Token y secretKey dentro de ProntoPaga) y URLs separadas para evitar mezclar datos, permitiendo a los comercios desarrollar y probar flujos de pago completos antes de arriesgar dinero o exponer información sensible de clientes.
Firma
Mecanismo que asegura que los datos de una petición o notificación no fueron manipulados. Normalmente se genera un hash (ej. HMAC SHA256) con una clave secreta compartida. El comercio recalcula la firma y la compara con la recibida para validar la autenticidad del mensaje.
Si quieres conocer más acerca de las firmas, haz clic aquí.
Front-end
La capa visible para el usuario (ya sea una web o una aplicación). Aquí es donde se capturan datos, muestran formularios de pago o cajas de checkout.
Estos siempre se enfocan en la experiencia de usuario: tiempos de carga, validaciones claras y confianza visual.
iFrame
Elemento HTML que permite insertar contenido externo dentro de un sitio. En el sector de pagos, se usa para embeber formularios seguros (como el campo de tarjeta) de modo que los datos sensibles nunca toquen tu servidor, facilitando cumplir normativas de seguridad sin comprometer la experiencia de usuario.
Integración
Proceso de conectar tu aplicación, página web o sistema interno con un procesador de pagos o una orquestadora. Puede hacerse de distintas formas: APIs directas, SDKs (kits de desarrollo), iFrames que embeben formularios seguros, o plugins ya listos para plataformas de e-commerce. Una integración no solo habilita procesar cobros, sino también administrar contracargos, verificar identidades, emitir reembolsos y reconciliar balances.
La mayoría de estas características están presentes en ProntoPaga.
Marcas de tarjetas
Identificadores del tipo de tarjeta usada (VISA, Mastercard, American Express, etc.). En pasarelas de pago son utilizadas para determinar reglas, comisiones, compatibilidad, parámetros de tokenización o riesgo. En el checkout y tokenización, la marca puede influir en el proceso de autorización y en las comisiones.
One Click Payments
Método de pago que permite al usuario pagar con un solo clic, usando un medio de pago previamente afiliado (tarjeta, wallet, cuenta). En la integración de ProntoPaga con Yape, el cliente no necesita ingresar nuevamente sus datos: con su cuenta Yape afiliada puede completar la compra en un paso.
Conoce más sobre esta integración de ProntoPaga en el siguiente artículo.
Order number
Número de orden del PayIn (pago) que debe ser incluido dentro del parámetro order en el body request al momento de realizar una solicitud de pago. Es el identificador del pago a asociar y debe ser único y no repetitivo.
Paga con Tu Banco
Método de transferencia exclusivo de ProntoPaga vía enlace redirigido al banco del usuario para completar el pago o retiro, disponible en múltiples países. Este servicio está disponible en Chile.
Parámetros
Datos específicos que se envían en una solicitud API. Estos parámetros pueden incluirse en rutas de endpoints (/payments/) o en el body (JSON).
Los parámetros son aquellos que permiten personalizar el comportamiento de cada operación (y que, para un mismo endpoint, el resultado sea diferente cuando cambiamos los datos del parámetro).
PayIns
Se refiere al flujo de entrada de dinero, es decir, los cobros que tus usuarios o clientes hacen a tu comercio. Estos pueden provenir de múltiples métodos: tarjetas de crédito/débito, transferencias bancarias, billeteras digitales o pagos en efectivo a través de corresponsales. Todos estos métodos están disponibles en ProntoPaga.
Los PayIns cuentan con diferentes estados dentro de ProntoPaga, que son: new, created, success, canceled, rejected, pending y expired.
Conoce más acerca de los estados de PayIns en este artículo.
PayOuts
Son las salidas de dinero desde tu comercio hacia un tercero: proveedores, usuarios de un marketplace o la misma cuenta bancaria del comercio.
Funcionan como retiros programados y también pasan por estados (conoce más de los estados de PayOuts aquí). Los PayOuts suelen tener límites, validaciones contra la prevención de fraude y ventanas de liquidación. Un Payout puede agrupar múltiples PayIns menos comisiones y contracargos.
Conoce más acerca de los PayOuts en el siguiente artículo.
Pay4U
Funcionalidad exclusiva de ProntoPaga en Chile, Perú y Ecuador. Permite realizar pagos mediante transferencias bancarias utilizando fondos disponibles en el balance de cada comercio directamente a sus asociados.
Este servicio es útil para los clientes que están constituidos en un país y operan en otros, ya que recaudan fondos en los países de operación, pero deben pagar por un producto o servicio de distribuidores locales e internacionales de forma esporádica o recurrente.
Conoce más sobre este servicio de ProntoPaga en el siguiente artículo.
Pendiente por Retiro
Monto que el comercio ya solicitó retirar (PayOut iniciado) pero que aún no se ha liquidado en su cuenta bancaria. Este estado intermedio permite distinguir entre lo que está disponible y lo que ya está "en camino".
Pix
Sistema de pagos instantáneos de Brasil integrado en ProntoPaga, que permite PayIns y PayOuts en tiempo real. PIX fue creado y administrado por el Banco Central de Brasil, mediante el cual puedes realizar transacciones en tiempo real, tales como transacciones mediante el uso de códigos QR, claves PIX o transferencias directas.
PonleMas
Ponle Más es una plataforma y red de recargas y retiros en efectivo utilizada en Ecuador. Opera a través de una amplia red de tiendas físicas, donde los usuarios pueden recibir dinero en efectivo sin necesidad de una cuenta bancaria, utilizando un código de retiro generado por un comercio o plataforma de pagos.
Para conocer más acerca de este método para PayIns (pagos) o PayOuts (retiros), visita nuestros artículos.
Plugins
En ProntoPaga contamos con módulos listos para instalar en plataformas como WooCommerce, Shopify, Magento o VTEX que conectan tu comercio con nosotros. Esto reduce el tiempo de desarrollo y permiten a comercios sin equipo técnico integrar pagos de manera segura.
Puedes revisar nuestra sección de plugins para conocer cómo realizar la integración.
Portal de servicios
Se trata de una plataforma digital que actúa como centro de control para administrar todos los flujos de pagos, desde la integración técnica hasta el monitoreo. Cuenta con una serie de módulos que te permitirán gestionar toda tu operación.
En ProntoPaga contamos con un manual detallamos cada módulo del Portal de servicios.
PrestaShop
Plataforma de e-commerce de código abierto que permite crear y gestionar tiendas online con catálogo, módulos, extensiones, envíos y múltiples idiomas y monedas de forma flexible y personalizada.
En ProntoPaga integramos una solución de pagos diseñada específicamente para optimizar el proceso de cobro en tiendas PrestaShop. Conoce más sobre esta integración en el siguiente artículo.
Producción
Es el ambiente real donde fluyen los pagos con dinero verdadero. A diferencia del ambiente Sandbox, en Producción se procesan transacciones que impactan directamente en cuentas bancarias y balances de tu comercio.
En ProntoPaga, Producción requiere credenciales específicas (Bearer Token y SecretKey del ambiente), las cuales solo se entregan una vez completada la certificación técnica. En este entorno, se aplican todas las validaciones antifraude, ventanas de liquidación y políticas regulatorias, por lo que es crítico mantener las credenciales seguras y monitorear constantemente las transacciones.
Puntos físicos de pago / de retiros
Ubicaciones físicas (corresponsales) donde los usuarios pueden realizar pagos en efectivo o cobrar retiros.Si deseas saber más, este método es usado en:
QR
Código de barras bidimensional que almacena información y puede ser leído con una cámara. En pagos, los QR contienen instrucciones de pago: ya sea un enlace a un checkout, una orden de transferencia o un identificador único de transacción.
Es usado por su simplicidad y compatibilidad con billeteras (wallets) digitales.
Red activa / Western Union
Plataforma ecuatoriana que permite realizar retiros de dinero en efectivo mediante una amplia red de puntos físicos autorizados. Funciona como un método alternativo para usuarios que no cuenta con cuenta bancaria. Cuenta con más de 270 puntos de atención y 1100 locales franquciados en 226 ciudades y poblaciones de Ecuador.
Para conocer más acerca de este método para PayIns (pagos) o PayOuts (retiros), visita nuestros artículos.
Responses
Respuestas HTTP/JSON que da la API tras una solicitud (ej. Crear un nuevo pago, consulta de saldo, devolución, etc.). Contienen datos como el estado (success, error), códigos, identificadores o mensajes.
Los parámetros de cada body response depende del tipo de solicitud realizada, método utilizado y procesador. Conoce los tipos de respuesta que puede recibir tu comercio en la sección de API Reference de ProntoPaga.
Saldo Bloqueado
Fondos retenidos por situaciones especiales, como contracargos, disputas abiertas o revisiones de fraude. Estos montos permanecen inaccesibles hasta que la investigación concluya. El saldo bloqueado protege tanto al cliente como al comercio, evitando retiros que luego no podrían cubrir reembolsos.
Saldo Diferido
Es la porción del saldo que aún no puede retirarse porque está en periodo de espera. Normalmente corresponde a fondos que deben cumplir con reglas de liberación para reducir riesgos de contracargos o fraudes. Una vez cumplido ese tiempo, pasa al saldo disponible.
Saldo Neto
Es el saldo total del comercio dentro de la plataforma, sumando todo el dinero registrado (disponible, diferido y retenido), reflejando el total de lo que el comercio tiene, aunque no todo esté inmediatamente utilizable, ya que suelen incluirse pagos recién recibidos que aún no cumplen la ventana de liquidación y montos en disputa.
Sandbox
Se trata de un ambiente aislado de pruebas donde se pueden ejecutar transacciones ficticias con tarjetas de prueba y montos inventados. En ProntoPaga, nos permite probar integraciones, entrenar equipos de soporte y verificar lógicas de negocio sin ningún tipo de riesgo financiero.
SecretKey
Son credenciales secretas que identifican y autentican un sistema frente a la API del procesador de pagos. A diferencia de las llaves públicas, las secretKeys nunca deben exponerse en el front-end ni en código, ya que se usan para firmar solicitudes, crear cargos o programar retiros.
En ProntoPaga contarás con llaves para cada entorno (sandbox y producción). La llave de producción requiere que estés certificado por la administración de ProntoPaga. Una vez hecho, podrás usar los datos reales y en vivo.
Tipos de cuenta
En ProntoPaga existen diferentes tipos de cuenta, que varían según el país, por ejemplo: Una cuenta Corriente es de tipo 1 en Brasil, pero tipo C en Chile.
Conoce más acerca de los tipos de cuentas en el siguiente artículo.
Transacción
Es la unidad básica de movimiento de dinero. Puede ser un cobro (PayIn), un retiro (PayOut), un reembolso, un contracargo o incluso una pre-autorización. Cada transacción tiene un identificador único y estados que permiten su trazabilidad.
Además, para efectos contables, es el registro fundamental para conciliar balances y saldos.
VTEX
VTEX es una plataforma de comercio digital que permite a empresas crear y gestionar un e-commerce de forma escalable y flexible. Permite manejar catálogo, stock, pedidos, experiencias unificadas en web/móvil, y manejo de tienda personalizada.
En ProntoPaga desarrollamos un plugin optimizado para VTEX que mejora la experiencia de compra y garantiza transacciones seguras y rápidas. Conoce más sobre este plugin en el siguiente artículo.
Wallet
En el sector de pagos, el término puede referirse a dos cosas:
- Wallet del usuario: Aplicaciones como Apple Pay, Google Pay o billeteras propias que almacenan tarjetas tokenizadas y permiten pagar de forma rápida y segura.
- Wallet del comercio: Balance virtual que cuentan todos los comercios dentro de ProntoPaga, donde se acumulan los PayIns hasta que se ejecutan PayOuts. Este Wallet refleja saldos disponibles, diferidos y bloqueados.
Webhook
Mecanismo de notificación automática: cuando ocurre un evento en la plataforma (ejemplo: pago aprobado, contracargo iniciado, payout rechazado), ProntoPaga envía un mensaje POST a una URL configurada por el comercio. De esta forma, el sistema del comercio puede reaccionar en tiempo real (enviar confirmaciones, actualizar estados, liberar productos).
Para conocer más acerca de los webhooks, haz clic aquí.
WooCommerce
Plugin de e-commerce para WordPress que convierte un sitio WordPress en una tienda online. Además, al ser parte del ecosistema WordPress, permite usar plantillas, plugins, extensiones y adaptarlo de forma sencilla.
Para aceptar pagos, WooCommerce puede integrarse con ProntoPaga, permitiendo a tu tienda en línea aceptar pagos de forma segura, rápida y eficiente. Conoce más sobre este plugin en el siguiente artículo.
Yape On File
Mecanismo que permite almacenar (tokenizar) de forma segura la afiliación del cliente a Yape, de modo que el comercio pueda volver a cobrarle en el futuro sin pedirle que ingrese datos nuevamente. Esto permite pagos con un clic, cobros recurrentes y una tokenización segura.
Conoce más sobre la integración de ProntoPaga con Yape On File aquí.
Yape On File: One Click Payments
Modalidad donde el usuario afilia su cuenta Yape una sola vez, y a partir de ese momento puede realizar pagos instantáneos con un solo clic, sin volver a escanear QR ni abrir la aplicación.
Funciona mediante tokenización segura, donde Yape y ProntoPaga generan un token permanente que representa la afiliación del usuario. Ese token permite que el comercio inicie nuevos pagos con autorización inmediata.
Conoce más sobre la integración de ProntoPaga con Yape On File: One Click Payments aquí.
Yape On File: Recurrencia
Modalidad donde el usuario afilia su cuenta Yape para que el comercio pueda cobrarle automáticamente pagos repetitivos, sin que intervenga cada vez, equivalente a un modelo de suscripción.
Esta modalidad permite que el comercio programe cobros periódicos (semanales, mensuales, anuales). Todos se realizan usando el mismo token de afiliación, sin requerir que el usuario vuelva a aprobar el pago.
Conoce más sobre la integración de ProntoPaga con Yape On File: Recurrencia aquí.
Updated 6 days ago