Checkouts

Crear un checkout

Crea un checkout en borrador. Los productos incluidos y los de los bumps deben estar publicados y ser tuyos.

POST

/checkouts

Crear un checkout

curl --request POST \
  --url https://hub.grou.com/api/ext/checkouts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bonus_ids": [
    "6ab8c1f0a1b2c3d4e5f6f003"
  ],
  "bumps": [
    {
      "enabled": true,
      "price": 19,
      "product_id": "6ab8c1f0a1b2c3d4e5f6f002"
    }
  ],
  "commercial": {
    "base_currency": "USD",
    "pricing": [
      {
        "currency": "USD",
        "value": 149
      }
    ]
  },
  "design": {
    "thank_you": {
      "enabled": true,
      "title": "¡Gracias por tu compra!"
    }
  },
  "discount": {
    "amount": 99,
    "type": "fixed"
  },
  "external_ref": "mi-plataforma-oferta-42",
  "name": "Oferta Black Friday",
  "product_ids": [
    "6ab8c1f0a1b2c3d4e5f6f001"
  ],
  "slug": "black-friday"
}
'

{
  "checkout_url": null,
  "created_at": "2026-01-01T00:00:00.000Z",
  "external_ref": "mi-plataforma-oferta-42",
  "id": "6ab8c1f0a1b2c3d4e5f6c001",
  "state": "draft",
  "type": "checkout",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "version_id": null
}

Los productos que incluyas ya deben estar publicados.

curl -X POST https://hub.grou.com/api/ext/checkouts \
  -H "Authorization: Bearer $GROU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Oferta Black Friday",
    "slug": "black-friday",
    "product_ids": ["<id-del-programa>"],
    "commercial": { "base_currency": "USD", "pricing": [{ "currency": "USD", "value": 149 }] },
    "discount": { "type": "fixed", "amount": 99 }
  }'

Responde 422 si la coproducción no es válida o si el precio supera la suma de los productos incluidos. Para publicar necesita además slug, miniatura y un precio mayor a cero.

Autorizaciones

Authorizationstringheaderobligatorio

Tu API Key del Hub (Configuración → API Keys), que empieza por sk_. Solo se muestra una vez al generarla.

Cuerpo

bonus_idsstring[]

Productos de regalo.

bootcamp_idsstring[]

Talleres incluidos (publicados y tuyos).

bumpsobject[]

Productos adicionales que el comprador puede sumar.

Mostrar child attributes

commercialobject

Configuración comercial. Un producto vende o un pago único (precio y cuotas opcionales) o planes de suscripción, no ambos. La tasa de interés de las cuotas se configura en el Hub y se conserva al editar.

Mostrar child attributes

coproductionobject[]

Reparto de la coproducción. Incluye tu propio owner_user_id (de GET /me); los porcentajes deben sumar 100.

Mostrar child attributes

designobject

Solo la página de agradecimiento. Las imágenes se suben con POST /checkouts/{id}/images; una URL de imagen aquí devuelve 400.

Mostrar child attributes

discountobject

fixed: amount es el precio total a pagar en la moneda base (no un monto a restar). percentage: descuento porcentual.

Mostrar child attributes

external_refstring

Minimum string length: 1

namestringobligatorio

Nombre interno del checkout.

Required string length: 1 - 120

product_idsstring[]

Programas y programas externos incluidos (publicados y tuyos).

slugstring

Final del link de pago (/c/{slug}). Único. Requerido para publicar.

Respuesta

Borrador creado.

checkout_urlstring | nullobligatorio

Link de pago. Solo cuando el recurso está published.

created_atstringobligatorio

external_refstring | null

Tu identificador, si lo enviaste al crear.

idstringobligatorio

stateenum<string>obligatorio

draft: borrador, no visible para compradores. published: a la venta, con checkout_url. unpublished: retirado de la venta, se puede volver a publicar.

Opciones disponibles: draft, published, unpublished

typeenum<string>obligatorio

Opciones disponibles: program, external, workshop, checkout

updated_atstringobligatorio

version_idstring | null

Versión actual. Siempre null en checkouts.

¿Aún necesitas ayuda? Comparte una idea