# Glosario

<!-- Fuente: https://docs.efipay.co/glossary -->

---

- [Glosario](#glosario)
  - [Conceptos de pago](#conceptos)
  - [Modalidades de integración](#modalidades)
  - [Seguridad y autenticación](#seguridad)
  - [Redes y actores](#redes)
  - [Herramientas de Efipay](#herramientas)
  - [Suscripciones](#suscripciones)
  - [Abreviaturas](#abreviaturas)

Los términos que aparecen en esta documentación y en el panel, explicados sin dar por
sabido nada. Si algo aquí no coincide con lo que lees en otra página, esta es la
definición buena.

## Conceptos de pago [#conceptos]

**Transacción.** Un intento de pago. Tiene un estado, un monto, un medio de pago y un
resultado. Un mismo cobro puede tener varias transacciones si el cliente reintentó.

**Cobro (o *pago generado*).** Lo que creas antes de que exista una transacción: el monto
a cobrar, su descripción y sus opciones. En la API es un `payment_id`; en el panel, un
link o un QR.

**Autorización.** El emisor de la tarjeta aprueba la operación y compromete los fondos.
Devuelve un **código de autorización**, el número que hay que citar en cualquier
reclamación.

**Captura.** El paso que convierte una autorización en un cobro real. En una compra
normal ocurre junto con la autorización; en una
[reserva de cupo](/mit-pre-authorization) ocurre después, cuando
aplicas el cobro final.

**Reserva de cupo** *(pre-autorización, MIT)*. Retención de fondos sin cobrarlos, para
cobrar después el valor real. El caso clásico es un hotel: reserva el estimado y cobra el
consumo. Ver [reserva de cupo](/mit-pre-authorization).

**Anulación.** Cancelar una operación **el mismo día**, antes de que se liquide. El
dinero nunca sale de la cuenta del cliente.

**Reversión** *(refund)*. Devolver el dinero de una operación ya liquidada. Tarda en
reflejarse en el extracto del cliente.

**Contracargo** *(chargeback)*. El tarjetahabiente desconoce la operación ante su banco y
el banco retira el dinero. Se resuelve con evidencia, no por API.

**Cuenta virtual.** Tu saldo dentro de Efipay: ahí se acumula lo que cobras, y de ahí
salen las [transferencias](/transfers) a tu cuenta bancaria.

## Modalidades de integración [#modalidades]

**`redirect`** *(también «simple API»)*. Creas el cobro, recibes un `checkout_url` y
rediriges a tu cliente. Nosotros capturamos la tarjeta. **No necesitas certificación
PCI.**

**`api`** *(también «full API»)*. Capturas la tarjeta en tu propio checkout y nos envías
los datos. **Requiere certificación PCI DSS**, porque el número de tarjeta pasa por tu
servidor.

**Checkout.** La pantalla donde el cliente ingresa su medio de pago. Puede ser la nuestra
(`redirect`) o la tuya (`api`).

## Seguridad y autenticación [#seguridad]

**3D Secure** *(3DS)*. Autenticación del tarjetahabiente ante su banco antes de la
compra. Reduce el fraude y traslada la responsabilidad del contracargo al emisor. Puede
pedir un reto (una clave, una app) o resolverse sin fricción.

**ECI** *(Electronic Commerce Indicator)*. El código con el que 3DS reporta cómo salió la
autenticación. Los valores válidos en una reserva de cupo son `05`, `06` y `07`.

**CAVV / UCAF.** La prueba criptográfica de que la autenticación 3DS ocurrió. Visa la
llama CAVV, Mastercard la llama UCAF. Cada franquicia espera la suya en su propio campo.

**PCI DSS.** El estándar de seguridad de la industria de tarjetas. Si el número de
tarjeta pasa por tus servidores, te aplica.

**Tokenización.** Cambiar los datos de una tarjeta por un **token** reutilizable, para no
volver a pedirle la tarjeta a tu cliente. Ver
[Tokenizado](/tokenized).

**CVV.** El código de seguridad del reverso de la tarjeta. No se guarda nunca, ni por
nosotros ni por ti.

**BIN.** Los primeros seis dígitos de la tarjeta. Identifican al banco emisor y la
franquicia, y por eso sí se pueden guardar y mostrar.

## Redes y actores [#redes]

**Franquicia.** La marca de la tarjeta: Visa, Mastercard, American Express, Diners.

**Emisor.** El banco que le dio la tarjeta a tu cliente. Es quien aprueba o rechaza.

**Adquirente / red.** Quien procesa la operación del lado del comercio. En Colombia,
**Credibanco** y **Redeban**. En una respuesta lo verás en el campo `network`.

**Agregador.** Cuando Efipay procesa con su propia afiliación en lugar de una tuya. Es lo
normal salvo que tengas terminal propia.

**TRM.** La tasa de cambio oficial del día. Se usa para convertir a pesos un cobro en
dólares o euros.

**Gravamen** *(4×1000)*. El impuesto a los movimientos financieros que se descuenta al
transferir a tu banco.

## Herramientas de Efipay [#herramientas]

Aparecen como valores de `sourceTool` al
[listar transacciones](/transaction-list) y en tus reportes.

| Nombre | Qué es |
| - | - |
| **Cobra** | Link o QR para un pago único |
| **Cobra Plus** | Como Cobra, con un formulario propio y varias referencias |
| **Recauda** | Recaudo de facturas por referencia |
| **Recauda ERP** | Recaudo donde tu ERP expone las facturas. Ver [Conexión a ERP](/documentation-erp) |
| **SimpleApi** | Los pagos que generas por [API](/generate-transaction) |
| **Suscripción** | Cobros recurrentes. Ver [Suscripciones](/subscription) |
| **Reserva de cupo** | Retención de cupo. Ver [Reserva de cupo](/mit-pre-authorization) |

## Suscripciones [#suscripciones]

**Grupo** *(product)*. Agrupa planes relacionados. Opcional.

**Plan** *(price)*. Define cuánto y cada cuánto se cobra: precio, moneda, frecuencia,
prueba y gracia.

**Suscriptor** *(customer)*. Tu cliente, con sus datos de facturación.

**Suscripción.** La relación entre un suscriptor y un plan. Es lo que se cobra.

**Cupón.** Un descuento reutilizable, por porcentaje o por monto fijo, que aplicas a una
suscripción. Ver [Cupones](/coupons).

**Período de prueba** *(trial)*. Tiempo antes del primer cobro.

**Período de gracia.** Tiempo después del vencimiento en el que se sigue reintentando el
cobro antes de dar la suscripción por inactiva.

**Prorrateo.** El ajuste que se calcula al cambiar de plan a mitad del período: se cobra
la diferencia si subes, o queda a favor del cliente si bajas.

## Abreviaturas [#abreviaturas]

| Sigla | Significado |
| - | - |
| **MIT** | *Merchant Initiated Transaction*. En esta documentación, «reserva de cupo» |
| **trx** | Transacción |
| **PSE** | Pagos Seguros en Línea: débito desde cuenta bancaria |
| **Bre-B** | El sistema de pagos inmediatos del Banco de la República |
| **TRM** | Tasa Representativa del Mercado |
| **BIN** | *Bank Identification Number* |
| **ECI** | *Electronic Commerce Indicator* |
| **CAVV** | *Cardholder Authentication Verification Value* |
| **UCAF** | *Universal Cardholder Authentication Field* |
| **ERP** | El sistema de gestión de tu empresa |