Sync Quickstart
Create a subaccount and operate a payment on its behalf.
1. Create a subaccount
https://api.wajub.com/accountscurl https://api.wajub.com/accounts \
-H "Authorization: sk.xxxx" \
-d '{
"reference": "shop-amina",
"capabilities": ["read", "payments", "refunds"],
"pricing": { "percentage_fee": 2.5, "currency": "XAF" }
}'{
"status": "Created",
"code": 201,
"account": { "id": "acc_7Yh2Mp", "reference": "shop-amina", "status": "pending" }
}An account starts pending; it becomes active once onboarding completes (see
Onboarding).
2. Operate on its behalf
Send the X-Sync header alongside your platform API key to create a payment (or transfer)
attributed to that subaccount — the account's own pricing is applied automatically:
curl https://api.wajub.com/payments \
-H "Authorization: sk.xxxx" \
-H "X-Sync: acc_7Yh2Mp" \
-d '{ "amount": 10000, "currency": "XAF", "email": "client@example.com" }'Key and Sync account must be the same environment
The API key and the X-Sync account must both be live, or both be sandbox — mixing them returns a
403.
3. Track it
Listen for account.created, account.updated, account.payment_activated, and
account.payment_suspended (Webhooks) to follow a subaccount's
lifecycle.
Per-payment marketplace splitting
There is currently no per-payment array to split a single payment's proceeds across multiple
subaccounts inline — see Split payments for what's actually available
today (same-payer installment splitting via POST /payments/{id}/splits, a different feature).
Was this page helpful?