Skip to main content

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

ParameterTypeDescription
client-id *authorizationUnique Partner ID
client-secret *authorizationUnique authentication key for VIA API

Request parameters

ParameterTypeDescription
verifyId *stringIdentification number for confirmation
verifyCode *stringConfirmation 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

ParameterTypeDescription
transactionIdstringTransaction ID
processingTransactionIdstringTransaction ID of the processing system (UZCARD/HUMO)
merchantIdstringVIA Merchant ID
amountintegerTransfer amount in cents (1/100 part of the base currency unit)
createdAtintegerDate and time the transaction was created in Unix Timestamp format
statusstringTransaction status:
«SUCCESS» - Successful
«ERROR» - Error
«REJECT» - Refused
«PENDING» - Pending
«NEW» - New
«DRAFT» - Draft
payedAtintegerPayment date and time in Unix Timestamp format
feeintegerCommission amount in cents (1/100 part of the base currency unit)
feePercentlongCommission amount as a percentage
currencystringCurrency:
«UZS» - Uzbek sum
eposobjectEPOS system data object
epos.merchantIdstringMerchant ID
epos.terminalIdstringTerminal 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"
}
}
}