Method verify
URL: POST - /partner/merchant/confirm/pay/verify
The method allows you to send a one-time verification code to confirm payment for the merchant's service VIA the client's bank card.
When sending a request to pay for a merchant's service using the merchant/confirm/pay method, the system returns a unique identifier of a one-time verification code. A one-time verification code will be sent to the client in the form of an SMS message.
To confirm the payment, the partner must send the received ID and a one-time verification code using the merchant/confirm/pay/verify method.
Header parameters
| Parameter | Type | Description |
|---|---|---|
| client-id * | authorization | Unique Partner ID |
| client-secret * | authorization | Unique authentication key for VIA API |
Request parameters
| Parameter | Type | Description |
|---|---|---|
| verifyId * | string | Identification number for confirmation |
| verifyCode * | string | Confirmation code |
Request sample
curl POST '/partner/merchant/confirm/pay/verify' \
--header 'client-id: system' \
--header 'client-secret: system123' \
--data '{
"verifyId": "trx_2VQGS1Eeu4DNsfuKxbFO1vftNy4",
"verifyCode": "005646"
}'
Response parameters
| Parameter | Type | Description |
|---|---|---|
| transactionId | string | Transaction ID |
| processingTransactionId | string | Transaction ID of the processing system (UZCARD/HUMO) |
| merchantId | string | VIA Merchant ID |
| amount | integer | Transfer amount in cents (1/100 part of the base currency unit) |
| createdAt | integer | Date and time the transaction was created in Unix Timestamp format |
| status | string | Transaction status: «SUCCESS» - Successful «ERROR» - Error «REJECT» - Refused «PENDING» - Pending «NEW» - New «DRAFT» - Draft |
| payedAt | integer | Payment date and time in Unix Timestamp format |
| fee | integer | Commission amount in cents (1/100 part of the base currency unit) |
| feePercent | long | Commission amount as a percentage |
| currency | string | Currency: «UZS» - Uzbek sum |
| epos | object | EPOS system data object |
| epos.merchantId | string | Merchant ID |
| epos.terminalId | string | Terminal ID мерчанта |
Example response if successful
{
"transactionId": "trx_2VQGS1Eeu4DNsfuKxbFO1vftNy4",
"processingTransactionId": "010964369832",
"merchantId": "mrt_2V4M5svbNoQ68tB0ul8LoLWJOZQ",
"amount": 100,
"createdAt": 1694760886762,
"status": "SUCCESS",
"payedAt": 1694760902483,
"fee": 0,
"feePercent": 0.0,
"currency": "UZS",
"epos": {
"merchantId": "11111111111",
"terminalId": "22222222"
}
}
Example response in case of error
{
"status": {
"code": "1234",
"message": "Error while executing the request"
},
"error": {
"path": "URL Path",
"message": {
"uz": "Error message in Uzbek",
"ru": "Error message in Russian",
"en": "Error message in English"
}
}
}