Make your first order

To offer customers maximum flexibility in integration and ensure consistent performance, the Runa API provides two execution modes: asynchronous and synchronous.

⚠️

Requests to create orders are rate limited:

API requests to create orders are subject to rate limiting. If the rate is exceeded, you'll get an HTTP 429 Too Many Requests response. Your API client code should be able to handle this response and retry the request after a short period.

Orders are currently limited to 60 per minute. This includes requests that fail due to errors. This rate limit may change in the future.

Synchronous

If your orders are small with one order per transaction, the synchronous mode would be better for you. It enables direct retrieval of payout links from the order response, streamlining integration into a single step.

Asynchronous

For larger orders involving multiple payout links, the recommended approach is asynchronous mode. This mode enables you to initiate the order first and then either poll an additional API endpoint for payout links or receive the payout links via a webhook, thereby creating a two-step integration process.

Which one is right for you?

Comprehensive guides are available to demonstrate the implementation of both execution modes. Whether you choose synchronous or asynchronous mode, integration remains simple and straightforward.