Get transaction by UUID

Retrieve the details of a specific transaction using its UUID.

Get transaction by UUID

• GET /b2b-api/v/1/retail/transaction/{uuid}?group_id={groupId}

Headers

Header	Value
Accept	application/json; charset=utf-8
x-tu-authorization	protocol:TU1,accesskey:{{accessKey}},signedheaders:Content-Type;User-Agent;X-tu-date,signature:{{signature}}
Connection	close
X-tu-date	{{X-tu-date}}
User-Agent	{{userAgent}}
Content-Type	application/json; charset=utf-8

Parameters

Name	Value
group_id	{{groupId}}
uuid	Original transaction UUID

Request

curl --location -g '{{url}}/b2b-api/v/1/retail/transaction?group_id=EC&uuid=5efa759e-f81d-4596-9833-a64be78f92dd' \
--header 'Accept: application/json; charset=utf-8' \
--header 'x-tu-authorization: protocol:TU1,accesskey:{{accessKey}},signedheaders:Content-Type;User-Agent;X-tu-date,signature:{{signature}}' \
--header 'Connection: close' \
--header 'X-tu-date: {{X-tu-date}}' \
--header 'User-Agent: {USERAGENT}' \
--header 'Content-Type: application/json; charset=utf-8'

Response

Text

{
    "amount": 34900,
    "cardReaderSerialNumber": null,
    "date": "2026-07-23T07:34:46.000+00:00",
    "externalRRN": null,
    "externalSTAN": null,
    "externalTerminalID": null,
    "merchantName": null,
    "merchantNumber": null,
    "processingStatus": "COMPLETED",
    "receiptTags": {
	"AID": "",
        "AMOUNT_CENTS": "34900",
	"APPLICATION_LABEL": null,
	"ATC": null,
	"AUTH_CODE": null
	"BUDGET_PERIOD": "0",
	"CVM": "none",
	"DESCRIPTION": "620434210145",
	"PAN_WITH_BIN":	"**	****	null",
	"POS_ENTRY": "null",
	"RESULT_CODE": "00",
	"RRN": null,
	"TSI": null,
	"TVR": null
     },
    "resultCode": "00",
    "resultCodeDescription": "Approved",
    "setIMEI": null,
    "status": "APPROVED",
    "token": null,
    "tokenized": false
}

---

Get transaction by UUID with full receipt tags

• GET /b2b-api/v/1/retail/transaction/{uuid}?group_id={groupId}&full_receipt_tags=true

Headers - same as above.

Parameters

Name	Value
group_id	{{groupId}}
uuid	Original transaction UUID
full_receipt_tags	true - returns the extended receipt tag set shown below

Request

curl --location -g '{{url}}/b2b-api/v/1/retail/transaction/uuid=5efa759e-f81d-4596-9833-a64be78f92dd?group_id=EC&full_receipt_tags=true' \
--header 'Accept: application/json; charset=utf-8' \
--header 'x-tu-authorization: protocol:TU1,accesskey:{{accessKey}},signedheaders:Content-Type;User-Agent;X-tu-date,signature:{{signature}}' \
--header 'Connection: close' \
--header 'X-tu-date: {{X-tu-date}}' \
--header 'User-Agent: {USERAGENT}' \
--header 'Content-Type: application/json; charset=utf-8'

Response

Text

{
    "receiptTags":	{
        "PROVIDER_ORDER_ID": "",
        "CARD_BIN": "457023",
        "RC_DESCRIPTION": "Approved",
        "SETTLEMENT_DATE": "",
        "MERCHANT_CITY": "CAPE	TOWN",
        "ISSUER_COUNTRY_CODE": "",
        "REPLACEMENT_TERMINAL_ID": "",
        "INTERCHANGE": "Credit",
        "EXTENDED_TRX_TYPE": "",
        "APP_LABEL": "Visa Credit",
        "TX_TYPE": "DEBIT",
        "RRN": "RRN0000"
        "CARD_SEQ_NO": "",
        "TVR": "0000000000",
        "CVM_ABSA": "PIN Verified",
        "FORMATTED_AMOUNT": "ZAR 24.00",
        "PAN_WITH_8_DIGIT_BIN":	"",
        "PROCESSING_CODE": "",
        "STATUS": "APPROVED",
        "POS_ENTRY": "",
        "AMOUNT": "24.00",
        "TIP_LABEL": "",
        "TIMESTAMP": "1777451521000",
        "CARD_TRANSACTION_TYPE": "CONTACTLESS",
        "MESSAGE_2": "",
        "MESSAGE_1": "",
        "AID": "A0000000031010",
        "TOKEN": "",
        "CARD_DESCRIPTION": "Gold Business",
        "BATCH_NUMBER":	"0",
        "MERCHANT_REGION_CODE":	"09",
        "TIP_AMOUNT": "",
        "CASH_AMOUNT": "0.00",
        "REPLACEMENT_MERCHANT_ID": "",
        "BATCH_NO": "000",
        "TSI": "",
        "IAD": "06010A03A00000",
        "MERCHANT_NAME": "IPP	Test L3",
        "APPLICATION_LABEL": "Visa Credit",
        "DATE":	"2026-04-29T08:32:01.000+0000",
        "INVOICE_NUM": "",
        "RC": "00",
        "REPRINT": "",
        "RC_ALT": "00",
        "MERCHANT_COUNTRY_CODE": "ZA",
        "FORMATTED_CASH_AMOUNT": "ZAR 0.00",
        "CVM":	"PIN Verified",
        "AUTH_PROFILE":	"",
        "ACC_TYPE_DESC": "",
        "EXTERNAL_INVOICE_GUID": "abaaaaaa-893b-4737-b006-0e24b5cf5aaa",
        "RECEIPT_NUMBER": "",
        "8_DIGIT_CARD_BIN": "",
        "AUTH_CODE": "818570",
        "RESULT_CODE": "00",
        "EXTERNAL_TERMINAL_ID":	"",
        "DIGITS": "9014",
        "CARD_TYPE": "Business",
        "TERMINAL_ID": "91010099",
        "CRY": "4E1AAD5DD47AAB48",
        "APP_VERSION": "",
        "CURRENCY_CODE": "ZAR",
        "APSN":	"",
        "SEQ_NO": "000",
        "DESCRIPTION": "rrn2400",
        "PAN_HASH": "",
        "RC_ISO_DESCRIPTION": "Approved	or completed successfully",
        "AMOUNT_CENTS":	"2400",
        "SURCHARGE_AMOUNT": "0.00",
        "TX_TYPE_DESCRIPTION": "SALE",
        "BUDGET_PERIOD": "",
        "EXTERNAL_TRANSACTION_GUID": "abbbbbbb-3da8-476f-a0dd-d1295084ada6",
        "STAN":	"",
        "ABS_AMOUNT": "24.00",
        "ESC_BY_AUTH_CODE": "206	00	IH	818570",
        "ATC": "",
        "PAN_WITH_BIN":	"457023**	****	9014",
        "CUSTOMER_NAME": "",
        "EXTERNAL_TRANSACTION_DATETIME": "",
        "NAME_ON_CARD":	"",
        "PAN":	"****	****	****	9014",
        "TRANSACTION_INFO": "20600IH818570",
        "MERCHANT_ID": "910100000000001"
  },
  "date": "2026-04-29T08:32:01.000+00:00",
  "amount": 2400,
  "status": "APPROVED",
  "resultCode":	"00",
  "resultCodeDescription": "Approved or	completed successfully",
  "cardReaderSerialNumber": null,
  "merchantNumber": null,
  "merchantName": null,
  "uuid": null,
  "processingStatus": "COMPLETED",
  "externalTerminalID":	null,
  "externalRRN": "RRN2400",
  "setIMEI": null,
  "externalSTAN": null,
  "token": null,
  "tokenized": false
}