创建支付订单

POST

/v1/checkout

接続手順：

サーバーで注文を作成：app_id＋金額＋ユーザー情報＋戻りurlを渡す

checkout_urlを取得し、フロントエンドでジャンプする。できれば現在のページでジャンプし、新しいウィンドウを開かないようにする

支払いが成功すると、success_urlにジャンプバックし、クエリパラメータにcheckout_idと302_signatureが付加される。

サーバー側はcheckout_idを取得し、支払いが成功したかどうかを検証する。成功した場合は、次のステップに進む。

webhookはヘッダーに302_signatureを渡し、リクエストが真実かどうかを検証するのに便利です。

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 11:00:21

获取签名算法 Copy

获取订单状态