Pagos en línea
El riel de tarjeta no presente — checkout alojado y ligas de pago, con tarjeta, SPEI y métodos alternativos.
El riel en línea (online_cnp) maneja los pagos con tarjeta no presente: el
pagador captura sus datos en una página web en lugar de acercar una tarjeta a
una terminal física. Acepta tarjetas y métodos de pago alternativos (SPEI,
efectivo en tiendas y más).
Hay dos formas de cobrar un pago en línea:
Checkout alojado
Crea una sesión desde tu servidor, redirige al pagador a una página alojada y cobra con tarjeta o métodos alternativos. Ideal para integrarlo en tu propia app.
Ligas de pago
Genera una liga alojada que el pagador abre y paga directamente. Ideal para cobros puntuales y para el flujo de dependencias de gobierno.
Métodos de pago soportados
Elige los métodos que se ofrecen en la página alojada con
payment_method_types. El conjunto disponible depende de lo que tenga
habilitado cada comercio:
| Método | Valor |
|---|---|
| Tarjeta | card |
| SPEI (transferencia bancaria) | spei |
| OXXO Pay (efectivo) | oxxopay |
| Mercado Pago | mercadopago |
| SafetyPay (efectivo) | safetypayCash |
Los montos van siempre en unidades mínimas (centavos).
amount_total: 49900 significa MXN 499.00.
Cómo se liquida un pago
Cada pago en línea se convierte en una fila de transactions con
rail: "online_cnp", enlazada a la sesión de checkout o a la liga de pago por su
correlation_id. Desde ahí fluye por el mismo libro mayor, la misma liquidación
y la misma bitácora que cualquier otro pago. Consulta el
ciclo de vida del pago para ver los estados
por los que pasa.
Errores
Cómo reporta fallas la API de Vecnet — la forma del error en JSON, los códigos de estado HTTP, las tarjetas rechazadas y los errores de base de datos.
Checkout alojado
Crea una sesión de checkout, redirige al pagador a la página alojada y conoce el resultado por webhook o consultando la sesión.