Savings
Open a savings plan
POST
/savings/plansScope
savings:writeAuth Bearer keyIdempotentOpens a plan by moving the stated amount from your NGN balance. An Idempotency-Key is required — retrying with the same key returns the original plan instead of moving money twice. Test keys simulate the same lifecycle without touching balances.
Headers
Idempotency-KeystringrequiredRetrying with the same key and payload replays the original response.
Responses
201Savings plan
Errors
Errors use RFC 9457 problem details. Branch on code, and log request_id.
400Bad request401Unauthenticated403Forbidden409Idempotency conflict422Validation error429Rate limitedcURL
curl -X POST "https://business.boundlesspay.com/api/public/v1/savings/plans" \ -H "Authorization: Bearer $BOUNDLESS_API_KEY" \ -H "Idempotency-Key: $(uuidgen)"