/Initiate online installment application

Method should be used for initiating Online Installment application. Merchant parameters, product list and price should be passed in request. Successful response body will contain sessionId for given application used in follow-up requests (like confirming application, etc.) and Location Header will contain redirectUrl value, where user should be redirected to fill in and complete installment Loan application.

Request Endpoint

https://test-api.tbcbank.ge/v1/online-installments/applications

POST https://api.tbcbank.ge/v1/online-installments/applications

Authorization

Authorization Type	Description
Bearer Token	access-token should be added to Authorization header

Request Parameters

Parameter	Type	Description
merchantKey (required)	string	merchant unique identifier in online installments module
campaignId	string	online installments campaign id
invoiceId	string	invoice id
priceTotal (required)	number (decimal)	total price of purchase in GEL 0.00. should be equal to sum of all product prices.
products [ ] (required)	array	array of installment products

Complex Types Description

products

Parameter	Type	Description
name	string	product description
price (required)	number (decimal)	product price in Georgian Lari format: 0.00
quantity (required)	integer (int32)	number of purchased units

Request Sample

curl --location --request POST 'https://test-api.tbcbank.ge/v1/online-installments/applications' \
--header 'Authorization: Bearer vpmnLxBrQGlvm2Ivky2eW0QEAhDt' \
--header 'Content-Type: application/json' \
--data-raw '{
  "merchantKey": "MerchantIntegrationTesting",
  "priceTotal": 150.33,
  "campaignId":	"1",
  "invoiceId": "123",
  "products": [
    {
      "name": "მაცივარი",
      "price": 150.33,
      "quantity": 1
    }
  ]
}'

Response Parameters

response contains location header with correspondins redirect URL and unique sessionId of the initiated application.

Response Header

Parameter	Type	Description
location	string (uri)	URI where the client should be redirected to continue Installment Loan appication.

Response Body

Parameter	Type	Description
sessionId	guid	unique identifier of the online application session. should be saved for follow-up application requests (e.g. confirm application).

Response Sample

{
    "sessionId": "289838bb-f41f-40c2-b9c9-151407acbbbf"
}

Error Response

In case of error, standard response in problem json will be returned.

Details can be found at Error Code Description.