/Get QR payment status

Request returns payment status and details for given payId.

Request Endpoint

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

Authorization

Authorization TypeDescription
Bearer Tokenaccess-token should be added to Authorization header

Request Parameters

Header

ParameterTypeDescription
apikeystringdeveloper app API key

Path Parameters

ParameterTypeDescription
payIdstringtpay payment identifier

Request Sample

curl --location --request GET 'https://api.tbcbank.ge/v1/tpay/qr/payments/{payId}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'apikey: lXcDL8JJiAN8Vjlu6NW3kNeceOQolwnF' \
--header 'Authorization: Bearer eyJhbGciOiJKSeriiIsImtpZCI6IjVFMjBGMzQ2RUY1RjU2ODkxQTIyRkUzQUVCRjAzMzlGMzVDNjk1QjYiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJYaUR6UnU5ZlZva2FJdjQ2Nl9Bem56WEdsYlkifQ.eyJuYmYiOjE2MzE2NDQyNjEsImV4cCI6MTYzMTczMDY2MSwiaXNzIjoiaHR0cHM6Ly9hY2NvdW50c2FwaS50YmNiYW5rLmdlLyIsImF1ZCI6WyJodHRwczovL2FjY291bnRzYXBpLnRiY2JhbmsuZ2UvcmVzb3VyY2VzIiwicGF5bWVudGFwaSJdLCJjbGllbnRfaWQiOiI3MDAwMDAyIiwic2NvcGUiOlsicGF5bWVudGFwaSJdfQ.GNIaxgik-ElXrvXOky5_1D1YjEEX5CB3eQHKPwvdCNhB-HvblqZ78QSNJcl6qLfL8gRTd0x9ASCgXu2z2RQYJ-wls0V2IwrQ7p4WEU-ON9QnasOjZWgPeVAtZQC_zjH9DdmL1GiDTIHLErhKDGl3YtSGcvPKSvTpABWda6HvF7lNGlEK0SZxzzt1i1SkpAnQfzIO1ATEmKdM1EmWzp5ZaDk0cF-Wzfk_2CrQAGofc80GT64U8WOXvVOx1gVYmjzqYs71XCOqfQdySYBIc-tbUC6YIoeSPZfu1hpi33Gz40ig57t4jxeE7Jh--38ydO4AGEw8BdlLv534O0V3ZoOddg' \
--data-raw ''

Response Parameters

ParameterTypeDescription
paymentStatusCodenumberpayment status code.
available values:
1 – Processing
3 – Success
4 – Failed
amountnumber
httpStatusCodenumberhttp status code
developerMessagestringdeveloper message for logging in local system
userMessagestringerror message for user

Response Sample

{
  "paymentStatusCode": 3,
  "amount": 8,
  "httpStatusCode": 200,
  "developerMessage": null,
  "userMessage": null
}
{
  "type": "https://developers.tbcbank.ge/docs/error-type-401",
  "title": "Invalid Api Key",
  "status": "401",
  "detail": "Please make sure api key is valid",
  "systemCode": "System code for problem is tpay-access-token.401.001"
}

Error Response

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

Details can be found at Error Code Description

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

ParameterTypeDescription
typestringA URI identifying a human-readable web page with information about the error
titlestringGeneral error description
statusstringHttp status code
systemCodestringerror code in following format: {method-name}.{http-status-code}
detailstringHuman-readable text providing additional Information
resultCodestringBusiness level error description. Available values: approved - დადასტურებული; decline_general - ზოგადი შეცდომა; decline_expired_card - ვადაგასული ბარათი; decline_suspected_fraud - საეჭვო ტრანზაქცია; decline_restricted_card - აკრძალული ბარათი; decline_invalid_card_number - არასწორი ბარათის ნომერი; decline_not_sufficient_funds - არასაკმარისი თანხა; decline_card_not_effective - არააქტიური ბარათი; check_with_acquirer - გადასამოწმებელია ექვაირერთან;

ENUM:
approved
decline_general decline_expired_card
decline_suspected_fraud
decline_restricted_card
decline_invalid_card_number
decline_not_sufficient_funds
decline_card_not_effective
check_with_acquirer