Instantor API docs
Search…
Instantor API docs
Introduction
Getting started
Widget implementation
A step-by-step guide
Widget configuration
Identify your customer
Pre-select a bank
Listen to Widget events
Other methods
Report delivery
Delivery introduction
Delivery methods
Report example
Report status definitions
Powered By GitBook
Delivery methods
Instantor has two ways of delivering a report to you, using a HTTPS POST request and / or delivery to your SFTP server.

HTTPS delivery

Using the Product Key and Decryption key, you will be able to receive the reports to your specified endpoint and decrypt them. Instantor API provides all the necessary functionality for decrypting the payload, and are available for .NET, Java and PHP.

Environments and Callback URLs

You are required to provide Instantor tech support with atleast one Callback URL. Instantor will configure that Callback URL for your production environment. You can ask Instantor to configure any number of environments (production environment, or staging, or test, etc.) for you, including a unique Callback URL for each environment. E.g. if a client would like to receive reports from their test-environment to a Callback URL associated to that test-environment. Please read more in the Identify your customer section on how to specify the environment in your webpage integration.

Expected response

After data delivery and decryption, the client is required to respond to the original HTTPS request with plain text message in form ofOK: <msg_id>, where <msg_id> is unique identifier for that report and is sent as a POST parameter with key msg_id.

Example:

1
...source=Product-Key&msg_id=msg-154c798aa69-1463637551721&action=report%2Fuser%2Fdata&encryption=B64%2FMD5%2FAES%2FCBC%2FPKCS5&payload=fLaaLEvgWN9leASb0g3TNZx4yp0D4yjFcnUNpOgsIHJH9...
Copied!

Expected response:

1
OK: msg-154c798aa69-1463637551721
Copied!
If the endpoint throws an exception/error or doesn’t contain msg_id our system waits for 30 seconds and tries to deliver the report again. We push the same report 3 times with a 30-second interval. If all 3 attempts are unsuccessful, our system marks it as a failure.

SDK to receive reports

Java SDK

You can download the latest version of the Instantor Java SDK here:
instantor-api-0.4.5-java.zip
29KB
Binary
instantor-api-0.4.5-java
If you want to verify the integrity of the Java SDK, please use the checksum below:
1
sha512sum: 4a63e52840b969094bffd1a894a03b3b69075d0ea0eb6790045827b1a7094a72578a972bfd7502f0c66704ed4a87b2e0538917b4dd00c9b1ca7a67be7822c62e
Copied!

PHP SDK

You can download the latest version of the Instantor PHP SDK here:
instantor-api-php-0.1.4.zip
3KB
Binary
instantor-api-php-0.1.4
If you want to verify the integrity of the PHP SDK, please use the checksum below:
1
sha512sum: 484c919809d324fd7ba6818670b65455d850e49bd4e1862942b1b4caea25e8792a80fe0c718c6a3a28c1314ea171ad6d00bc24b5f92935cca12fa04c201f2487
Copied!

.NET API

You can download the latest version of the Instantor .NET API here
instantor-api-net-0.5.zip
70KB
Binary
instantor-api-net-0.5
If you want to verify the integrity of the .NET API, please use the checksum below:
1
sha512sum: 5ca8960ecfdb0d54c6bfda5550625b8726faccb528abfdb2e0980febbe16a78d6cd06bb72d235d7dc2de2ee6f9789648c31c226c423a7abfc2348cd467927825
Copied!

SFTP delivery

Reports can be delivered to your server by SFTP. Please provide an endpoint and credentials so that we can configure our system appropriately. You are required to host the SFTP server yourself.
This delivery method is mandatory if you are receiving a human-readable PDF report instead of a JSON file.
Report delivery - Previous
Delivery introduction
Next - Report delivery
Report example
Last modified 8mo ago
Copy link
Contents
HTTPS delivery
Expected response
SDK to receive reports
SFTP delivery