Docs para vender regalos desde tu app.
El sandbox cubre gift pages, AI proofs, quotes y webhooks firmados. Producción no es autoservicio: se activa desde Kadolia cuando la app, el pago, el contenido, el proveedor y la ruta de produccion quedan aprobados.
El host de API para partners se entrega después de aprobación. Estas rutas v1 no son endpoints públicos autoservicio.
curl https://{approved-api-host}/v1/gift-pages \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"recipient": "Mia",
"occasion": "birthday",
"message": "Made this for your day.",
"product": "folded_card"
}'Endpoints principales
POST /v1/gift-pagesSandboxCrear página digital del receptor con foto, mensaje, ocasión y Gift Pass sin activar fulfillment físico.
POST /v1/rendersSandboxGenerar proof visible, assets AI y archivos print-ready cuando aplique, manteniendo revisión humana para producción.
POST /v1/quotesSandboxCotizar productos, shipping, SLA, taxes estimados, proveedor y readiness de la orden antes de permitir pago.
POST /v1/ordersProducción aprobadaEnviar orden live solo después de aprobación de app, pago confirmado, contenido validado, ruta de produccion aprobada y proveedor disponible.
POST /v1/webhooks/testPrueba firmadaProbar entrega de webhook firmado antes de activar producción o reconciliación de órdenes.
Eventos webhook
gift.createdrender.readyquote.acceptedorder.submittedorder.shippedorder.deliveredorder.failedGates de producción
Las llaves de prueba validan gift pages, renders, quotes y webhooks sin enviar fulfillment live.
Las órdenes live requieren app aprobada, pago válido, contenido aceptado y proveedor disponible.
Cada evento debe validarse con firma HMAC antes de actualizar estados internos.
La activación de producción bloquea rutas no aprobadas y exige cotización real antes de órdenes live.