Transaction verification
Transaction verification is a way to call a script on one of your own web servers whenever a transaction is being processing. Verification is used in order to accept or decline a transaction.
Set up the verification
To receive a verification request from the UnonaPay system, pass verification_url
in transaction request parameters.
{
....
"verification_url":"https://your-domain.com/verification",
....
}
A verification request is similar to webhook request and use HTTP Basic authentication with Shop ID and Secret Key.
Accept or decline a transaction
Your web server should return the 200
HTTP status code and POST parameters in order to accept or decline a transaction.
Parameter | Type | Description |
---|---|---|
code * required |
integer | Set to 0 to accept the transaction. Set to any other code to decline the transaction. |
uid * required |
string | Submit the UID copied from the request. |
amount * required |
integer | Submit the amount copied from the request. |
message | string | A message why the transaction is declined, if the value of code is other than 0 . |
friendly_message | string | A message to the customer to explain a reason for decline. |
created_at | string | A response time in the ISO-8601 format. |
Example of the response to accept a transaction
{
"code":0,
"uid": "35153123-9367e7e770",
"amount": 100,
"created_at": "2020-08-04T06:16:17.052Z"
}
Example of the response to decline a transaction
{
"code":1,
"uid": "36279632-7127y612a6",
"amount": 100,
"message":"IP validation failed",
"friendly_message": "Your transaction is declined. For details please contact our customer service",
"created_at": "2020-08-04T06:16:22.141Z"
}