Skip to main content
GET
/
widget
/
transactions
/
{merchant_transaction_id}
GET /widget/transactions/{id}
curl --request GET \
  --url https://domain/widget/transactions/{merchant_transaction_id} \
  --header 'Authorization: <authorization>'
{
  "merchant_transaction_id": "<string>",
  "partner_user_id": "<string>",
  "type": "<string>",
  "status": "<string>",
  "currency": "<string>",
  "network": "<string>",
  "crypto_amount": "<string>",
  "fiat_currency": "<string>",
  "fiat_amount": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.proof.community/llms.txt

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

Returns the current, normalized status of a transaction.

​
Path parameters

​
merchant_transaction_id
string
required
The transaction identifier returned by POST /widget/session.

​
Headers

​
Authorization
string
required
Bearer token. Format: Bearer <client_token>.

​
Response

​
merchant_transaction_id
string
The transaction identifier.
​
partner_user_id
string
Your internal user identifier (echo of the session request).
​
type
string
buy or sell.
​
status
string
pending, processing, completed, failed, or cancelled. See Transaction Status.
​
currency
string
Crypto currency.
​
network
string
Blockchain network.
​
crypto_amount
string
Final crypto amount. Populated once the transaction reaches processing or completed.
​
fiat_currency
string
Fiat currency.
​
fiat_amount
string
Final fiat amount.
​
created_at
string
ISO 8601 timestamp (UTC).
​
updated_at
string
ISO 8601 timestamp of the last status update (UTC).

​
Examples

curl https://DOMAIN/widget/transactions/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer <client_token>"
Response
{
  "merchant_transaction_id": "550e8400-e29b-41d4-a716-446655440000",
  "partner_user_id": "user-123",
  "type": "buy",
  "status": "completed",
  "currency": "USDT",
  "network": "TRC20",
  "crypto_amount": "99.50",
  "fiat_currency": "EUR",
  "fiat_amount": "100.00",
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": "2026-04-01T10:03:45Z"
}

​
Errors

HTTPerrorcodeCause
401unauthorisedinvalid_tokenMissing or inactive client_token
404not_foundnot_foundThe merchant_transaction_id does not exist or does not belong to your partner