Payment Cancellation
Payment cancellation is only possible for transactions involving holds (transactions requiring amount confirmation through the set_accept method). There are two ways to cancel a payment:
- Manual Cancellation — by using the
accept_statusparameter. - Automatic Cancellation — after a specified time limit.
Manual Cancellation
To manually cancel a payment, send the cancel value in the accept_status parameter within the request body.
Method set_accept
- URL:
https://secure.octo.uz/set_accept - Method:
POST - Content-type:
application/json
Request Example
{
"octo_shop_id": "{{merchant_id}}",
"octo_secret": "6665a780-6715-45ab-83e2-74f012867a26",
"octo_payment_UUID": "{{octo_payment_UUID}}",
"accept_status": "cancel", // To cancel the payment.
"final_amount": 700.00
}Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| octo_shop_id | int | Yes | The shop's unique ID, available in the shop's Personal Account. |
| octo_secret | string | Yes | The shop's personal secret key, generated in the shop's Personal Account. |
| octo_payment_UUID | string | Yes | The unique payment ID, created by the OCTO system. |
| accept_status | string | Yes | Transaction confirmation status. Use cancel to cancel the payment. |
| final_amount | decimal | No | The final transaction amount, if a partial cancellation is required. |
Automatic Cancellation
Automatic cancellation occurs after a specified time limit if the transaction is not confirmed:
- For Humo and Uzcard cards: up to 30 days.
- For Visa/MC cards: up to 7 days.
Important
The time limit for automatic cancellation can be increased in the personal account, but only for Humo and Uzcard cards. For Visa/MC cards, the limit cannot be extended, only shortened.
Note
The cancellation method is useful in cases where transaction confirmation is no longer needed or cannot be completed. Ensure that all parameters are accurate for a successful request.