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_status
parameter. - 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.