Xenodia Docs
API ReferenceGenerated Reference

Create a wallet payment for the signed-in account

Requires an account access token and a verified linked wallet. The server fixes the recipient account, payer wallet, asset, network, quoted payment amount and receiving address. Network fees require ETH on the selected network. Reuse the same idempotency key only with an identical body. The current stablecoin-per-Credit rate is returned by GET /v1/payments/options; every order snapshots its rate and keeps that quote after later price changes. One Credit is 1000000 microcredits. An order expires after 30 minutes, but expiry cannot cancel an on-chain transfer.

POST
/v1/payments/orders

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://api.xenodia.xyz/v1/payments/orders" \  -H "Content-Type: application/json" \  -d '{    "asset_id": "base_usdc",    "amount_micro": "10000000",    "idempotency_key": "stringst"  }'
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "account_id": 0,
    "account_label": "string",
    "payer_address": "string",
    "asset_id": "base_usdc",
    "chain_id": 8453,
    "token_address": "string",
    "recipient_address": "string",
    "amount_micro": "string",
    "credit_micro": "string",
    "rate_ppm": "string",
    "status": "pending",
    "payment_attempt_id": "string",
    "tx_hash": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "expires_at": "2019-08-24T14:15:22Z"
  }
}
{
  "error": "bad_request",
  "message": "string",
  "type": "string",
  "code": "string"
}
{
  "error": "bad_request",
  "message": "string",
  "type": "string",
  "code": "string"
}
Empty
Empty