Refunds

The store can make refunds on successfully completed payments (with the succeeded status).

You can make any number of refunds provided that the amount of one refund is greater than or equal to 1 USD (or the corresponding amount in UZS) and the total payment amount minus all previously made refunds greater than 1 USD.

URL: https://secure.octo.uz/refund

Method: POST

Content-type: application/json

Request body:

{
  "octo_shop_id": 10000,
  "shop_refund_id" : "a8s75f6sdaf85",
  "octo_secret": "2d45df74-bb95-47cf-a616-8d6dcee2e10d",
  "octo_payment_UUID": "1145df74-bb95-47cf-a616-8d6dcee2e222",
  "amount": 1.33
}

The refund currency is the same as the payment currency.

Description of Octo response fields:

Field Required Description
shop_refund_id Yes Unique ID of the refund operation on the store side. Required to filter possible duplicate calls of refund operations.
octo_secret Yes The personal secret key of the store, which is generated in the personal cabinet of the store. The key must be kept in a safe, inaccessible area of the store website.
amount Yes Refund amount.
octo_payment_UUID Yes Unique transaction identifier in Octo PS.
supplier_shop_id No Store ID (product supplier when splitting ) on which you need to make a refund. If when splitting not specified – a refund is made only within the cost of marketplace services.

In response, the server will send the following JSON:

{
  "error": 0,
  "status": "ok",
  "octo_payment_UUID": "1145df74-bb95-47cf-a616-8d6dcee2e222",
  "refund_id": "3335df74-bb95-47cf-a616-8d6dcee2e333",
  "refund_time": "2018-03-30 13:22:33"
}

Description of Octo response fields:

Field Required Description
error Yes Error code. Options:

0 - no errors
1 - data format error
2 - authorisation error
3 - Invalid refund amount
status Yes Refund status:

new - new
succeeded - successfull
pending - pending
canceled - canceled
unknown - unknown
error - error
octo_payment_UUID Yes Unique transaction identifier in Octo PS.
refund_id No Unique ID of the refund operation on the store side.
refund_time No Refund time.