Status – Trust Payments

Use this transaction to retrieve the status of a previously submitted transaction. This can be used in cases such as communications or hardware failures.

Endpoint : /status

Use the refid to identify the original authorization.

Status Request

{
"refid":"1234567890",
"siteid":"1234",
"txndate":"2023-02-01:16:13:20"
}

Request field specification

	Field	Format	Description
Required	refid	String (min length: 1) e.g. 1234567890	The unique identifier of a transaction to be queried.
Required	siteid	String (min length: 1) e.g. 1234	Unique identification code supplied by Trust Payments.
Required	txndate	String e.g. 2020-03-01:10:20:05	The date and time the queried transaction was processed.

Status Response

{
"authcode":"1234567890",
"cardtype":"VISA",
"errorcode":"1234",
"errormessage":"Error",
"finalamount":"1234",
"last4":"1234",
"refid":"1234567890",
"resultcode":"Approved",
"siteid":"1234",
"topuptoken":"1234567890",
"type":"sale"
}

Response field specification

	Field	Format	Description
Returned	refid	String e.g. 1234567890	The unique identifier of the queried transaction.
Returned	resultcode	String e.g. Approved	The result of the queried transaction from the acquirer. Possible values are: Approved Cancelled Connection Timeout Declined Error Pending Terminal Busy
Returned	siteid	String e.g. 1234	Unique code to identify the Trust Payments site used to process the queried transaction.
Returned	type	String e.g. Sale	The type of request being queried.
Conditional	authcode	String e.g. 1234567890	The authorisation code of the queried transaction. Returned if available.
Conditional	cardtype	String e.g. VISA	Contains the card type used for the queried transaction. Returned if available.
Conditional	errorcode	Integer e.g. 1006	This code helps you identify the error if the queried transaction was not processed successfully. Info on error handling. Returned if available.
Conditional	errormessage	String e.g. Invalid amount	The field returns details of an error if the queried transaction was not processed successfully. Info on error handling Returned if available.
Conditional	finalamount	String e.g. 1234	The final amount authorised for the transaction in main units (e.g. £20 would be returned as 20.00). Returned if available.
Conditional	last4	String e.g. 1234	The last 4 digits of the customer debit/credit card used to facilitate the queried transaction. Returned if available.
Conditional	topuptoken	String e.g. 1234567890	A token that links the previous authorisation to this one. Allows the funds reserved to be increased. Returned if available.