UPP Docs
Transaction

Get a transaction

GET
/transactions/{transactionId}

Authorization

merchantApiKeymerchantTimestampmerchantNoncemerchantSignature
headerX-API-KEY<token>

Merchant API key (starts with upk_, also accepts api-key); signing headers are also required

headerX-Timestamp<token>

Unix timestamp in seconds, within 300 seconds of server time

headerX-Nonce<token>

Unique per request; cannot be reused with the same credential during the timestamp validity window

headerX-Signature<token>

Hex HMAC-SHA256 signature (either letter case) of the method, full path, timestamp, nonce and body digest

Path Parameters

transactionId*string

Transaction ID (starts with txn_)

Response Body

Transaction

application/json
  1. response
id*string

Transaction ID (starts with txn_)

type*TransactionType

Transaction type: deposit deposit, withdrawal withdrawal (crypto withdrawal, local payout and SWIFT), withdrawal_reversal credit back of a completed withdrawal that was returned, card_issuance card issuing (initial funding and issuing fee), card_funding card top-up or withdrawal, card_refund card balance returned after termination, exchange exchange, adjustment adjustment by UPP

Value in"deposit""withdrawal""withdrawal_reversal""card_issuance""card_funding""card_refund""exchange""adjustment"
status*TransactionStatus

pending in progress (funds not yet available or held), completed reflected in the available balance, failed ended without affecting the available balance, reversed reversed after completion (reserved, not produced yet; a returned withdrawal keeps its transaction completed and gets a separate withdrawal_reversal transaction)

Value in"pending""completed""failed""reversed"
amount*string

Signed amount: positive for inflows, negative for outflows; at the currency's precision

currency*string
fee*string

Fee, non-negative

fee_currency*string

Fee currency; for exchanges the bought currency, otherwise the same as currency

net*string

Final effect on the available balance in currency; amount − fee when the fee is in the same currency as amount, otherwise (exchanges) amount

counter_amount*|

Amount bought in an exchange (after the fee); for local payouts and SWIFT, the amount the beneficiary receives; null for other types

counter_currency*|

Currency of counter_amount

customer_id*|

Customer ID (starts with cus_) for operations done on behalf of a customer

merchant_reference*|

Your order number

description*string|null
created_at*string
Formatdate-time
completed_at*|
Formatdate-time
Example Request
curl -X GET 'https://sandbox.getupp.net/api/v1/transactions/string'
Example Response
{  "id": "txn_01m5gxd9fpy6pdbefdckrnvrej",  "type": "deposit",  "status": "completed",  "amount": "25.00",  "currency": "USDT",  "fee": "0.00",  "fee_currency": "USDT",  "net": "25.00",  "counter_amount": null,  "counter_currency": null,  "customer_id": null,  "merchant_reference": null,  "description": null,  "created_at": "2026-10-22T04:20:19.000+00:00",  "completed_at": "2026-10-22T04:20:19.000+00:00"}