Introduction

What's on this page

Exchange Rates

API Overview
Commercial Rates
- Get commercial ratesget
- Convert with commercial ratesget
Official Rates
- Get official ratesget
- Convert with official ratesget

TBC Checkout

API Overview
Endpoints

Exchange Rates Extended

API Overview
Exchange Rates
- Get commercial exchange rates extended informationpost

Online Installments

API Overview
Access Token
- Get access tokenpost
Applications
Merchant Applications
- Merchant Application Statusesget
- Merchant Application Status Syncpost

Mortgage Loans

API Overview
Access Token
- Get access tokenpost
Leads
- Initiate online mortgage leadpost
- Initiate online mortgage short leadpost

Open Banking Services

API Overview
Account Information Service (AIS)
v0.37 endpoints

Exchange Rates

Commercial Rates
- Method for requesting TBC bank's commercial exchange ratesget
- Method for converting amount between two currencies based on TBC bank's commercial exchange ratesget
Official Rates
- Method for requesting official exchange ratesget
- Method for converting amount between two currencies based on TBC bank's commercial exchange ratesget

POS QR Payment

API Overview
Endpoints
Get Access Tokenpost
Create POS QR Paymentpost
Get checkout payment detailsget

Open Banking Services v0.37

test

Log In With TBC

openid configurationget
Authorizationget
Authenticationpost
User Infoget

TBC.OpenAPI

OAuth2
UserInfo
- /openbanking/openid/userinfoget

Login with TBC

OAuth
Userinfo
- Get User Info.get

Open Banking Services

Payment Initiation Service (PIS)
Consents
Account Information Service (AIS)
Card Account Information Service (AIS)

OpenBanking Services - Consents

API Overview
- JWS Signature
Consent
OAuth

OPEN BANKING SERVICES - CARDS

API Overview
Cards

OpenBanking Services - Payments

API Overview
- JWS Signature
Payments
OAuth

Open Banking Services - Accounts

API Overview
Account
CardAccount

TBC CHECKOUT

Access Token
- Get access tokenpost
Payment

Online Installments

/oauth/token
- Get access tokenpost
/v1/online-installments/applications
- Initiate online installment applicationpost
/v1/online-installments/applications/{sessionId}/confirm
- Confirm applicationpost
/v1/online-installments/applications/{sessionId}/cancel
- Cancel applicationpost
/v1/online-installments/merchant/applications/status-changes-sync
- Merchant Application Status Syncpost
/v1/online-installments/merchant/applications/status-changes
- Merchant Application Statusesget
/v1/online-installments/applications/{sessionId}/status
- Get application statusget

OpenBanking Services - Loans and Savings

Consent
OAuth
Loans
Savings

OpenBanking Services - Payments

DeferredPayments
- Deferred Payment Consent Initiation Requestpost
- Initiation Deferred Payment requestpost
ExtendedPayments
ExtendedPaymentsInitiations
Payments
- Secured Payment Initiation requestpost
RecurringPayments
OAuth

OpenBanking Services - Account Information Service (AIS)

API Overview
Consents
OAuth
Accounts
Card Accounts

Get loan balances

get https://test-api.tbcbank.ge/xs2a-sandbox/v2/loans{resourceId}/balances

Returns balances of the loan

time	status	user agent
Retrieving recent requests…

Loading…

URL Expired

The URL for this request expired after 30 days.

Path Params

resourceId

string

required

Identifier of loan

Headers

X-Request-ID

uuid

required

ID of the request, unique to the call, as determined by the initiating party.

consentId

string

required

ID of the corresponding consent object as returned by an account information consent request.

PSU-IP-Address

string

required

The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP. It shall be contained if and only if this request was actively initiated by the PSU.

Responses

Response body

object

balances

array of objects | null

balances

object

balanceAmount

object

Detailed amount and currency information for the balance, represented by a LoanBalanceAmount object.

balanceType

string

Type of balance (e.g., available, current), referenced as a BalanceTypes object.

ClosingBooked OpeningBooked ForwardAvailable InterimBooked Information

balanceSubTypeProprietary

string | null

Proprietary sub-type for the balance, given as a string and can be null.

referenceDate

date-time

Date associated with the balance, formatted in date-time format.

Response body

object

type

string

A URI reference [RFC3986] that identifies the problem type.

title

string

A short, human-readable summary of the problem type.

status

int32

The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.

detail

string

A human-readable explanation specific to this occurrence of the problem.

instance

string

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

traceId

string

Message identification for searching errors

code

string

Message codes defined for AIS for appropriate HTTP status code

Response body

object

type

string

A URI reference [RFC3986] that identifies the problem type.

title

string

A short, human-readable summary of the problem type.

status

int32

The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.

detail

string

A human-readable explanation specific to this occurrence of the problem.

instance

string

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

traceId

string

Message identification for searching errors

code

string

Message codes defined for AIS for appropriate HTTP status code

Response body

object

type

string

A URI reference [RFC3986] that identifies the problem type.

title

string

A short, human-readable summary of the problem type.

status

int32

The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.

detail

string

A human-readable explanation specific to this occurrence of the problem.

instance

string

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

traceId

string

Message identification for searching errors

code

string

Message codes defined for AIS for appropriate HTTP status code

Response body

object

type

string

A URI reference [RFC3986] that identifies the problem type.

title

string

A short, human-readable summary of the problem type.

status

int32

The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.

detail

string

A human-readable explanation specific to this occurrence of the problem.

instance

string

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

traceId

string

Message identification for searching errors

code

string

Message codes defined for AIS for appropriate HTTP status code

Updated 6 months ago

Get loan by resource id

Savings

Did this page help you?

Language

Credentials

Bearer

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url https://test-api.tbcbank.ge/xs2a-sandbox/v2/loansresourceId/balances \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Updated 6 months ago

Get loan by resource id

Savings

Did this page help you?

Introduction
What's on this page

Exchange Rates
API Overview
Commercial Rates
Convert with commercial ratesget
Get commercial ratesget
Official Rates
Convert with official ratesget
Get official ratesget

TBC Checkout
API Overview
Endpoints

Exchange Rates Extended
API Overview
Exchange Rates
Get commercial exchange rates extended informationpost

Online Installments
API Overview
Access Token
Get access tokenpost
Applications
Get application statusget
Cancel applicationpost
Confirm applicationpost
Initiate online installment applicationpost
Merchant Applications
Merchant Application Status Syncpost
Merchant Application Statusesget

Mortgage Loans
API Overview
Access Token
Get access tokenpost
Leads
Initiate online mortgage short leadpost
Initiate online mortgage leadpost

Open Banking Services
API Overview
Account Information Service (AIS)
Update PSU Data for consentsput
Read Transaction Detailsget
Read transaction list of an accountget
Read Balanceget
Read Account Detailsget
Read Account Listget
Read the SCA status of the consent authorisation.get
Start the authorisation process for a consentpost
Delete Consentdelete
Get Consent Authorisation Sub-Resources Requestget
Get Consent Requestget
Create consentpost
Consent status requestget
v0.37 endpoints

Exchange Rates
Commercial Rates
Method for converting amount between two currencies based on TBC bank's commercial exchange ratesget
Method for requesting TBC bank's commercial exchange ratesget
Official Rates
Method for converting amount between two currencies based on TBC bank's commercial exchange ratesget
Method for requesting official exchange ratesget

POS QR Payment
API Overview
Endpoints
Get Access Tokenpost
Create POS QR Paymentpost
Get checkout payment detailsget

Open Banking Services v0.37
test

Log In With TBC
openid configurationget
Authorizationget
Authenticationpost
User Infoget

TBC.OpenAPI
OAuth2
/openbanking/oauth/tokenpost
/openbanking/oauth/registerpost
/openbanking/oauth/authorizeget
/.well-known/openid-configurationget
UserInfo
/openbanking/openid/userinfoget

Login with TBC
OAuth
Generate or Refresh Tokenpost
The Client Initiated Backchannel Authentication (CIBA) Authorizationpost
Authorizationget
Get JWKS keys setget
Get openid-configuration metadataget
Userinfo
Get User Info.get

Open Banking Services
Payment Initiation Service (PIS)
Update PSU data for payment initiation cancellationput
Read the SCA status of the payment cancellation's authorisationget
Will deliver an array of resource identifications to all generated cancellation authorisation sub-resourcesget
Start the authorisation process for the cancellation of the addressed paymentpost
Update PSU data for payment initiationput
Read the SCA status of the payment authorisationget
Get payment initiation authorisation sub-resources requestget
Start the authorisation process for a payment initiationpost
Payment initiation status requestget
Payment cancellation requestdelete
Get payment informationget
Payment initiation requestpost
Consents
Update PSU Data for consentsput
Read the SCA status of the consent authorisationget
Get consent authorisation sub-resources requestget
Start the authorisation process for a consentpost
Consent status requestget
Delete consentdelete
Get consent requestget
Create consentpost
Account Information Service (AIS)
Read transaction detailsget
Read transaction list of an accountget
Read balanceget
Read account detailsget
Read account listget
Card Account Information Service (AIS)
Read transaction list of an accountget
Read card account balancesget
Read details about a card accountget
Read a list of card accountsget

OpenBanking Services - Consents
API Overview
JWS Signature
Consent
Read the SCA status of the consent authorisationget
Get consent authorisation sub-resources requestget
Start the authorisation process for a consentpost
Get Consent status requestget
Delete consentdelete
Get consent requestget
Create Consentpost
OAuth
Authorize or Refresh Tokenpost
Authorizationget
Get Oauth Authorization Serverget

OPEN BANKING SERVICES - CARDS
API Overview
Cards
Read Card Transaction Listget
Read Card Balancesget
Read Card Detailsget
Read Card Listget

OpenBanking Services - Payments
API Overview
JWS Signature
Payments
Read the SCA status of the consent authorisationget
Get Authorisationsget
Read the SCA status of the payment authorisationpost
Payment initiation status requestget
Payment cancellation requestdelete
Get payment informationget
Payment Initiation requestpost
OAuth
Authorize or Refresh Tokenpost
Authorizationget
Oauth Authorization Serverget

Open Banking Services - Accounts
API Overview
Account
Read transaction list of an accountget
Read balanceget
Read account detailsget
Read account listget
CardAccount
Read transaction list of an accountget
Read card account balancesget
Read details about a card accountget
Read a list of card accountsget

TBC CHECKOUT
Access Token
Get access tokenpost
Payment
Delete recurring paymentpost
Execute recurring paymentpost
Complete pre-authorized paymentpost
Cancel E-Commerce paymentpost
Get E-Commerce payment detailsget
Create E-Commerce paymentpost

Online Installments
/oauth/token
Get access tokenpost
/v1/online-installments/applications
Initiate online installment applicationpost
/v1/online-installments/applications/{sessionId}/confirm
Confirm applicationpost
/v1/online-installments/applications/{sessionId}/cancel
Cancel applicationpost
/v1/online-installments/merchant/applications/status-changes-sync
Merchant Application Status Syncpost
/v1/online-installments/merchant/applications/status-changes
Merchant Application Statusesget
/v1/online-installments/applications/{sessionId}/status
Get application statusget

OpenBanking Services - Loans and Savings
Consent
Read the SCA status of the consent authorisationget
Get consent authorisation sub-resources requestget
Start the authorisation process for a consentpost
Get Consent status requestget
Delete consentdelete
Get consent requestget
Create Consentpost
OAuth
Authorize or Refresh Tokenpost
Authorizationget
Get Oauth Authorization Serverget
Loans
Get loan balancesget
Get loan by resource idget
Get loans listget
Savings
Get savings balancesget
Get savings by resource idget
Get savings listget

OpenBanking Services - Payments
DeferredPayments
Initiation Deferred Payment requestpost
Deferred Payment Consent Initiation Requestpost
ExtendedPayments
Delete Consent Requestdelete
Get Consent Requestget
Get Consent Status Requestget
ExtendedPaymentsInitiations
Get Consent Initiations Requestget
Delete Consent Payment Requestdelete
Get Consent Initiation Requestget
Get Consent Initiation Status Requestget
Payments
Secured Payment Initiation requestpost
RecurringPayments
Initiation Multiple Recurring Payment requestpost
Initiation Recurring Payment requestpost
Multiple Recurring Payment Consent Initiation requestpost
Recurring Payment Consent Initiation requestpost
OAuth
Authorize or Refresh Tokenpost
Authorizationget
Oauth Authorization Serverget

OpenBanking Services - Account Information Service (AIS)
API Overview
Read Consent Authorisation Statusget
Get Consent Authorisationsget
Start Consent Authorisation Processpost
Read Consent Statusget
Delete Consentdelete
Get Consent Detailsget
Create Consentpost
Authorize or Refresh Tokenpost
Authorizationget
Get Oauth Authorization Serverget
Read Account Transaction Listget
Read Account Balancesget
Read Account Detailsget
Read Account Listget
Read Card Account Transaction Listget
Read Card Account Balancesget
Read Card Account Detailsget
Read Card Account Listget

200Success

400Bad Request

401Unauthorized

404Not Found

500Server Error