--- title: "Read transaction" method: GET path: "/api/v2/transaction/{id}" tags: ["Transaction"] --- # Read transaction `GET /api/v2/transaction/{id}` Get a transaction ## Path parameters - `id` string, required ## Response `200` Transaction - GatewayTransaction - `id` string — The unique transaction id. This is the identifier to be used for locating the transaction and for reconciliation and auditing. - `amount` string — Amount including decimal place. - `acquirer_authorizing_network_id` string — The Network ID returned in the original authorization response. - `acquirer_authorizing_network_id_descriptor` string — The name or descriptor that corresponds with the `acquirer_authorizing_network_id` returned in the original authorization response. - `acquirer_response_code` string — Acquirer response returned during the authorisation. - `acquirer_response_message` string — The response description generated by the acquirer corresponding to the acquirer response code. - `currency_code` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BOV' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYR' | 'BZD' | 'CAD' | 'CDF' | 'CHE' | 'CHF' | 'CHW' | 'CLF' | 'CLP' | 'CNY' | 'COP' | 'COU' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LTL' | 'LVL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRO' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MXV' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLL' | 'SOS' | 'SRD' | 'SSP' | 'STD' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'USN' | 'USS' | 'UYI' | 'UYU' | 'UZS' | 'VEF' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XAG' | 'XAU' | 'XBA' | 'XBB' | 'XBC' | 'XBD' | 'XCD' | 'XDR' | 'XOF' | 'XPD' | 'XPF' | 'XPT' | 'XTS' | 'XXX' | 'YER' | 'ZAR' | 'ZMK' | 'ZMW' | 'BTC' — Three-letter ISO 4217 alphabetical currency code. e.g. USD. Values correspond to ISO 4217. - `city` string — The city resolved from the customer's ip address. - `country_code` string — The country code resolved from the customer's ip address. - `created_at` string — The time at which the transaction was created - `customer` string — The ID of a customer. - `customer_ip` string — The IP Address v4 where the event originated. - `dynamic_descriptor` string — A short reference / descriptor that will show up on the customers bank statement. Please refer to the card payment integration guide for the format requirements, which are specific per card processor. - `geo_location` string[] - `payment_product` string — The payment product corresponding to this transaction. - `payment_product_type` 'Affirm' | 'Amex' | 'Crypto' | 'Diners Club International' | 'Discover' | 'JCB' | 'Klarna' | 'Maestro' | 'Mastercard' | 'OP Online Payment' | 'Swish' | 'Unknown' | 'Visa' — The payment product type corresponding to this transaction. Fees applied to the transaction, is based on the payment product - `processor_reference` string — Reference identifying the transaction, as provided by the processor. - `status` string — Display transaction type and status, including if partial, of the related order transaction. E.g. 'PARTIAL CAPTURE AUTHORIZED'. - `transaction_type` 'AUTHORISATION' | 'BALANCE' | 'CANCEL' | 'CAPTURE' | 'CARD_ACTIVATION' | 'CARD_DEACTIVATION' | 'CARD_VERIFICATION' | 'CASH_ADVANCE' | 'CASH_DEPOSIT' | 'DECLINED' | 'DELAYED_CHARGE' | 'EXTEND' | 'ISSUER_INSTALMENT_SELECTION' | 'LOAD' | 'NO_SHOW' | 'NON_FINANCIAL' | 'PREAUTH' | 'PREAUTH_COMPLETION' | 'PREAUTH_INCREMENT' | 'RATE' | 'REAUTHORISATION' | 'REFUND' | 'SALE' | 'UNLOAD' | 'VOID' — A type indicator for the main operation or service that was performed as part of the transaction event. - `transaction_status` 'APPROVED' | 'AUTHENTICATING' | 'AUTHORISED' | 'AWAITING_INVOICE' | 'CANCELLED' | 'CONFIRMED' | 'COMPLETED' | 'CUSTOMER_ACCEPTED' | 'DECLINED' | 'DEFERRED' | 'DISPUTED' | 'EXCEPTION' | 'EXPIRED' | 'FAILED' | 'INITIATED' | 'ON_HOLD' | 'PARTIALLY_REFUNDED' | 'RECEIVED' | 'RECONCILED' | 'RECONCILIATION_FAILED' | 'REFUNDED' | 'REJECTED' | 'REPEATING' | 'REVERSED' | 'REVERSE_ERROR' | 'REVERSING' | 'ROUTING' | 'SENT' | 'SETTLED' | 'SETTLEMENT_FAILED' | 'SETTLEMENT_REQUESTED' | 'SUBMITTED' | 'TIMED_OUT' | 'UNMATCHED' — This represents the available states that a transaction may have. At any given point it may only have a single state. - `parent_id` string — The transaction id of a parent transaction, where the current transaction is an action based on a previous transactions. - `reason_code` string — A reason code assigned by the acquiring platform; '0000' in case of success. - `card_brand` string — Represents a Card type or brand. It should correspond to a consistent name, the list of standard names is as follows: Value | Description ------|------------- AMEX|American Express CB|Carte Bancaires DINERS|Diners Club International DISCOVER|Diners Club Discover JCB|Japan Credit Bureau MAESTRO|Multi-national Debit (MasterCard) MASTERCARD|MasterCard VISA|Visa UPI|Union Pay International GIFT_CARD|Gift Card (Generic) PLCC|Private Label Credit Card **Other local schemes as applicable**. Enter a pre-defined name to represent the scheme or type. **Note**: 1. For gift cards, card brand is mandatory and the value should be GIFT_CARD. 2. This parameter is mandatory for dual branded cards. - `shipping_information` object — The address where the purchased goods should be delivered to.
Please use customer_details.shipping. - `address` string, required — Street address of the recipient. - `city` string, required — City of the recipient. - `country` string, country-code, required — A 2-letter ISO3166 alpha-2 country code for the address. - `postal_code` string, required — A postal code for the address. - `email` string, email — A valid internationalized email address, as defined by RFC 5322, RFC 6530, and other RFCs. Due to RFC 5321, an email address can be up to 254 characters long even though up to 64 characters are allowed before and 255 characters are allowed after the @ sign. This pattern verifies only that the string contains an unquoted @ sign. See https://tools.ietf.org/html/rfc5322#section-3.4.1. - `first_name` string — First name of the recipient. - `last_name` string — Last name of the recipient. - `phone` number — Numbers only, no dash or any other separator. - `state` string — A region / state / province for the address. - `customer_details` CustomerDetailsDto — Customer information containing billing and shipping details. - `title` string — The prefix to the party name. This is sometimes referred to as a title, salutation or appellation. - `first_name` string — The first name of the Customer. This may be a proper name or some form of entity name or nickname. - `middle_name` string — The middle name of the Customer. This may be a proper name or some form of entity name or nickname. - `last_name` string — The last name or family name of the Customer. - `company_name` string — Where the Customer is an organisation or company this name should be used rather than the firstName lastName - `phone_number` string — Customers phone number for billing address. - `email_address` string, email — Customer email address, which might be used during refund flow. - `shipping` CustomerDetailsShippingInformationDto — The address where the purchased goods should be delivered to. - `address` string, required — Street address of the recipient. - `city` string, required — City of the recipient. - `country` string, country-code, required — A 2-letter ISO3166 alpha-2 country code for the address. - `postal_code` string, required — A postal code for the address. - `email` string, email — A valid internationalized email address, as defined by RFC 5322, RFC 6530, and other RFCs. Due to RFC 5321, an email address can be up to 254 characters long even though up to 64 characters are allowed before and 255 characters are allowed after the @ sign. This pattern verifies only that the string contains an unquoted @ sign. See https://tools.ietf.org/html/rfc5322#section-3.4.1. - `first_name` string — First name of the recipient. - `last_name` string — Last name of the recipient. - `phone` string — Telephone number. - `state` string — A region / state / province for the address. - `billing` object — The address of billing. - `address_1` string — Customer's primary billing address information. - `address_2` string — Customer's secondary billing address information. - `address_3` string — Customer's third billing address information. - `city` string — Customer's city on their billing address - `country` 'ZZ' | 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' — The ISO 3166-1 alpha-3 country code. - `phone` string — Customer's phone number for billing address. This should be un formatted without hyphens. (e.g. 4422345678) - `postal_code` string — Customer's postal code of their billing address. - `state` string — Customer's state or province of their billing address. (e,g. Ohio = OH, Texas = TX) - `language` string — The BCP-47 language tag. The tag is composed of: * The ISO-639 alpha-1 or ISO-639 alpha-2 language code * (Optional) The ISO-15924 script tag * The ISO-3166 alpha-2 country code `NOTE:`The value is case-insensitive, so for example "he" and "HE" should be considered equal. - `merchant_reference` string — A reference specified by the merchant to identify the transaction. - `user_agent` string — The full user agent string of the device the customer used to submit the transaction. - `arn` string — Acquirer reference number. Generated by the Acquirer at the time of clearing for card transactions. - `authorization_code` string — An authorization code assigned by the processing platform. - `avs_result` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'I' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'R' | 'S' | 'T' | 'U' | 'W' | 'X' | 'Y' | 'Z' — Address verification services result, which provides information about the outcome of the AVS check. The full list of codes and descriptions can be found here - `created_by` string — The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order. - `cvv_present` boolean — True if the card was used with a cvv. - `cvv_result` '0' | '1' | '2' | '3' — CVV verification result, as returned by the processor. Refer to Key Concepts->Cards for understanding of the values. - `processor_payer_id` string — This is the id used by the processor (e.g. an APM provider) for the payer. - `pos_device_id` string — dentifier of the POS device used for the transaction. - `rrn` string — Retrieval Reference Number, is a transaction identifying reference number that is designated by the card acceptor system. - `shopper_interaction` 'ecommerce' | 'pos' | 'moto' | 'mail_order' | 'telephone_order' | 'unknown' — Determines the point of sale of a customer. Possible values: pos, moto, mail_order, telephone_order, ecommerce and cont_auth. - `stan` string — A number assigned by a transaction initiator(originator) to assist in identifying a transaction uniquely. The trace identifier remains unchanged for all messages within a two-message exchange, e.g. request/repeat and response. This property can be used to store the System trace audit number (STAN) as used in the ISO8583 specification (DE 11). Note the contents of this field are mandatory in many specifications - ISO8583, AS2805 (DE11) and are often related to the Retrieval Reference Number (RRN) as also specified in ISO8583. Unfortunately due to the usage in these earlier specifications, a STAN was limited to 6 digits which means that it cannot be utilised as a general purpose unique id. In addition, this entry is often printed on the receipt at a POI. ISO8583 DE11. - `threed_authentication` object — MPI authentication data. Please refer to the integration guide for information on its usage. - `eci_flag` '00' | '01' | '02' | '03' | '04' | '05' | '06' | '07' - `enrolled` string — Possible Values: Y - Yes, Bank is participating in 3-D Secure protocol and will return the ACSUrl. N - No, Bank is not participating in 3-D Secure protocol. U - Unavailable, the DS or ACS is not available for authentication at the time of the request. B - Bypass, merchant authentication rule is triggered to bypass authentication in this use case. NOTE: If the Enrolled value is NOT Y, then the Consumer is NOT eligible for Authentication. - `cavv` string — Base64-encoded values of 28 or 32 characters. Hex-encoded values of 40 or 48 characters. - `cavv_algorithm` string — Indicates the algorithm used to generate the CAVV value.Please refer to the integration guide for information on its usage. - `pares_status` string — Possible Values: Y - Successful Authentication. U - Unable to Complete Authentication A - Successful Attempts Transaction. - `xid` string — Transaction identifier resulting from authentication processing.Please refer to the integration guide for information on its usage. - `ds_transaction_id` string — The unique transaction identifier assigned by the Directory Server. Supported for 3D Secure v2 only. - `threeds_version` '1.0.2' | '2.1.0' | '2.2.0' - `masked_card_number` string — Masked PAN number, the first 6 and last 4 digits of the card. - `promo_code` string — A code defined by the merchant that affects the calculation of the total amount. - `payment_summary` object - `captured_amount` string — Amount including decimal place. - `token_details` TokenDetailsPartial - `reuse_token_type` 'CHASE' | 'INTERNAL' | 'TAVE' — The type of Reuse Token. This indicates if the reuse token is an internal Verifone type or an external Third-Party type.
**Note**: `reuse_token_details` is **mandatory** when `reuse_token_type` is set to `TAVE` or `CHASE`. - `reuse_token` string — The Verifone issued reuse token used to represent the previously stored cardholder data. - `analytics_token` string — A token that cannot be reversed to Card Holder data. This is included in a Payment for auditing and tracking purposes. - `entity_id` string, uuid-flexible — The identifier of merchant entity you want to process the transaciton is already processed. - `acquirer_merchant_id` string — The Code identifying the card acceptor as issued by the Acquiring Institution. This may not be unique across institutions. Also referred to as the MID. ISO8583 - DE 42. This field is for the MID used between VF and a 3rd party acquirer or processor. - `description` string — The description/message associated with this transaction. This will contain the refund reason for refunds. - `detailed_amount` ListDetailedAmount — A structure that represents a breakdown all of the different amounts that may appear on a single transaction. - `gratuity_amount` string — Amount including decimal place. - `cashback_amount` string — Amount including decimal place. - `donation_amount` string — Amount including decimal place. - `tax_amount` string — Amount including decimal place. - `surcharge_amount` string — Amount including decimal place. ## Other responses - `400` — Bad Request - `401` — Unauthorised - `403` — Forbidden - `404` — Not Found - `500` — Internal Server Error --- [API](https://skmtc.net/verifone/apis/checkout-api.md) · [All operations](https://skmtc.net/verifone/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verifone/checkout-api/revisions/ed8dc1f12a5a/schema)