curl -X POST https://app.hurrypayments.com/api/orders \
-H "Content-Type: application/json" \
-d '{
"externalId": "CART-abc123-9f1e",
"shopUrl": "mitienda.com",
"currency": "EUR",
"sourceUrl": "https://mitienda.com/cart",
"items": [
{
"productId": "p1",
"name": "Camiseta",
"unitAmount": 2500,
"quantity": 2,
"imageUrl": "https://mitienda.com/img/camiseta.jpg"
}
]
}'
const res = await fetch("https://app.hurrypayments.com/api/orders", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
externalId: "CART-abc123-9f1e",
shopUrl: "mitienda.com",
currency: "EUR",
items: [
{ productId: "p1", name: "Camiseta", unitAmount: 2500, quantity: 2 }
]
})
});
const data = await res.json();
if (data.redirectUrl) {
window.location.href = data.redirectUrl;
} else {
// No se pudo crear el checkout: muestra un error o vuelve al carrito
}
{
"redirectUrl": "https://app.hurrypayments.com/checkout/detail/v2?orderId=8f3c2a91-...",
"orderId": "8f3c2a91-..."
}
{
"redirectUrl": null,
"orderId": null
}
API
Crear un checkout
Crea un pedido en Hurry y obtén la URL del checkout a la que redirigir al comprador.
curl -X POST https://app.hurrypayments.com/api/orders \
-H "Content-Type: application/json" \
-d '{
"externalId": "CART-abc123-9f1e",
"shopUrl": "mitienda.com",
"currency": "EUR",
"sourceUrl": "https://mitienda.com/cart",
"items": [
{
"productId": "p1",
"name": "Camiseta",
"unitAmount": 2500,
"quantity": 2,
"imageUrl": "https://mitienda.com/img/camiseta.jpg"
}
]
}'
const res = await fetch("https://app.hurrypayments.com/api/orders", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
externalId: "CART-abc123-9f1e",
shopUrl: "mitienda.com",
currency: "EUR",
items: [
{ productId: "p1", name: "Camiseta", unitAmount: 2500, quantity: 2 }
]
})
});
const data = await res.json();
if (data.redirectUrl) {
window.location.href = data.redirectUrl;
} else {
// No se pudo crear el checkout: muestra un error o vuelve al carrito
}
{
"redirectUrl": "https://app.hurrypayments.com/checkout/detail/v2?orderId=8f3c2a91-...",
"orderId": "8f3c2a91-..."
}
{
"redirectUrl": null,
"orderId": null
}
Este endpoint crea un pedido, elige la pasarela de cobro de tu tienda y te devuelve la URL del checkout. Tu web solo tiene que redirigir al comprador a esa URL.
En tiendas multimoneda, el importe se convierte de
- Autenticación: no hace falta. La tienda se identifica por
shopUrl. - Importes: en céntimos (la unidad mínima de la moneda).
2500son 25,00 €.
Los errores se devuelven como HTTP 200 con
redirectUrl: null. No basta con mirar el código HTTP: comprueba siempre que redirectUrl venga informado antes de redirigir.Cuerpo de la petición
string
requerido
Id del carrito o del pedido en tu sistema. Hace que la llamada sea idempotente: si la repites con el mismo valor, recibes el mismo pedido. Consulta Idempotencia.
string
requerido
URL de la tienda tal como está dada de alta en Hurry. Tiene que coincidir exactamente, carácter a carácter, con una tienda activa. Si falta o no coincide, no se crea el pedido.
Item[]
requerido
Líneas del carrito. No puede estar vacío.
Mostrar propiedades de Item
Mostrar propiedades de Item
string
requerido
Nombre del producto.
integer
requerido
Precio unitario en céntimos.
integer
requerido
Unidades.
integer
Impuesto total de la línea en céntimos. No se multiplica por
quantity.string
Id del producto en tu sistema.
string
SKU del producto.
string
Imagen del producto que se muestra en el checkout.
string
predeterminado:"USD"
Moneda del cobro, en formato ISO 4217 (
EUR, USD…).string
Moneda que se muestra al comprador. Solo es necesaria en tiendas multimoneda.
string
Opción de envío de la tienda. Si no la envías, se usa la primera opción activa.
string
URL de la página donde estaba el comprador. Se usa como
event_source_url en los eventos de servidor de los píxeles.string
Notas del pedido.
string
Logo del checkout. Solo se usa si la tienda no tiene uno configurado.
Señales de seguimiento
Todas son opcionales. Envíalas para que los eventos de servidor de tus píxeles atribuyan bien la venta.string
Cookie
_fbc de Meta.string
Cookie
_fbp de Meta.string
Id de visitante (
hy_vid). Es el mismo external_id que manda el píxel desde el navegador.string
Click ID de TikTok.
string
Cookie
_ttp de TikTok.string
Click ID de Google Ads (
gclid, gcl_au o gcl_aw).string
Click ID de Pinterest (cookie
_epik).No hace falta enviar la IP ni el User-Agent del comprador: Hurry los toma de la propia petición. Los IDs de los píxeles y la opción de mostrar tus propios términos se leen de la configuración de la tienda.
Respuesta
string | null
URL del checkout a la que debes redirigir al comprador. Es
null si no se ha podido crear el pedido.string
Id del pedido en Hurry.
string
Pasarela usada (
STRIPE, SHOPIFY…). Solo aparece con algunas pasarelas, como Shopify Payments.string
Estado del pago:
pending, paid, cancelled, refunded o fulfilled. Solo aparece con algunas pasarelas.string
Igual que
redirectUrl. Solo aparece con algunas pasarelas.string
Id de la sesión de pago en Hurry. Solo aparece con algunas pasarelas.
string
Id de la sesión de pago en la pasarela. Solo aparece con algunas pasarelas.
Errores
La petición responde HTTP 200 conredirectUrl: null cuando:
shopUrlfalta, no existe o la tienda está desactivada.- La cuenta está suspendida.
- Los cobros están pausados porque se ha alcanzado el tope diario del balanceo por volumen. Se reanudan a las 00:00.
- La tienda no tiene ninguna pasarela de pago activa.
- El cuerpo no es válido, por ejemplo con
itemsvacío.
externalId.
Idempotencia
Si repites la llamada con el mismoexternalId (recarga de página, doble clic, reintento), recibes el mismo pedido mientras se pueda seguir cobrando por su pasarela.
Si esa pasarela ya no está disponible (la has desactivado o la tienda ya no la usa), Hurry crea un pedido nuevo enrutado con tu configuración actual. Las siguientes llamadas con el mismo externalId reciben ese pedido nuevo.
Cálculo del importe
Total
total = Σ (unitAmount × quantity) + Σ taxAmount + envío
showCurrency a currency con el tipo de cambio del día más el recargo que hayas configurado en la tienda.
Estados del pedido
| Estado | Cuándo |
|---|---|
PENDING | Al crearse el pedido. |
IN_PROGRESS | Cuando el comprador abre la página de checkout. |
curl -X POST https://app.hurrypayments.com/api/orders \
-H "Content-Type: application/json" \
-d '{
"externalId": "CART-abc123-9f1e",
"shopUrl": "mitienda.com",
"currency": "EUR",
"sourceUrl": "https://mitienda.com/cart",
"items": [
{
"productId": "p1",
"name": "Camiseta",
"unitAmount": 2500,
"quantity": 2,
"imageUrl": "https://mitienda.com/img/camiseta.jpg"
}
]
}'
const res = await fetch("https://app.hurrypayments.com/api/orders", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
externalId: "CART-abc123-9f1e",
shopUrl: "mitienda.com",
currency: "EUR",
items: [
{ productId: "p1", name: "Camiseta", unitAmount: 2500, quantity: 2 }
]
})
});
const data = await res.json();
if (data.redirectUrl) {
window.location.href = data.redirectUrl;
} else {
// No se pudo crear el checkout: muestra un error o vuelve al carrito
}
{
"redirectUrl": "https://app.hurrypayments.com/checkout/detail/v2?orderId=8f3c2a91-...",
"orderId": "8f3c2a91-..."
}
{
"redirectUrl": null,
"orderId": null
}