Introducción

La API de Vecnet acepta pagos, concilia el movimiento de dinero y corre la liquidación sobre un libro mayor de partida doble. Una API, un libro mayor y una bitácora de auditoría, sin importar cómo se cobró un pago.

Los pagos viajan por dos rieles, y el mismo libro mayor, la misma trazabilidad y la misma lógica de liquidación aplican a cada pago:

• En línea: checkout alojado y ligas de pago con tarjeta no presente (riel online_cnp).
• Presencial: terminales con tarjeta presente en sucursales físicas (riel inperson_cp).

Todo es multi-tenant por comercio. Los operadores del panel trabajan a través de varios comercios; los usuarios de un comercio solo ven sus propios datos.

Qué puedes hacer

• Cobrar en línea: crea una sesión de checkout alojado o una liga de pago y deja que Vecnet cobre.
• Recibir pagos presenciales: las ventas con tarjeta presente de tus terminales se ingieren, se concilian y se atribuyen al comercio correcto automáticamente.
• Administrar objetos de dinero: transacciones, reglas de comisión, reserva rotativa, liquidaciones, disputas y cortes de saldo, cada uno como un recurso CRUD consistente.
• Suscribirte a webhooks: entérate en el momento en que un pago se aprueba, se rechaza, se reembolsa o se disputa.
• Leer una bitácora completa: cada petición a la API y cada evento de pago queda registrado, es consultable y está enlazado por identificadores de correlación.

URLs base

Las páginas alojadas (checkout y ligas de pago) viven en https://pagos.vecnet.io. Usa siempre la url exacta que devuelve la API; nunca construyas el host a mano.

Verificación de estado (sin autenticación):

curl https://staging-api.vecnet.io/health

De un vistazo

• JSON de entrada, JSON de salida. Las marcas de tiempo son ISO 8601, con una excepción: el objeto de sesión de checkout usa milisegundos desde época.
• IDs con prefijo identifican cada objeto, por ejemplo mrc_ (comercio), txn_ (transacción), cs_ (sesión de checkout), pl_ (liga de pago), trm_ (terminal) y key_ (llave de API).
• Las listas son un sobre con un arreglo data más count, limit y offset.
• Los errores son un objeto JSON con un solo campo error de texto.

{
  "error": "Merchant not found"
}

Siguientes pasos