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

Execute recurring payment

post https://api.tbcbank.ge/v1/tpay/payments/execution

Request initiates recurring payment.

time	status	user agent
Retrieving recent requests…

Loading…

URL Expired

The URL for this request expired after 30 days.

Body Params

preAuth

boolean

Specify if preauthorization is needed for the transaction.

If true is passed, amount will be blocked on the card and additional request should be executed by merchant to complete payment.

To finalize authorization process, /v1/tpay/payments/:paymentId/completion endpoint should be used.

The following values are allowed:

true
false

recId

string

required

recId of the saved card

initiator

string

If merchant is initiator of the transaction it is needed to indicate additional parameter “merchant”, if the parameter is not followed it will be initiated as a customer initiated transaction.

merchantPaymentId

string

Merchant-side payment identifier

extra

string

length ≤ 25

Additional parameter for merchant specific info (optional). Only non-unicode (ANS) symbols allowed. This parameter will appear in the account statement

extra2

string

length ≤ 52

Additional parameter for merchant specific info (optional). Only non-unicode (ANS) symbols allowed.

money

object

required

Headers

apikey

string

required

Developer app API key

Responses

Response body

object

payId

string

Payment id

status

string

Payment status

The following values are allowed:

Created
Processing
Succeeded
Failed
Expired
WaitingConfirm
CancelPaymentProcessing
PaymentCompletionProcessing
Returned
PartialReturned

currency

string

Transaction currency (3 digit ISO code)

amount

double

Transaction amount

links

object

uri

string

URL

method

string

Method to use on URL

rel

string

Action to use on URL

transactionId

string

Transaction_id from UFC

preAuth

string

Preauthorization status for given payment (true, false)

initiator

string

The parameter defines by whom the transaction is initiated:

client: Client initiator transaction
Merchant: Merchant initiator transaction

recurringCard

object

Saved card parameters: card recId, cardMask and expiryDate.
If saving card wasn't required, null will be returned

recId

string

Saved card recId. Used for initiating payment with saved card.

cardMask

string

Masked card PAN

expiryDate

string

Date of expiry

httpStatusCode

number

HTTP status code

developerMessage

string

Developer message for logging in local system

userMessage

string

Error message for user

Response body

object

status

number

The HTTP status code generated by the target server. More details about status codes RFC7231, Section 6.

type

string

A URI reference that identifies the problem type. When dereferenced, this specification provides human-readable documentation for the problem type. When this field is not present, its value is assumed to be "about:blank".

title

string

A short, human-readable summary of the problem type. Is mosly used for the localization purposes.

detail

string

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

systemCode

string

An internal reference code. Might be used when communicating with the TBC support team.

Response body

object

status

number

The HTTP status code generated by the target server. More details about status codes RFC7231, Section 6.

type

string

title

string

A short, human-readable summary of the problem type. Is mosly used for the localization purposes.

detail

string

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

systemCode

string

An internal reference code. Might be used when communicating with the TBC support team.

Updated over 1 year ago

Complete pre-authorized payment

Delete recurring payment

Did this page help you?

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.tbcbank.ge/v1/tpay/payments/execution \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

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

application/json

application/problem+json

Updated over 1 year ago

Complete pre-authorized payment

Delete recurring payment

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

200OK

400BadRequest Note in case of 400 Bad Request additional parameter, resultCode containing detailed business error description will be returned.

401Unauthorized