/Create QR Payment

Generate and return QR content value on which QR image should be generated.

/Create QR Payment

Generate and return QR content value on which QR image should be generated.

Authorization

Authorization Type

Description

Bearer Token

access-token should be added to Authorization header

Request Parameters

Header

Parameter

Type

Description

apikey

string

developer app API key

Body Parameters

Parameter

Occurence

Type

Description

amount

Required

decimal

Transaction amount, more than zero
format: 0.00

currency

Required

string

Transaction currency (3 digit ISO code).
only "GEL" is available for this moment

terminalNo

Required

string

Terminal number

merchantPaymentId

Optional

string

Merchant-side payment identifier

callbackUrl

Optional

string

when payment status changes to final status, POST request containing PaymentId in the body will be sent to given URL. In case of successful receipt of the request, the merchant must return the status code 200 and check the payment status.
Body example {"PaymentId":"6azzo13uw5u2116332"}
callbackUrl must be added on the merchant dashboard at ecom.tbcpayments.ge.
If callbackUrl parameter is not provided, system automatically takes the basic callbackUrl value from the merchant dashboard.
Please, verify that POST request is allowed at your callbackUrl from the following IP addresses:
193.104.20.44
193.104.20.45
185.52.80.44
185.52.80.45

Response Parameters

Parameter

Type

Description

payId

string

Tpay payment identifier

qrCode

string

QR Code content value, on which qr image should be generated
Example- "https://tpay.ge/qr/qr-fa22871022"

amount

decimal

Transaction amount

currency

string

Transaction currency

terminalNo

string

Terminal number

expirationMinutes

string

Payment expiration time in minutes

merchantPaymentId

string

Merchant-side payment identifier

Error Handling

HttpStatusCode

Title

Status

Detail

400

InvalidParameter

400

Amount is required

400

InvalidParameter

400

Amount should be more than 0

400

InvalidParameter

400

TerminalID is Required

400

Invalid Merchant

400

Merchant is inactive

400

Invalid Merchant

400

Terminal is inactive

400

Invalid Merchant

400

Company is inactive

400

Invalid Merchant

400

Not enough merchant limit

401

Unauthorized

401

Unauthorized

404

Invalid Merchant

404

Terminal not found

500

Internal Server Error

500

An error occurred while processing your request


Did this page help you?