Get A Transaction

get

https://sandbox-api.softpoint.io/interface/v1/locations/YOUR_LOCATION_ID/get_transaction/95173942

Retrieves the full detail of a single transaction, including amounts, card and EMV data, processor identifiers, refundable balances, and the chain of related (parent/child) transactions.

Request Headers

Header	Required	Description
Authorization	Yes	Bearer YOUR_ACCESS_TOKEN

Request Parameters

Path Parameters:

Parameter	Type	Required	Description
location_id	integer	Yes	Location the transaction belongs to.
transaction_id	integer	Yes	The transaction to retrieve.

cURL Example

curl --request GET \
  --url https://sandbox-api.softpoint.io/interface/v1/locations/4000479/get_transaction/69625960 \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN"

Success Response

Abridged; the full object includes EMV tags and a parents array of related transactions.

{
  "id": 69625960,
  "location_id": 4000479,
  "payment_id": 68299586,
  "payment_status": "Approved",
  "total_amount": 1040,
  "base_amount": 1040,
  "tip_amount": 0,
  "tender_id_name": "Visa",
  "transaction_type_name": "Sale",
  "card_type": "VISA",
  "last4": "0043",
  "auth_code": "000000",
  "entry_type": "Chip",
  "refundable_base_amount": 1040,
  "can_partial_refund": false,
  "can_view_receipt": true,
  "status": "Approved",
  "created_datetime": "2025-09-11 17:09:13"
}

Response Fields

Field	Type	Description
id	integer	Transaction ID.
location_id	integer	Owning location.
payment_id	integer	Associated payment record.
payment_status / status	string	Result.
total_amount / base_amount / tip_amount	integer	Amounts in minor units.
tender_id_name	string	Tender used.
transaction_type_name	string	Type (for example, `Sale`).
card_type / last4	string	Card brand and last four.
auth_code	string	Authorization code.
entry_type	string	Card entry method.
emv_tags	string	JSON-encoded EMV tag data.
refundable_base_amount / refundable_tip_amount	integer	Amounts still refundable.
can_partial_refund	boolean	Whether a partial refund is allowed.
can_view_receipt	boolean	Whether a receipt is available.
parents	array	Related (parent) transactions in the chain.

Error Responses

Unauthorized / Invalid Token

{
  "error": {
    "code": 10759,
    "message": "Operation timed out. Please try again.",
    "details": { "Exception": "Token could not be parsed from the request." }
  }
}

Status Codes

Code	Description
200	Transaction returned
401	Token missing or invalid

Workflow Placement

A read used to inspect a transaction for receipts, EMV details, or to confirm refund eligibility before issuing a Webhook Refund.

Notes

Use refundable_base_amount and can_partial_refund to decide refund parameters.
Amounts are in minor units.

Common Mistakes

Calling without the location in the path.
Refunding more than refundable_base_amount.

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain

200OK

401Unauthorized