Permånad Partner API (1.1.4)

Our REST API is a core building block of the LeaseCloud Platform. You can use it to create, retrieve and update orders from your sales or e-commerce platform. How to integrate LeaseCloud into your own product is completely up to you.

This API enables you to integrate Permånad services into your e-commerce or sales platform. With this API you can:

• Retrieve payment terms and tariffs.
• Calculate pricing for products and leasing duration including buyout cost and insurance cost.
• Create new orders.
• Retrieve information about a specific order.
• Retrieve all orders with information about their statuses, contract information, contract length and months to expiry.
• Update orders with your own unique internal order ID.

Rate limiting

This API enforces a rate limit of 100 requests per 5 minutes per IP.

Polling for order data updates

• Polling Frequency: Limit polling to once every 1 minutes per order. Frequent polling (e.g., every second) is discouraged as it may lead to rate-limiting or throttling.
• Retry on Failures: In case of a failed request, implement an exponential backoff strategy (e.g., wait 1 minute, then 2 minutes, etc.) to retry. Avoid immediate retries to prevent overwhelming the API.
• Rate-Limiting Awareness: Respect our rate-limiting policy of 100 requests per 5 minutes. Requests exceeding the limit will receive a 429 Too Many Requests response.

The API utilizes a secure bearer token authentication for access.

LeaseCloud supports ordering in Sweden, Denmark, Norway and Finland. You need a separate API key for each market that can be obtained from the LeaseCloud Dev team. We offer a Sandbox development environment for testing.

1. Create Order: Submit a new order request.
2. Monitor Order Status: Repeatedly query the “Get Order Details” endpoint until the status changes to “readyToShip”
3. Handle Declined Orders: If the order status is “declined” leasing cannot be offered to the customer for the specified amount. Information has been send to end customer.