Testing with Postman

Postman collection

Postman collection and preconfigured environment can be downloaded from the following link: Installment Loans Postman Collection

Instruction

1. Add you apiKey, apiSecret and merchantKey to the Postman configuration environment:

Configure environment

2. To get your access token (Request Access Token) call /oauth/token endpoint (necessary parameters will be filled automatically).

Get access token

📘

Received access_token is required to perform the next steps. This parameter will be automatically saved in the configuration.

3. To Initiate the application, use /v1/online-installments/applications endpoint.
   Fill the parameters in the body and add your merchantKey value:

Initiate application

4. In the response body you will see the sessionId:

Get sessionId

📘

session_id is needed to cancel or confirm the order

To Cancel the order use

/v1/online-installments/applications/{{session-id}}/cancel

Cancel order

To Confirm the order use

/v1/online-installments/applications/{{session-id}}/confirm

Confirm order

5. In the Location Header you will receive an address to which you must redirect the user to fill out the installment application:

callback URL

Here you can find some request examples:

---

Example of successful request, status code: 200 OK

• Successful request

200 OK

📘

In the service body, the Id field of the JSON object will always return a null value. Status code 200 is enough to identify success. Please ignore the data in the body.

Example of successful request, status code: 201

Body:

Status Code: 201

Redirect URL is in Headers > Location:

Redirect URL

Example of rejected request, status code: 404 Not Found

• Merchant was not found - if your MerchantKey is incorrect or was not found

Merchant was not found

• Merchant is deactivated

Merchant is deactivated

Example of rejected request, status code: 400 Bad Request

• FullPriceInCoins is missing - if priceTotal is not provided

FullPriceInCoins is missing

• FullPriceInCoins is invalid. Value must be greater than zero.

FullPriceInCoins is invalid

• Product(s) was not specified

Product(s) was not specified

• Product price is missing

Product price is missing

• Product quantity is missing

Product quantity is missing

• Product quantity is invalid. Value must be 1 or more.

Product quantity is invalid.

• Product price and full prices does not match.

Product price and full prices does not match.

Example of rejected request, status code: 401 Unauthorized

• Active installment with sesseionId not exists

Active installment with sesseionId not exists

• Cannot confirm installment. Expired confirmation date.

Cannot confirm installment. Expired confirmation date.