The new version 20250310 is available.

Refresh order

gecko [master]

https://shopapi.geckodistribution.com

POST

/api/open/order/refresh

Before proceeding with the payment, it is necessary to check the latest status of the items in the order.
If the user's account balance is sufficient and there are no abnormal orders in the order, the payment can be made directly.
Otherwise, further actions need to be taken based on the response value of the interface.

Request

Header Params

version

string

required

接口版本号

Default:

token

string

required

接口Token

Default:

Body Params application/json

array[string]

optional

List of order numbers.

>= 1 items

Example

[
    "170736529315528"
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://shopapi.geckodistribution.com/api/open/order/refresh' \
--header 'version;' \
--header 'token;' \
--header 'Content-Type: application/json' \
--data-raw '[
    "170736529315528"
]'

Responses

🟢200Success

application/json

Body

status

enum<string>

required

Response status code, typically uses 0 to indicate no exceptions, and non-zero values to indicate the presence of exceptions.

Allowed values:

0500

Example:

message

string

required

Exception response message, this field usually has significance when the value of status is non-zero.

Example:

Operation successful.

data

optional

Response data.

One of

OpenOrderRefreshVo0

OpenOrderRefreshVo1

OpenOrderRefreshVo2

The customer has sufficient balance and there are no abnormal orders, payment can be made directly. Next, it is usually necessary to call the 'Pay order' interface.

refreshStatus

enum<integer> <int32>

required

0: Everything is going smoothly, payment can be made directly.

Fixed value:

totalCost

string

required

Amount to be paid for the order.

Example:

99.99

Example

{
    "status": "0",
    "message": "Operation successful.",
    "data": {
        "refreshStatus": 0,
        "totalCost": "99.99"
    }
}

🟢200Failure

Get order list

Checkout order