Skip to main content
GET
/
v1
/
transactions
/
{id}
Get a transaction
curl --request GET \
  --url https://api.saturnshift.io/v1/transactions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "object": "transaction",
  "id": 1377,
  "merchant_id": 116,
  "status": "paid",
  "raw_status": "paid",
  "amount_status": "EXACT",
  "asset": "USDC",
  "currency": "USD",
  "amount": {
    "gross": "1.13",
    "net": "1.00",
    "expected": "1.13",
    "psp_fee": "0.08",
    "gas_fee": "0.05",
    "bridge_fee": "0.00"
  },
  "networks": {
    "payment": "BASE",
    "settlement": "BASE"
  },
  "tx_hashes": {
    "source": "0x...",
    "bridge": "<string>",
    "settlement": "0x..."
  },
  "customer_email": "buyer@example.com",
  "external_reference": "order_10432",
  "created_at": "2023-11-07T05:31:56Z",
  "paid_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials. Request a token from /oauth/token and send it as Authorization: Bearer <token>.

Path Parameters

​
id
integer
required

Response

The transaction

​
object
string
Example:

"transaction"

​
id
integer
Example:

1377

​
merchant_id
integer
Example:

116

​
status
string

Normalized status: paid (settled to the merchant's external wallet), pending, failed, refunded, partially_refunded.

Example:

"paid"

​
raw_status
string

The underlying internal status (for example succeeded = held in the custodial wallet, paid = sent to the merchant).

Example:

"paid"

​
amount_status
enum<string> | null
Available options:
EXACT,
UNDERPAID,
OVERPAID
Example:

"EXACT"

​
asset
string | null
Example:

"USDC"

​
currency
string | null
Example:

"USD"

​
amount
object

Decimal amounts as strings.

​
networks
object
​
tx_hashes
object
​
customer_email
string | null
Example:

"buyer@example.com"

​
external_reference
string | null
Example:

"order_10432"

​
created_at
string<date-time> | null
​
paid_at
string<date-time> | null