Integration (v1)

This endpoint return balance of your credit to register new order

This endpoint return list of all products (Category filters can be included)

This endpoint return details and price of a specific product

This endpoint return list of all product categories

This endpoint create a return request for a specified take request (report issue on a purchase)

This endpoint create a warning return request for a specified take request (like as normal return request endpoint, but fast and without description)

This endpoint add a reply in a specified return request

This endpoint start mediation in a specified return request

This endpoint close a specified return request

This endpoint return detials of a specified return request

This endpoint creates an order to activate a subscription product.
It is idempotent based on the tuple (ReferenceId, ProductId, Identities): if an order already exists for the same tuple, the previously created order is returned.

Notes:

• If there is not enough credit, the response will be Status = 400 with a message from the order service.
• When a previous order exists for the same tuple, that order’s payload is returned with its original HTTP status.

API Guide - Create Subscription Activation -> API-guide-create-subscription-activation.pdf

Request example { "referenceId": "ACT-2025-000123", "productId": "8f1b7f3e-0e47-4a1f-8e4a-9a7d3f1b2c55", "identities": { "username": "my_username" } } Successful response (200) { "orderId": "3f2d9f0e-1a44-47b5-9d8f-8c7e4b2a1c00", "orderNumber": "24091542", "status": 200, "message": "Subscription activation created successfully" } Validation / business error (400) { "status": 400, "message": "This product is not a subscription." } Existing order returned (idempotent hit) { "orderId": "3f2d9f0e-1a44-47b5-9d8f-8c7e4b2a1c00", "orderNumber": "24091542", "status": 200, "message": "Subscription activation created successfully" } Possible 400 messages:Payload is null.Input validation error returned by rules (e.g., missing identity keys).This product is not a subscription.eligible seller not found.Order service message (e.g., not enough credit).

This endpoint return validation result of a specified user identity.

This endpoint register a new take request (In case of adjustment of stock supply, this is considered as a new purchase)

This endpoint return details of a specified take request.

Decryption Details for EncryptedVirtualCollections -> decryption-details.pdf

This endpoint cancel a specified take request (before supply)