FAQ

How to authorize on https://ecom.tbcpayments.ge?

Authorization must be carried out using director's personal Internet bank credentials.

Where can we see Client ID and Client Secret?

To get Client ID and Client Secret, you need to authenticate on the site https://ecom.tbcpayments.ge/ using director's personal Internet bank credentials. Select the company in the upper right corner and go to "საიტების მართვა".

Where can I find my API Key?

To obtain an API Key, you must complete the registration process on the TBC Developers Portal and create an application. Detailed instructions are available at the links below:
https://developers.tbcbank.ge/docs/create-developer-account
https://developers.tbcbank.ge/docs/register-app
https://developers.tbcbank.ge/docs/get-apikey-and-secret

When registering the application, it is important to select E-commerce from the list of available products to ensure that the API Key is correctly associated with the e-commerce service.

What amount can I use for testing?

By default, a testing limit of 100 GEL is available for your website. This means that you can create transactions with a maximum total or single amount of up to 100 GEL.

It is recommended to perform testing using a minimal transaction amount (e.g., 1 GEL).

When testing Buy Now, Pay Later (BNPL) payments, the transaction amount must exceed 50 GEL in order for the installment payment option to be available.

After completing testing, you must submit a request to activate the production (live) environment via the dashboard:
https://ecom.tbcpayments.ge

→ საიტების მართვა → რეალური გარემოს გააქტიურება

How to add different payment methods?

You can write from the business internet bank which method you want to activate. For example: Please, activate Google Pay payment method.

After confirmation from TBC Bank, you need to add the corresponding number in the payment method.

For example, if you had specified "methods" : [5, 9] earlier and requested new method having ID - 14, after confirmation you will specify "methods" : [5, 9, 14].

For more details, you can visit Create a payment documentation.

How to check if the payment is successful?

When the payment is completed (Succeeded, Failed, Expired, WaitingConfirm), the payment ID will be posted on your callback URL if specified on the https://ecom.tbcpayments.ge merchant dashboard.

Using the payment ID you can retrieve details by Payment details method.

If you have not specified callback URL on the merchant dashboard, you will not be notified when the payment is completed

How can we use recurring payments?

You can write from the business internet bank that you want to activate recurring payments.

After confirmation from TBC Bank, you need to specify the following attributes in the payment initiation request Create E-Commerce payment

"saveCard": true,
"saveCardToDate": "1044"

You will receive recId in the response, which is unique and required for initiating next recurring payment.

For more details, see the documentation: Create E-Commerce payment

Payment execution request from the saved card should be initiated by you.

For more details, see the documentation: Execute recurring payment

How to use Split payment?

You can write from the business internet bank that you want to activate it.

To use the split function, you need to make a request and join the bank's program. Send a request through the Business Internet banking message.

After confirmation you should specify two fields in the request:

In the _extra _field, you should indicate the account number where you want to transfer the split amount.
In extra2, write the amount that the merchant wants to transfer to the account (in the previous point).