Crear una sesión de checkout
Crea una sesión de checkout alojado y devuelve la url a la que debes redirigir al pagador. Autentica con tu llave de API (Authorization: Token <llave> o X-API-Key). Los montos van en centavos; return_url es obligatorio salvo que envíes success_url.
Llave de API del comercio: Authorization: Token <vk_…>.
In: header
Cuerpo de la petición
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Cuerpo de la respuesta
application/json
application/json
application/json
curl -X POST "https://example.com/checkout/v1/sessions" \ -H "Content-Type: application/json" \ -d '{ "customer": {}, "amount_total": 25000, "currency": "MXN", "line_items": [ {} ] }'{
"id": "cs_…",
"url": "https://pagos.vecnet.io/checkout/cs_…",
"status": "pending",
"payment_id": 0,
"amount_total": 0,
"currency": "string",
"external_id": "string",
"session_type": "payment",
"checkout_type": "hosted",
"return_url": "string",
"metadata": {},
"payment_method_types": [
"string"
],
"ui_config": {},
"ui_config_version": "V1",
"created_at": 0,
"modified_at": 0,
"customer": {
"first_name": "string",
"last_name": "string",
"email": "user@example.com"
},
"line_items": [
{
"name": "string",
"quantity": 0,
"unit_price": 0,
"product_id": "string"
}
],
"transaction_status": "Pending"
}{
"error": "string"
}{
"error": "string"
}Referencia API
URLs base, autenticación y las convenciones centrales de la API de Vecnet — con páginas interactivas por endpoint generadas desde la especificación OpenAPI.
Consultar una sesión de checkout
Devuelve la sesión y su status (pending, completed, expired o cancelled). created_at y modified_at son milisegundos desde época.