Recover transaction using canonical merchant reference

Recovery endpoint for partner timeout scenarios. Looks up a transaction by partner-scoped canonical merchant_reference and returns the same snapshot shape as GET /transactions/{id}.

GET /partner/transactions/reference/{merchant_reference}

Recover transaction using canonical merchant reference

cURL

curl --request GET \
  --url https://dev.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference} \
  --header 'X-API-KEY: <api-key>'

200

{
  "data": {
    "amount": "161500.00",
    "confirmations": null,
    "confirmed_at": null,
    "created_at": "2026-02-12T11:55:00Z",
    "crypto_amount": "100.00",
    "crypto_currency": "usdt",
    "deposit_address": "TUr4xexampleaddress",
    "deposit_id": null,
    "deposit_status": null,
    "expires_at": "2026-02-12T12:00:00Z",
    "id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "merchant_id": "mrc_001",
    "merchant_reference": "order-4551",
    "network": "trc20",
    "rate": "1615.00",
    "received_at": null,
    "required_confirmations": null,
    "status": "awaiting_deposit",
    "terminal_id": "term_01",
    "updated_at": "2026-02-12T11:55:00Z"
  },
  "success": true
}

Authorizations

X-API-KEY · string · header · required

Path Parameters

merchant_reference · string · required

Partner merchant reference

Response

200

application/json

Transaction retrieved

Standard API response wrapper for all successful responses

data · object · required

Detailed partner transaction snapshot for TSQ and recovery reads.

Show child attributes

success · boolean · required

Indicates if the request was successful

Example:

"true"

message · string | null

Optional message for additional information