Look up one transaction (audit and support; not used in the money path)

GET

/transactions/{transaction_id}

const url = 'https://operator.example.com/game-wallet/v1/transactions/example';
const options = {method: 'GET', headers: {'webhook-signature': '<webhook-signature>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://operator.example.com/game-wallet/v1/transactions/example \
  --header 'webhook-signature: <webhook-signature>'

Authorizations

standardWebhooks

Parameters

Path Parameters

transaction_id

required

string

<= 128 characters

Responses

200

Transaction as booked

application/json

object

transaction_id

required

string

type

required

string

Allowed values: debit credit rollback

status

required

ok — booked now or earlier (also for rollbacks with nothing to reverse)
insufficient_funds — debit not booked; include balance
session_invalid / player_blocked / limit_exceeded — debit not booked
duplicate_mismatch — same id, different content; nothing booked
reference_not_found — credit whose referenced debit was never booked or was rolled back
rolled_back — debit arriving after its rollback; not booked
retry — transient failure, nothing booked; the platform resends the same transaction

string

Allowed values: ok insufficient_funds session_invalid player_blocked limit_exceeded duplicate_mismatch reference_not_found rolled_back retry

amount

Integer amount in minor units, as a decimal string.

string

/^-?[0-9]{1,19}$/

balance

Integer amount in minor units, as a decimal string.

string

/^-?[0-9]{1,19}$/

rolled_back

boolean

processed_at

string format: date-time

Example

{
  "type": "debit",
  "status": "ok",
  "amount": "1500",
  "balance": "1500"
}

404

transaction_not_found — never received

application/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

code

required

string

Allowed values: invalid_signature invalid_launch_code malformed_request player_not_found transaction_not_found rate_limited unavailable internal not_found

detail

string

Example

{
  "type": "https://game-platform.dev/problems/rate_limited",
  "code": "invalid_signature"
}

default

RFC 9457 problem details

application/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

code

required

string

Allowed values: invalid_signature invalid_launch_code malformed_request player_not_found transaction_not_found rate_limited unavailable internal not_found

detail

string

Example

{
  "type": "https://game-platform.dev/problems/rate_limited",
  "code": "invalid_signature"
}