Skip to main content
GET
/
checkout
/
sessions
/
{session_id}
curl https://api.maash.io/checkout/sessions/cs_01ARZ3NDEKTSV4RRFFQ69G5FAV \
  -H "x-maash-user-type: checkout"

{
  "data": {
    "session_id": "cs_01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "merchant_id": "mer_01ABC",
    "transaction_id": "txn_123456789",
    "amount_usd": 100,
    "merchant_currency": "USD",
    "merchant_amount": 100,
    "status": "pending",
    "supported_tokens": {
      "tokens": {
        "USDC": {
          "chain": ["solana", "arbitrum"]
        },
        "USDT": {
          "chain": ["solana", "optimism"]
        }
      }
    },
    "unsupported_tokens": {
      "tokens": {
        "DAI": {
          "chain": ["bsc", "base"]
        },
        "BNB": {
          "chain": ["bsc", "base"]
        }
      }
    },
    "expires_at": "2024-02-02T15:25:00Z",
    "created_at": "2024-01-31T15:25:00Z",
    "updated_at": "2024-01-31T15:25:00Z",
    "metadata": {}
  }
}
Returns the full details of a checkout session, including its current status, supported and unsupported tokens, and metadata. Use this endpoint to check payment status from your server.

​
Authentication

​
x-maash-user-type
string
required
Must be set to checkout.

​
Path parameters

​
session_id
string
required
The checkout session ID (e.g., cs_01ARZ3NDEKTSV4RRFFQ69G5FAV).

​
Response

​
data
object
​
session_id
string
Unique session identifier.
​
merchant_id
string
Merchant identifier.
​
transaction_id
string
Your transaction identifier.
​
amount_usd
number
Payment amount in USD.
​
merchant_currency
string
Merchant’s currency code (ISO 4217) if provided during session creation.
​
merchant_amount
number
Payment amount in merchant’s currency if provided during session creation.
​
status
string
Current session status. One of: pending, awaiting_payment, confirming, completed, underpaid, overpaid, expired, failed, cancelled.
​
supported_methods
object
Payment methods that are available for this session. Contains boolean flags for each method:
​
supported_tokens
object
Tokens and chains that are supported for this session.
​
unsupported_tokens
object
Tokens and chains that are not supported for this session.
​
expires_at
string
ISO 8601 timestamp when this session expires.
​
created_at
string
ISO 8601 timestamp when the session was created.
​
updated_at
string
ISO 8601 timestamp of the last update.
​
metadata
object
Custom key-value pairs attached to the session.
curl https://api.maash.io/checkout/sessions/cs_01ARZ3NDEKTSV4RRFFQ69G5FAV \
  -H "x-maash-user-type: checkout"

{
  "data": {
    "session_id": "cs_01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "merchant_id": "mer_01ABC",
    "transaction_id": "txn_123456789",
    "amount_usd": 100,
    "merchant_currency": "USD",
    "merchant_amount": 100,
    "status": "pending",
    "supported_tokens": {
      "tokens": {
        "USDC": {
          "chain": ["solana", "arbitrum"]
        },
        "USDT": {
          "chain": ["solana", "optimism"]
        }
      }
    },
    "unsupported_tokens": {
      "tokens": {
        "DAI": {
          "chain": ["bsc", "base"]
        },
        "BNB": {
          "chain": ["bsc", "base"]
        }
      }
    },
    "expires_at": "2024-02-02T15:25:00Z",
    "created_at": "2024-01-31T15:25:00Z",
    "updated_at": "2024-01-31T15:25:00Z",
    "metadata": {}
  }
}