Referencia · Pedidos

Inicia el pago con tarjeta (Stripe)

POST/orders/{token}/pay

Para un pedido creado con la opción stripe (viaStripe: true): devuelve la URL de pago de Stripe a la que se redirige al comprador. El plazo para pagar es de 24 horas. Para reintentar, se vuelve a llamar con el mismo pedido: nunca se crea otro, y mientras la sesión siga abierta la respuesta es la misma url. La sesión queda fijada en el primer intento: un reintento con otro returnUrl devuelve la sesión ya creada, con la página de retorno original.

returnUrl es obligatorio. Stripe devuelve al comprador a esa URL con order=<publicToken> y status=success o status=cancelled agregados por el servidor, conservando los parámetros y el fragmento que ya tenía. Llegar a esa URL no prueba nada: la landing lee GET /orders/{token}. El pago lo confirma solo el webhook firmado de Stripe a Tiendy.

Rechazos propios: 400 RETURN_URL_INVALID, STRIPE_NOT_AVAILABLE, STRIPE_CURRENCY_NOT_SUPPORTED, STRIPE_AMOUNT_NOT_ALLOWED, STRIPE_REJECTED; 409 ORDER_NOT_PAYABLE (pagado, cancelado o con la sesión vencida) y ORDER_CHANGED (dos inicios simultáneos: reintentar); 503 SERVICE_UNAVAILABLE (Stripe no respondió: reintentar).

Un pedido que no se creó con la opción stripe responde 400 PAGOPAR_NOT_ACTIVE, porque Pagopar está retirado; su cuerpo se ignora.

Parámetros de ruta

tokentexto (uuid)requerido

publicToken del pedido. Un token de otra tienda responde 404.

Cuerpo

application/json, requerido.

returnUrltexto (uri)requerido

La página de la landing a la que Stripe devuelve al comprador. URL completa https, sin usuario ni contraseña, cuyo origen (esquema, host y puerto) es uno de los orígenes autorizados de la tienda, también con una clave sk_. http solo para localhost, 127.0.0.1 y [::1], si ese origen está registrado. Si no, 400 RETURN_URL_INVALID.

Máximo 2000 caracteres.

Respuestas

EstadoCódigoQué significa
200—

Sesión de pago creada, o la que ya estaba abierta.

400
  • INVALID_QUERY
  • INVALID_BODY
  • IDEMPOTENCY_KEY_REQUIRED
  • SHIPPING_METHOD_INACTIVE
  • SHIPPING_METHOD_REQUIRED
  • PAYMENT_METHOD_UNAVAILABLE
  • STRIPE_NOT_AVAILABLE
  • STRIPE_CURRENCY_NOT_SUPPORTED
  • STRIPE_AMOUNT_NOT_ALLOWED
  • STRIPE_REJECTED
  • RETURN_URL_INVALID
  • PAGOPAR_NOT_ACTIVE
  • PAGOPAR_REJECTED
  • FILE_INVALID

Solicitud rechazada. Con code: INVALID_QUERY (un parámetro de una lectura está fuera de rango o mal formado), INVALID_BODY (el cuerpo no es JSON o no respeta los tipos y formatos del contrato), IDEMPOTENCY_KEY_REQUIRED (ausente o mal formada), SHIPPING_METHOD_INACTIVE, SHIPPING_METHOD_REQUIRED, PAYMENT_METHOD_UNAVAILABLE (un método manual inactivo, un método estándar en una tienda con otro medio configurado, Stripe incluido, o viaStripe/viaPagopar con algo distinto de TARJETA sin método manual), STRIPE_NOT_AVAILABLE (la tienda no tiene el pago con tarjeta disponible), STRIPE_CURRENCY_NOT_SUPPORTED (la tienda no vende en guaraníes), STRIPE_AMOUNT_NOT_ALLOWED (el total supera el máximo por venta), STRIPE_REJECTED (Stripe no aceptó iniciar el pago), RETURN_URL_INVALID (returnUrl ausente o que no es una URL https de un origen autorizado), PAGOPAR_NOT_ACTIVE (Pagopar está retirado: es lo que responde todo intento de usarlo), PAGOPAR_REJECTED (sin uso hoy), FILE_INVALID (sin archivo, tipo no permitido o contenido que no coincide). Muchos rechazos del checkout (datos del comprador, ciudad, cupón, líneas) solo traen message.

401
  • API_KEY_INVALID

Clave ausente, inválida o revocada: API_KEY_INVALID.

403
  • STOREFRONT_API_PLAN_REQUIRED
  • ORIGIN_NOT_ALLOWED
  • SECRET_KEY_IN_BROWSER
  • STORE_INACTIVE
  • ALTCHA_REQUIRED
  • ALTCHA_INVALID
  • ALTCHA_EXPIRED
  • ALTCHA_REPLAY

STOREFRONT_API_PLAN_REQUIRED (la tienda no está en el plan PRO; no aplica a GET /orders/{token} ni a GET /orders/by-payment-hash/{hash}), ORIGIN_NOT_ALLOWED, SECRET_KEY_IN_BROWSER, STORE_INACTIVE (tienda pausada o archivada; solo catálogo, cotización y checkout), o en el checkout ALTCHA_REQUIRED, ALTCHA_INVALID, ALTCHA_EXPIRED, ALTCHA_REPLAY.

404
  • ORDER_NOT_FOUND
  • PRODUCT_NOT_FOUND
  • ALTCHA_NOT_CONFIGURED

No existe o es de otra tienda: la respuesta es la misma en ambos casos. Códigos: ORDER_NOT_FOUND, PRODUCT_NOT_FOUND, ALTCHA_NOT_CONFIGURED.

409
  • INSUFFICIENT_STOCK
  • IDEMPOTENCY_KEY_REUSED
  • IDEMPOTENCY_IN_PROGRESS
  • ORDER_NOT_PAYABLE
  • ORDER_CHANGED
  • PROOF_NOT_ALLOWED
  • PROOF_ORDER_CANCELLED
  • PROOF_ALREADY_UPLOADED

INSUFFICIENT_STOCK (con details), IDEMPOTENCY_KEY_REUSED, IDEMPOTENCY_IN_PROGRESS (el intento concurrente con esa clave no terminó a tiempo; reintentar), ORDER_NOT_PAYABLE, ORDER_CHANGED, PROOF_NOT_ALLOWED, PROOF_ORDER_CANCELLED, PROOF_ALREADY_UPLOADED. El tope de canjes de un cupón responde 409 solo con message.

429
  • RATE_LIMITED

RATE_LIMITED. Respetar Retry-After. Sin datos para servir, también en una lectura de catálogo degradada.

500—

Error del servidor. En el checkout se puede reintentar con la misma Idempotency-Key.

503
  • SERVICE_UNAVAILABLE

SERVICE_UNAVAILABLE: no se pudo verificar la clave o el plan de la tienda, o Stripe no respondió al iniciar un pago. No dice nada de la clave ni del plan: reintentar después de Retry-After.