Saltar al contenido
Carritos y checkoutCarritos

Abrir una sesión de pago

Abre la sesión de pago del método elegido con el total del carrito. Niubiz la necesita antes de mostrar sus campos de tarjeta. Envía su id en paymentSessionId al pagar; cada intento necesita una sesión nueva.

POST/v1/carts/{cartToken}/payment-session
Sin token

Parámetros de ruta

cartToken*string

Token que identifica el carrito.

Parámetros de cabecera

x-Store-Domain*string

Slug de la tienda o uno de sus dominios configurados, como my-store.

Longitud1 <= length <= 253
X-Customer-Session?string

Sesión del cliente creada con POST /v1/customer/sessions. Vincula el carrito al cliente, con sus precios y códigos asignados.

Cuerpo de la solicitud

application/json

Definiciones TypeScript

Usa esta definición en TypeScript.

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://storefront.ecomiq.pe/v1/carts/replace_with_the_issued_token/payment-session" \  -H "x-Store-Domain: my-store" \  -H "X-Customer-Session: <session-id>" \  -H "Content-Type: application/json" \  -d '{    "paymentMethodCode": "POL-001"  }'
{  "id": "7204558912004324239",  "key": "color",  "amount": 178,  "currency": "PEN",  "expiresAt": "2026-09-28T15:30:00Z"}