Docs para vender regalos desde tu app.
El entorno de pruebas cubre páginas de regalo, pruebas con IA, cotizaciones y webhooks firmados. Producción no es autoservicio: Kadolia la activa solo cuando la app, el pago, el contenido, el proveedor y la ruta de producción quedan aprobados.
Kadolia entrega el host de API para partners después de la aprobación. Estas rutas v1 no son endpoints públicos de 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-pagesEntorno de pruebasCrear la página digital de quien recibe el regalo con foto, mensaje, ocasión y Gift Pass sin activar la producción física.
POST /v1/rendersEntorno de pruebasGenerar una prueba visible, recursos con IA y archivos listos para impresión cuando aplique, manteniendo revisión humana para producción.
POST /v1/quotesEntorno de pruebasCotizar productos, envío, SLA, impuestos estimados, proveedor y preparación del pedido antes de permitir el pago.
POST /v1/ordersProducción aprobadaEnviar un pedido en vivo solo después de la aprobación de la app, el pago confirmado, el contenido validado, la ruta de producción aprobada y el proveedor disponible.
POST /v1/webhooks/testPrueba firmadaProbar la entrega de un webhook firmado antes de activar producción o reconciliación de pedidos.
Eventos webhook
gift.createdrender.readyquote.acceptedorder.submittedorder.shippedorder.deliveredorder.failedCondiciones de producción
Las claves de prueba validan páginas de regalo, renderizados, cotizaciones y webhooks sin enviar pedidos en vivo.
Las órdenes en vivo requieren la app aprobada, pago válido, contenido aceptado y proveedor disponible.
Cada evento debe validarse con firma HMAC antes de actualizar los estados internos.
La activación de producción bloquea rutas no aprobadas y exige una cotización real antes de las órdenes en vivo.