/Create QR Payment
/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 |
| httpStatusCode | int | |
| developerMessage | string | warning message from developer |
| userMessage | string | warning message for user |
Error Handling
| HttpStatusCode | Title | Status | Detail |
|---|---|---|---|
| 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 |
Updated over 2 years ago