Kadolia
ENES

Docs for selling gifts inside your app.

The sandbox covers gift pages, AI proofs, quotes and signed webhooks. Production is not self-serve: Kadolia enables it only after app, payment, content, provider and production-route approval.

View pricingRequest access
Approved-access example

Kadolia issues the partner API host after approval. These v1 routes are not public self-serve endpoints.

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"
  }'

Core endpoints

POST /v1/gift-pagesSandbox

Create the recipient page with photo, message, occasion and Gift Pass without enabling physical fulfillment.

POST /v1/rendersSandbox

Generate visible proofs, AI assets and print-ready files when applicable while keeping production under human review.

POST /v1/quotesSandbox

Quote products, shipping, SLA, estimated taxes, provider availability and order readiness before payment is allowed.

POST /v1/ordersProduction gated

Submit a live order only after app approval, confirmed payment, content validation, approved production route and provider availability.

POST /v1/webhooks/testSigned test

Test signed webhook delivery before production or order reconciliation is activated.

Webhook events

gift.createdrender.readyquote.acceptedorder.submittedorder.shippedorder.deliveredorder.failed

Production gates

Sandbox first

Test keys validate gift pages, renders, quotes and webhooks without live fulfillment.

Approved production

Live orders require app approval, valid payment, accepted content and provider availability.

Signed webhooks

Every event must be verified with an HMAC signature before updating internal state.

Production approval

Production activation blocks unapproved routes and requires a real quote before live orders.