Create or Confirm Order

POST

/openapi/crypto/x402/order

Creates a payment order or confirms payment via X-PAYMENT header. Returns 402 with payment instructions if payment is required, or 200 upon successful confirmation.

Request

Authorization

API Key

Add parameter in header

Merchant-App-Key

Example:

Merchant-App-Key: ********************

API Key

Add parameter in header

X-PAYMENT

Example:

X-PAYMENT: ********************

Header Params

Body Params application/json

Example

{
    "description": "Payment for premium subscription"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.pelagotech.com/openapi/crypto/x402/order' \
--header 'X-PAYMENT: eyJ4NDAyVmVyc2lvbiI6MSwic2NoZW1lIjoiZXhhY3QiLCJuZXR3b3JrIjoiYnNjLW1haW5uZXQiLCJwYXlsb2FkIjp7ImFtb3VudCI6IjI2MDAwMDAiLCJzaWduYXR1cmUiOiIweDU1Li4iLCJ0eEhhc2giOiIweDEyMy4uIn19' \
--header 'Merchant-App-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "Payment for premium subscription"
}'

Responses

🟢200成功

application/json

Payment successful, order confirmed

Headers

Body

Example

{
    "orderId": "CO2025091502171350002",
    "status": "confirmed",
    "message": "Payment successful"
}

🟠400请求有误

🟠402402

Modified at 2025-10-27 02:45:31

Retrieve Supported Payment Methods

Query Order Status