Skip to content
nsin nsin nsin Docs

Get one wallet transaction

GET
/wallet/transactions/{id}
 
curl --request GET \
  --url https://api.nsin.ir/wallet/transactions/1 \
  --header 'Authorization: Bearer <token>'

The ledger row, plus — for a traffic charge — the per-domain byte and cost breakdown of that billing window. A traffic charge is billed once per account per window, summed across all your domains, so by_domain is how you attribute it.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
integer

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Transaction detail.

Media type application/json
object
id
integer
wallet_id
integer
user_id
integer
type
string
Allowed values: topup purchase refund admin_adjust
amount_rials

Signed — positive credits, negative debits.

integer
balance_after
integer
description
string
ref_type

What the row refers to — payment, subscription, traffic or manual.

string
ref_id
integer
ref_code

Payment gateway reference, for top-ups.

string
created_at
string format: date-time
domain_id

Set on traffic charges.

integer
domain_name

Set on traffic charges.

string
node
string
billing_window_key

Identifies the billing window a traffic charge covers.

string
by_domain

Per-domain contribution to this charge. Traffic charges only.

Array<object>

One domain’s share of a single traffic charge.

object
domain_id
integer
domain_name
string
cached_bytes
integer
proxied_bytes
integer
direct_bytes
integer
bypass_bytes

Legacy two-tier column, on historical rows only.

integer
charged_rials
integer
cached_bytes

Total across by_domain.

integer
proxied_bytes

Total across by_domain.

integer
direct_bytes

Total across by_domain.

integer
bypass_bytes

Total across by_domain.

integer
Example 
{
  "type": "topup"
}

401

Section titled “401 ”

Missing, malformed, revoked or expired API key — or the owning account is inactive.

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Examples
Example invalidKey 
{
  "error": "invalid API key"
}

404

Section titled “404 ”

No such transaction on this account.

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Example 
{
  "error": "read-only API key"
}

429

Section titled “429 ”

The key exceeded its request budget (300 requests per minute by default).

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Examples
Example limited 
{
  "error": "rate limit exceeded"
}