Skip to main content
GET
/
checkout
/
transactions
/
{transaction_id}
Get Transaction
curl --request GET \
  --url https://api.maash.io/checkout/transactions/{transaction_id} \
  --header 'x-api-key: <api-key>' \
  --header 'x-maash-user-type: <x-maash-user-type>'
{
  "data": {
    "transaction_id": "01KGMRGHWFXDKDM6W6956SFEMR",
    "merchant_id": "mx_123",
    "status": "completed",
    "ext_transaction_id": "txn_123456789",
    "session_id": "cs_01KGMRGHWFDYTS56WRBP8VGRGP",
    "expires_at": "2026-02-04T16:52:03.023Z",
    "created_at": "2026-02-04T16:42:03.023Z",
    "updated_at": "2026-02-04T16:54:08.687Z"
  }
}
Retrieves transaction details including the current payment status. Use this endpoint to check the status of a payment transaction from your server.

​
Authentication

​
x-api-key
string
required
Your merchant API key (e.g., mk_live_1234567890abcdef1234567890abcdef).
​
x-maash-user-type
string
required
Must be set to checkout.

​
Path parameters

​
transaction_id
string
required
The transaction identifier. Use the internal Maash transaction_id (ULID) returned when creating a checkout session, or your external ext_transaction_id (the value you passed as transaction_id when creating the session).

​
Query parameters

​
by_ext_transaction_id
string
When set to "true", the path parameter is treated as your external transaction ID (the value you passed as transaction_id when creating the session). Omit to look up by internal Maash transaction ID.

​
Response

​
data
object
​
transaction_id
string
Internal Maash transaction ID (ULID).
​
merchant_id
string
Merchant identifier associated with this transaction.
​
status
string
Current transaction status. One of: pending, awaiting_payment, confirming, completed, underpaid, overpaid, expired, failed, cancelled.
​
ext_transaction_id
string
Your external transaction identifier (the value you provided when creating the checkout session).
​
session_id
string
Checkout session ID. Use with Get Checkout Session for full payment details.
​
expires_at
string
Session expiration timestamp (ISO 8601).
​
created_at
string
Transaction creation timestamp (ISO 8601).
​
updated_at
string
Last update timestamp (ISO 8601).
For detailed payment information including token, chain, amounts, and transaction hash, use the Get Checkout Session endpoint with the session ID.
{
  "data": {
    "transaction_id": "01KGMRGHWFXDKDM6W6956SFEMR",
    "merchant_id": "mx_123",
    "status": "completed",
    "ext_transaction_id": "txn_123456789",
    "session_id": "cs_01KGMRGHWFDYTS56WRBP8VGRGP",
    "expires_at": "2026-02-04T16:52:03.023Z",
    "created_at": "2026-02-04T16:42:03.023Z",
    "updated_at": "2026-02-04T16:54:08.687Z"
  }
}

​
Status values

StatusDescription
pendingTransaction detected on-chain but not yet confirmed
awaiting_paymentPayment method selected, waiting for customer to send funds
confirmingPayment detected, waiting for required confirmations
completedPayment confirmed and settled successfully
underpaidPayment received but amount is below the expected amount (within tolerance)
overpaidPayment received but amount exceeds the expected amount (within tolerance)
expiredTransaction expired before payment was completed
failedPayment failed or was rejected
cancelledTransaction was cancelled