Asynchronous installment plan creation with immediate draft response
7 days ago by ReadMe API
Summary
The POST /installment-plans endpoint now creates installment plans asynchronously, returning immediately with a DRAFT plan while finalization happens in the background.
Updated Endpoints
- POST /installment-plans
- Behavior changed: The endpoint now returns 201 Created immediately with the plan in
DRAFTstatus. - Heavy operations such as cancelling old plans, creating payment intents, and activating the plan are processed asynchronously.
- Clients should poll the resource to detect the plan's transition from
DRAFTtoSCHEDULED. - Introduced the
salt_idfield to support deduplication of requests; retries with the samesalt_idreturn the existing in-progress plan. - If
salt_idis omitted, it is derived from a SHA256 hash of sortedloan_ids. - API schema updated to include the optional
salt_idproperty.
- Behavior changed: The endpoint now returns 201 Created immediately with the plan in
No new or deleted endpoints in this release.
