Skip to content
/
Get a transaction by its...

Get a transaction by its ID

Request

Security
APIKey or OAuth2
Path
transaction_idstringrequired
GET
/v2/transactions/{transaction_id}
curl -i -X GET \
  -u '<API_KEY>:​' \
  'https://api.test.trustap.com/v2/transactions/{transaction_id}'

Responses

OK

Bodyapplication/json
buyerobject(v2_transactions.User)
Example:
{
  "id": "9097",
  "is_guest": false
}
cancellationobject
client_idstringrequired
Example:"1234"
complaintobject
contains_shippingboolean
deadlinesobjectrequired

This property contains all possible actions that have associated deadlines for completion. Actions with null do not have deadlines currently pending.

Example:
{
  "complaints": "2019-12-25T15:00:00Z"
}
descriptionstringrequired
Example:"Soccer ticket"
eventsobject(v2_transactions.Events)required
Example:
{
  "by_key": {
    "created": "2019-12-25T09:00:00Z",
    "delivered": "2019-12-25T16:00:00Z",
    "funds_released": "2019-12-25T17:00:00Z",
    "joined": "2019-12-25T10:00:00Z",
    "paid": "2019-12-25T11:00:00Z",
    "payment_accepted": "2019-12-25T12:00:00Z"
  },
  "by_time": []
}
funds_releaseobject
Example:
{
  "refunds": [],
  "released_to_seller": false
}
idstring, (type_id)required
Example:"tx_21066"
join_codestring
metadataobject

Arbitrary key-value string pairs for adding extra information to transactions.

order_issueobject
pricingobject(v2_transactions.Pricing)required
Example:
{
  "amount": 1000,
  "amount_extra": 0,
  "currency": "eur",
  "fees": {
    "buyer": 110,
    "buyer_client": 10,
    "international_payment": 20,
    "seller": 0,
    "seller_client": 5
  }
}
reviewobject
Example:
{
  "approved": true,
  "outcome_reason": "Not fraudulent."
}
sellerobject(v2_transactions.User)
Example:
{
  "id": "9097",
  "is_guest": false
}
statusstring(v2_transactions.Status)required
Enum:"created""joined""rejected""cancelled""paid""review_flagged""payment_accepted""complaint_submitted""complaint_period_ended""refunded"
Example:"funds_released"
trackingobject(v2_transactions.Tracking)
Response
{
  "buyer": {
    "id": "1-def29dfe-8626-48a2-8863-b6fdf2b96ff1",
    "is_guest": true
  },
  "client_id": "5ad5451d-70c7-43c6-86c9-e1d90556856c",
  "deadlines": {
    "complaints": null
  },
  "description": "Trustap socks",
  "events": {
    "by_key": { … },
    "by_time": [ … ]
  },
  "funds_release": {
    "refunds": [],
    "released_to_seller": false
  },
  "id": "tx_01kysvfb1ff1j8st5akj3vqknf",
  "metadata": {},
  "payment_link": "https://actions.stage.trustap.com/transactions/tx_01kysvfb1ff1j8st5akj3vqknf/pay",
  "pricing": {
    "amount": 20000,
    "amount_extra": 200,
    "amount_postage": 500,
    "currency": "gbp",
    "fees": { … },
    "postage_bearer": "buyer"
  },
  "seller": {
    "id": "8e5cbedc-e57b-42e5-a3bd-2f9ced81a2d0",
    "is_guest": false
  },
  "status": "joined"
}