Glosario

• Glosario
  • Conceptos de pago
  • Modalidades de integración
  • Seguridad y autenticación
  • Redes y actores
  • Herramientas de Efipay
  • Suscripciones
  • 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

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 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.

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 a tu cuenta bancaria.

Modalidades de integración

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

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.

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

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

Aparecen como valores de sourceTool al listar transacciones y en tus reportes.

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.

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