Instant Entity Notifications (IEN) is a message service that automatically notifies partner Platforms of events related to user related data in our platform. Platforms can use it to automate back-office and administrative functions, including automatically fulfilling orders and providing customers with order status.

We provide IEN notifications for most of our entities as following:

• User
• KYC
• Order
• Quote
• Checkout
• Transfer
• Bank
• Card
• Wallet

Data sent

Each IEN entity will send an encrypted payload, and after you successfully decode it, you will have the exact same structure as in the API for that entity. For example, if a IEN request will be made for a Order, you will receive encoded in the payload a GET: /api/v1/user/{user}/order/{order} data object.

Versioning

Our current and maintained version is v2 where data submitted to Partner endpoints throw POST requests, is encrypted in RS512 (our default cryptographic algorithm), and can be decoded only using the JWT Public and Private keys.

Attempts

Our Platform will try to retry the request to Partner server until response is successfully made (maxim 10 attempts), receiving 200 status code. The number of attempts will be made dynamically as following:

• The first 3 attempts will be try every minute.
• The next 3 attempts will be try every 10 minutes.
• The next 3 attempts will be try every 60 minutes.
• The last attempt will be try after one day.

Subscribe

In order to receive this Instant Entity Notifications (IEN), Partner must provide a URL that will accept POST requests, that can be changed anytime from Partner Dashboard.