Get E-Commerce payment details

get https://api.tbcbank.ge/v1/tpay/payments/{payId}

Request returns payment status and details for given payId.

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

confirmedAmount

double

In case of preAuthoraztion, specifies confirmed amount for the transaction

returnedAmount

double

Returned amount of the transaction.

If return is not made, the returnedAmount will be 0.

In case of partially returned, returnedAmount will bi the amount what merchant returned.

links

array of objects

Links

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

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

paymentMethod

int32

NOTE

If no method is passed, by default all methods available for a given merchant will be displayed
Passed items must be unique

Method Code	Description	Comment
4	Web QR
5	Pan (Payment with card)
7	Internet Bank Login
8	Installment	To activate Installment payment method, please configure Installment campaignID and MerchantKey parameter values from the merchant dashboard. To register as an Installments merchant and get your parameters, consult following instructions.
9	Apple Pay	Service should be activated for the merchant from the back-office. Please, contact sales for more information.
14	Google Pay	Service should be activated for the merchant from the back-office. Please, contact sales for more information

RNN

string

Transaction identifier (12 characters)

extra

string

Additional parameter for merchant specific info (optional)

extra2

string

Additional parameter for merchant specific info (optional)

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
None: no recurring payment

httpStatusCode

number

HTTP status code

developerMessage

string

Developer message for logging in local system

userMessage

string

Error message for user

resultCode

string

Business level transaction status description. Detailed list of available statuses is described in the Classifications chapter/ Result Codes

Card transaction business level result description:
| Code | Description Eng | Description Geo
| ---------- | ---------- | ----------
| approved | transaction was approved | დადასტურებული
| decline_general | general error | ზოგადი შეცდომა
| decline_expired_card | card is expired | ვადაგასული ბარათი
| decline_suspected_fraud | declined due to suspected fraud | საეჭვო ტრანზაქცია
| decline_restricted_card | card is in restricted list | აკრძალული ბარათი
| decline_invalid_card_number | declined due to invalid card number | არასწორი ბარათის ნომერი
| decline_not_sufficient_funds | declined due to insufficient funds | არასაკმარისი თანხა
| decline_card_not_effective | card is not active | არააქტიური ბარათი
| check_with_acquirer | details should be checked with the acquirer | გადასამოწმებელია ექვაირერთან

PaymentCardNumber

number

Mask of payment card

isBnpl

boolean

isBnpl parameter shows additional information about performed QR payment :

true – BNPL transaction (Buy now pay later)

(Only applicable for QR Payment)
false – NonBNPL transaction (Standard QR payment)

(Only applicable for QR Payment)
NULL – no specific data

(Applicable for every method except QR payment )

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.tbcbank.ge/v1/tpay/payments/payId \
3
     --header 'accept: application/json'

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

application/json

application/problem+json

200OK

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

401Unauthorized