/Create QR payment

Request Endpoint

https://api.tbcbank.ge/v1/tpay/qr/payments

Authorization

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

Request Parameters

Header

ParameterTypeDescription
apikeystringdeveloper app API key

Body Parameters

ParameterTypeDescription
amount (required)numbertransaction amount

Request Sample

{
    "amount": "{{cashdesk-amount}}"
}
curl --request POST \
  'http://api.tbcbank.ge/v1/tpay/qr/payments' \
  --header 'ApiKey: lXcDL8JJiAN8Vjlu6NW3kNeceOQolwnF' \
  --header 'Authorization: Bearer eyJhbGciOiJKSeriiIsImtpZCI6IjVFMjBGMzQ2RUY1RjU2ODkxQTIyRkUzQUVCRjAzMzlGMzVDNjk1QjYiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJYaUR6UnU5ZlZva2FJdjQ2Nl9Bem56WEdsYlkifQ.eyJuYmYiOjE2MzE2NDQyNjEsImV4cCI6MTYzMTczMDY2MSwiaXNzIjoiaHR0cHM6Ly9hY2NvdW50c2FwaS50YmNiYW5rLmdlLyIsImF1ZCI6WyJodHRwczovL2FjY291bnRzYXBpLnRiY2JhbmsuZ2UvcmVzb3VyY2VzIiwicGF5bWVudGFwaSJdLCJjbGllbnRfaWQiOiI3MDAwMDAyIiwic2NvcGUiOlsicGF5bWVudGFwaSJdfQ.GNIaxgik-ElXrvXOky5_1D1YjEEX5CB3eQHKPwvdCNhB-HvblqZ78QSNJcl6qLfL8gRTd0x9ASCgXu2z2RQYJ-wls0V2IwrQ7p4WEU-ON9QnasOjZWgPeVAtZQC_zjH9DdmL1GiDTIHLErhKDGl3YtSGcvPKSvTpABWda6HvF7lNGlEK0SZxzzt1i1SkpAnQfzIO1ATEmKdM1EmWzp5ZaDk0cF-Wzfk_2CrQAGofc80GT64U8WOXvVOx1gVYmjzqYs71XCOqfQdySYBIc-tbUC6YIoeSPZfu1hpi33Gz40ig57t4jxeE7Jh--38ydO4AGEw8BdlLv534O0V3ZoOddg' \
  --header 'Accept: application/json' \
  --data "{    \"amount\": \"2.80\"}"
  --compressed

Response Parameters

ParameterTypeDescription
paymentIdstringpayment id
qrCodestringURL of QR payment which should be converted to QR code
httpStatusCodestringhttp status code
developerMessagestringdeveloper message for logging in local system
userMessagestringerror message for user

Response Sample

{
  "paymentId": "tpay-avc0lb12433",
  "qrCode": "https://tpay.ge/qr/qr-cc6ed72143",
  "httpStatusCode": 200,
  "developerMessage": "QR generated successfully",
  "userMessage": "QR დაგენერირდა წარმატებით"
}

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