curl --request GET \
--url https://dev.sbx.imprint.co/v2/transactions/{transaction_id} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://dev.sbx.imprint.co/v2/transactions/{transaction_id}"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://dev.sbx.imprint.co/v2/transactions/{transaction_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dev.sbx.imprint.co/v2/transactions/{transaction_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dev.sbx.imprint.co/v2/transactions/{transaction_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dev.sbx.imprint.co/v2/transactions/{transaction_id}")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dev.sbx.imprint.co/v2/transactions/{transaction_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"id": "E777214A-2D11-4CAD-9E8F-E1BD71D9FE67",
"customer_id": "9B5E1EE0-2E1C-46E7-81B9-3C3917204BE4",
"payment_method_id": "DCBFC736-2286-42DD-897D-160DCA80AED2",
"amount": 123,
"currency": "USD",
"status": "APPROVED",
"network_transaction_id": "<string>",
"created_at": "2025-02-13T19:08:07.000Z",
"intent_id": "5B30532B-5B5B-4826-8DE2-429C57B705FD",
"authorization_code": "ABCD",
"purchase_method": "CHIP",
"partner_transaction_id": "<string>",
"updated_at": "2025-02-13T19:08:07.000Z",
"merchant": {
"network_id": "234923454545",
"name": "Target",
"category": "Grocery Stores",
"category_code": "5411",
"address": {
"street_line1": "123 Main St",
"street_line2": "Apt 4B",
"city": "San Francisco",
"state": "CA",
"postal_code": "94105",
"country": "USA"
}
},
"metadata": {
"platform_version": "2.1.0"
},
"events": [
{
"event_id": "B2D4A1C9-7F3E-4C8A-9E61-2A5B8D0F4C17",
"status": "APPROVED",
"amount": 5000,
"created_at": "2025-02-13T19:08:07.000Z"
}
]
}{
"path": "/v2/customers",
"details": [
"email: must be a well-formed email address"
],
"error": "Bad Request",
"status": 400,
"timestamp": "2025-01-20T18:18:22.923+00:00"
}{
"type": "TRANSACTION_FOUND_ERROR",
"message": "Transaction intent not found for provided ID: txn_123",
"param": "transaction_id"
}Retrieve a transaction
Retrieves the details of an existing transaction by id
curl --request GET \
--url https://dev.sbx.imprint.co/v2/transactions/{transaction_id} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://dev.sbx.imprint.co/v2/transactions/{transaction_id}"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://dev.sbx.imprint.co/v2/transactions/{transaction_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dev.sbx.imprint.co/v2/transactions/{transaction_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dev.sbx.imprint.co/v2/transactions/{transaction_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dev.sbx.imprint.co/v2/transactions/{transaction_id}")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dev.sbx.imprint.co/v2/transactions/{transaction_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"id": "E777214A-2D11-4CAD-9E8F-E1BD71D9FE67",
"customer_id": "9B5E1EE0-2E1C-46E7-81B9-3C3917204BE4",
"payment_method_id": "DCBFC736-2286-42DD-897D-160DCA80AED2",
"amount": 123,
"currency": "USD",
"status": "APPROVED",
"network_transaction_id": "<string>",
"created_at": "2025-02-13T19:08:07.000Z",
"intent_id": "5B30532B-5B5B-4826-8DE2-429C57B705FD",
"authorization_code": "ABCD",
"purchase_method": "CHIP",
"partner_transaction_id": "<string>",
"updated_at": "2025-02-13T19:08:07.000Z",
"merchant": {
"network_id": "234923454545",
"name": "Target",
"category": "Grocery Stores",
"category_code": "5411",
"address": {
"street_line1": "123 Main St",
"street_line2": "Apt 4B",
"city": "San Francisco",
"state": "CA",
"postal_code": "94105",
"country": "USA"
}
},
"metadata": {
"platform_version": "2.1.0"
},
"events": [
{
"event_id": "B2D4A1C9-7F3E-4C8A-9E61-2A5B8D0F4C17",
"status": "APPROVED",
"amount": 5000,
"created_at": "2025-02-13T19:08:07.000Z"
}
]
}{
"path": "/v2/customers",
"details": [
"email: must be a well-formed email address"
],
"error": "Bad Request",
"status": 400,
"timestamp": "2025-01-20T18:18:22.923+00:00"
}{
"type": "TRANSACTION_FOUND_ERROR",
"message": "Transaction intent not found for provided ID: txn_123",
"param": "transaction_id"
}Authorizations
Basic HTTP authentication. Allowed headers-- Authorization: Basic <base64(api_key_id:api_key_secret)>
Path Parameters
The unique identifier for the transaction
"4E6FE207-53E5-4EC0-BF51-5923BE5CEE2F"
Query Parameters
Related data to include on each transaction, as a comma-separated list. Supported values:
events — the transaction's lifecycle events (authorization, captures, refunds, confirmed disputes),
each with the same event_id delivered in the Transaction Event Notification. Omit to receive the
transaction without events. Unknown values return 400. See
Retrieve a transaction's events.
Related data that can be included on a transaction with the expand query parameter.
events Response
Transaction retrieved successfully
"E777214A-2D11-4CAD-9E8F-E1BD71D9FE67"
The imprint customer ID for the transaction
"9B5E1EE0-2E1C-46E7-81B9-3C3917204BE4"
Identifies the payment method used for the transaction
"DCBFC736-2286-42DD-897D-160DCA80AED2"
Transaction amount in min units.
The 3-character currency code of the amount in ISO 4217 format (e.g., "USD")
"USD"
APPROVED, UPDATED, VOIDED, CAPTURED, REFUNDED "APPROVED"
The network's unique identifier for the transaction. Examples include Visa Transaction ID, Mastercard Trace ID, and American Express Network Reference ID
the RFC-3339 timestamp when the transaction was created
"2025-02-13T19:08:07.000Z"
Reference to the original transaction intent
"5B30532B-5B5B-4826-8DE2-429C57B705FD"
Code authorizing the transaction.
"ABCD"
How the purchase was completed.
CHIP, CONTACTLESS, KEYEDIN, ONLINE, SWIPE, QRCODE, OCR, UNKNOWN "CHIP"
The partner's unique transaction id
the RFC-3339 timestamp when the transaction was last updated
"2025-02-13T19:08:07.000Z"
Show child attributes
Show child attributes
{ "platform_version": "2.1.0" }
Events in the transaction's lifecycle, oldest first. Present only when requested with expand=events.
Show child attributes
Show child attributes