Create a payment order

Create a StableOps payment order with accepted chains and assets, exact payable amounts, receiving instructions, expiry, metadata, and a stable idempotency key.

POST/v1/payment-orders

Authorization

bearerAuth

AuthorizationBearer <token>

Paste your API key from the dashboard.

In: header

Header Parameters

Idempotency-Key*string

Stable client-supplied key (e.g. merchant order id). Replays return the original response.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

merchant_order_id*string

Your unique identifier for this order, used for idempotency.

amount*string

Order amount as a decimal string (e.g. "100.50"). Supports up to 18 decimal places.

amount_mode?string

Amount matching mode. "exact" (default): merchant ensures unique amounts per shared address. "auto": system automatically adjusts the amount to guarantee uniqueness.

accepted_assets*array<>

List of assets the payer can use to pay. At least one asset is required.

expires_at*string

ISO 8601 datetime when this order expires. Required. Must be no more than 30 minutes from now in sandbox, or 24 hours in live; longer values are rejected with 400.

metadata?

Arbitrary metadata key-value pairs. Redacted in webhook payloads when redact_metadata is enabled.

Response Body

`application/json`

curl -X POST "https://example.com/v1/payment-orders" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "merchant_order_id": "string",    "amount": "string",    "accepted_assets": [      {        "chain": "ethereum",        "asset": "USDC"      }    ],    "expires_at": "2019-08-24T14:15:22Z"  }'

{
  "id": "string",
  "merchant_order_id": "string",
  "amount": "string",
  "requested_amount": "string",
  "chain_amount": "string",
  "settlement_asset": "USDC",
  "status": "created",
  "expires_at": "2019-08-24T14:15:22Z",
  "metadata": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "accepted_assets": [
    {
      "chain": "ethereum",
      "asset": "USDC"
    }
  ],
  "payment_instructions": [
    {
      "chain": "ethereum",
      "asset": "USDC",
      "address": "string"
    }
  ]
}

{
  "statusCode": -9007199254740991,
  "message": "string",
  "error": "string"
}

{
  "statusCode": -9007199254740991,
  "message": "string",
  "error": "string"
}

{
  "statusCode": -9007199254740991,
  "message": "string",
  "error": "string"
}

{
  "statusCode": -9007199254740991,
  "message": "string",
  "error": "string"
}

Create a payment order

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

409application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`