Skip to main content
GET
/
api
/
v1
/
payment
/
{payment_id}
{
  "id": "<string>",
  "amount_total": 123,
  "currency": "<string>",
  "payment_status": "pending",
  "created": 123,
  "expires_at": 123,
  "url": "<string>",
  "line_items": [
    {
      "price_data": {
        "id": "<string>",
        "currency": "<string>",
        "product": "<string>",
        "unit_amount": 123,
        "recurring": {
          "interval": "day",
          "interval_count": 123
        }
      },
      "quantity": 2
    }
  ],
  "tax_amount": 123,
  "shipping_amount": 123,
  "exchange_rate": "<string>",
  "target_currency": "<string>",
  "target_amount_total": 123,
  "rate_locked_at": 123,
  "subscription_id": "<string>",
  "invoice_id": "<string>",
  "metadata": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer API Key, for example Bearer sk_live_xxx.

​
X-StablePay-Timestamp
string
header
required

Unix timestamp in seconds. Must be within 5 minutes of server time.

​
X-StablePay-Nonce
string
header
required

Replay-protection nonce, 16-64 characters. Use a fresh UUID per request.

​
X-StablePay-Signature
string
header
required

Lowercase hex HMAC-SHA256 of {timestamp}.{nonce}.{requestBody} signed with the merchant API Secret. For GET requests, requestBody is an empty string.

Headers

​
X-StablePay-Timestamp
string
required

Unix timestamp in seconds. Must be within 5 minutes of server time.

​
X-StablePay-Nonce
string
required

Replay-protection nonce, 16-64 characters. Use a fresh UUID per request.

Required string length: 16 - 64
​
X-StablePay-Signature
string
required

Lowercase hex HMAC-SHA256 of {timestamp}.{nonce}.{requestBody} signed with the merchant API Secret. For GET requests, requestBody is an empty string.

Path Parameters

​
payment_id
string
required

Payment ID returned by a subscription invoice, used to retrieve subscription charge payment details.

Response

Retrieved successfully.

​
id
string
required

Payment session ID.

​
amount_total
integer<int64>
required

Total amount in minor units.

​
currency
string
required

Merchant ledger currency, returned in lowercase.

​
payment_status
enum<string>
required

Payment status. confirming is returned as processing; completed is returned as paid.

Available options:
pending,
processing,
paid,
failed,
expired,
canceled
​
created
integer<int64>
required

Creation time, Unix seconds.

​
expires_at
integer<int64>
required

Expiration time, Unix seconds.

​
url
string<uri>

Checkout URL.

​
line_items
object[]

Line items.

​
tax_amount
integer<int64>

Tax amount in minor units.

​
shipping_amount
integer<int64>

Shipping amount in minor units.

​
exchange_rate
string

Exchange rate when currency conversion applies.

​
target_currency
string

Actual on-chain payment currency, for example USDT.

​
target_amount_total
integer<int64>

Target amount in target-currency minor units.

​
rate_locked_at
integer<int64>

Rate lock time, Unix seconds.

​
subscription_id
string

Related subscription ID, returned for subscription payments.

​
invoice_id
string

Related invoice ID, returned for invoice or subscription payments.

​
metadata
object

Merchant metadata.

Last modified on April 30, 2026