Skip to content

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:

  1. Manual Cancellation — by using the accept_status parameter.
  2. 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

json
{
    "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

ParameterTypeRequiredDescription
octo_shop_idintYesThe shop's unique ID, available in the shop's Personal Account.
octo_secretstringYesThe shop's personal secret key, generated in the shop's Personal Account.
octo_payment_UUIDstringYesThe unique payment ID, created by the OCTO system.
accept_statusstringYesTransaction confirmation status. Use cancel to cancel the payment.
final_amountdecimalNoThe 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.