Architecture
Overview
Syllecta Cloud exposes two public surfaces:
- Idempotency API –
/v1/recordstores payment or order state with automatic deduplication. - Webhook Gateway –
/v1/webhooks/:providerreceives provider notifications, validates them, and forwards normalized payloads to your backend.
Everything else (queueing, retries, storage, usage tracking) is handled inside Syllecta so you can focus on your business logic.
High-Level Diagram
Client Application ──> Syllecta Cloud (Idempotency API) ──> Client Backend Webhook Provider ──> Syllecta Cloud (Dedupe & Forward) ──> Client Backend
Core Behaviors
- Idempotent REST writes – Use
POST /v1/recordto check/lock andPUT /v1/recordto persist the result; retries reuse the cached record. - Tenant-aware authentication – API keys map each call to a tenant, plan, and usage limits without any extra plumbing.
- Webhook verification – Stripe, Shopify, PayPal/Braintree, GitHub, and generic HMAC payloads are validated before Syllecta forwards them to you.
- Automatic retries – Webhook deliveries are retried with exponential backoff until they succeed or exhaust the tenant’s policy.
What You Control
- Configure API keys and webhook secrets in Backoffice.
- Decide which fields to persist in
/v1/recordbodies. - Provide a callback URL where Syllecta should POST normalized webhook payloads.
Everything else (signature checking, dedupe, queueing, dashboards) is managed by Syllecta Cloud.