Referencia · Pedidos
Inicia el pago con tarjeta (Stripe)
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)requeridopublicTokendel pedido. Un token de otra tienda responde 404.
Cuerpo
application/json, requerido.
returnUrltexto (uri)requeridoLa 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 clavesk_.httpsolo paralocalhost,127.0.0.1y[::1], si ese origen está registrado. Si no, 400RETURN_URL_INVALID.Máximo 2000 caracteres.
Respuestas
| Estado | Código | Qué significa |
|---|---|---|
| 200 | — | Sesión de pago creada, o la que ya estaba abierta. |
| 400 |
| Solicitud rechazada. Con |
| 401 |
| Clave ausente, inválida o revocada: |
| 403 |
|
|
| 404 |
| No existe o es de otra tienda: la respuesta es la misma en ambos casos. Códigos: |
| 409 |
|
|
| 429 |
|
|
| 500 | — | Error del servidor. En el checkout se puede reintentar con la misma |
| 503 |
|
|