Order retention and cleanup

This page explains which orders are affected, when cleanup occurs, and how merchants should design their integrations accordingly.

Orders subject to cleanup

The following orders are eligible for automatic cleanup:

• Orders with status expired
• Orders with status canceled

Orders in any other status are not affected.

Retention period

Expired and canceled orders are retained for a minimum of 60 days after reaching their terminal status.

After this period, they may be permanently removed from the system.

Cleanup behavior

• Cleanup is performed automatically by the system
• Deleted orders cannot be recovered
• Associated payment records may be retained for accounting and audit purposes
• Cleanup does not emit order events or webhooks

What this means for merchants

Merchants should not rely on Orbi as a long-term archive for expired or canceled orders.

Recommended practices:

• Persist order data in your own system if long-term retention is required
• Consume order and payment events via webhooks
• Periodically reconcile orders before the retention period elapses

API behavior

• Requests to retrieve a purged order will return a 404 Not Found
• Listing endpoints will not include purged orders
• Cleanup timing is not guaranteed to occur immediately after the 60-day threshold

Important notes

• Active and paid orders are never purged by this process
• Cleanup policies may evolve over time as the platform grows