创建支付订单

POST

/v1/checkout

Access steps:

The server creates an order: pass in app_id + amount + user information + return url

Obtain the checkout_url, and the front-end will redirect, preferably redirecting on the current page instead of opening a new window

After successful payment, it will redirect back to the success_url, with checkout_id and 302_signature included in the query parameters.

The server uses the checkout_id to verify whether the payment is successful. If successful, proceed to the next step.

The webhook will pass 302_signature in the header to facilitate verification of whether the request is authentic.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "app_id": "string",
    "price": 0,
    "customer": {
        "id": "string",
        "email": "string"
    },
    "success_url": "string",
    "request_id": "string",
    "metadata": {},
    "back_url": "string",
    "secret": "string",
    "signature": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/v1/checkout' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_id": "string",
    "price": 0,
    "customer": {
        "id": "string",
        "email": "string"
    },
    "success_url": "string",
    "request_id": "string",
    "metadata": {},
    "back_url": "string",
    "secret": "string",
    "signature": "string"
}'

Responses

🟢200成功

application/json

Body

Example

{
    "id": "string",
    "app_id": "string",
    "mode": "string",
    "checkout_url": "string",
    "status": "string",
    "price": 0,
    "customer": {
        "id": "string",
        "email": "string"
    },
    "request_id": "string",
    "success_url": "string",
    "metadata": "string"
}

Modified at 2025-11-14 10:52:14

获取签名算法

获取订单状态