Verification of the status

Transaction status can be verified by calling another variant of the prepare_payment method. This version only requires three parameters:

• octo_shop_id
• octo_secret
• shop_transaction_id

Method prepare_payment

• URL: https://secure.octo.uz/prepare_payment
• Method: POST
• Content-type: application/json

Request Example

{
  "octo_shop_id": 123,
  "octo_secret": "537da54b-835a-4968-9864-c2ae02c5902e",
  "shop_transaction_id": "0000_0000_0000_0000_0010"
}

Request Parameters

Parameter	Type	Required	Description
octo_shop_id	Integer	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.
shop_transaction_id	String	Yes	The unique transaction ID on the shop's side.

---

Successful Response Example

{
    "error": 0,
    "data": {
        "shop_transaction_id": "c9211e0f-c6ba-4d97-b8be-fb230ef3985b",
        "octo_payment_UUID": "e3f40dc3-4955-412a-853a-2ddd28d3201f",
        "status": "created"
    }
}

Successful Response Parameters

Parameter	Type	Required	Description
error	int	Yes	Error code. A value of 0 indicates a successful request.
data	object	Yes	Object containing payment data.
data.shop_transaction_id	string	Yes	The unique transaction ID on the shop's side.
data.octo_payment_UUID	string	Yes	The unique payment ID in the Octo system.
data.status	string	Yes	The current payment status. Possible values: created, etc.

---

Unsuccessful Response Example

{
    "error": 2,
    "errMessage": "Wrong secret",
    "data": null,
    "errorMessage": "Wrong secret",
    "apiMessageForDevelopers": "The errorMessage field is outdated. Please switch to errMessage for unification of responses."
}

Unsuccessful Response Parameters

Parameter	Type	Required	Description
error	int	Yes	Error code.
errMessage	string	Yes	Error message (if an error occurred).
data	object	No	Main transaction data. Can be null in case of an error.
errorMessage	string	Yes	Outdated field for error messages (use errMessage instead).
apiMessageForDevelopers	string	No	Message for developers about API status or changes.

---

Note

The transaction status verification method is suitable for tracking the current state of a payment. Ensure that all parameters are passed correctly for successful execution.