--- title: "Get single transaction" method: GET path: "/transactions/{transactionId}" tags: ["Transactions"] --- # Get single transaction `GET /transactions/{transactionId}` ## Path parameters - `transactionId` string, required ## Headers - `Accept-Version` string, required — Specifies the API version to use for this request. ## Response `200` Return transaction - object - `id` string — Reap’s internal ID for the balance change record. - `card_id` string — The unique identifier of the card for which transaction details are being retrieved. - `bill_amount` number, float — The total amount charged to the cardholder, in the card’s currency. This amount includes the transaction amount plus any applicable fees. - `bill_currency` string — The [ISO 4217 currency code](https://en.wikipedia.org/wiki/ISO_4217) for the bill. Defaults to the card’s currency if not specified. - `transaction_amount` number, float — The original amount of the transaction in the merchant’s currency, representing the base value of the purchase before fees are added. - `transaction_currency` string — The [ISO 4217 currency code](https://en.wikipedia.org/wiki/ISO_4217) for the transaction. Defaults to the card’s currency if not specified. - `conversion_rate` string — The conversion rate applied from the transaction currency to the bill currency. - `merchant_data` object — Details about the merchant associated with the transaction. - `merchant_id` string — The unique identifier of the merchant. - `merchant_name` string — The merchant’s name. - `merchant_city` string — The city of the merchant’s registered address. - `merchant_post_code` string — The postal code of the merchant’s registered address. - `merchant_state` string — The state or province of the merchant’s registered address. - `merchant_country` string — The country of the merchant’s registered address. - `mcc_category` string — The merchant category code (MCC) category. - `mcc_code` string — The merchant category code. - `channel` 'ATM' | 'POS' | 'ECOMMERCE' | 'VISA_DIRECT' — Specifies the channel used for the transaction. Possible values: **ATM**: Automated Teller Machine. Transactions made via ATM, typically involving cash withdrawals. **POS**: Point of Sale. Transactions made at physical terminals, such as in-store card readers. **ECOMMERCE**: Online merchant transactions. These involve purchases made through e-commerce platforms or websites. **VISA_DIRECT**: Transactions processed using Visa Direct. - `pos_entry_mode` object — - **0**: Terminal not used - **1**: Key entry - **2**: Magnetic strip read (general or track 2) - **3**: Bar code read (Visa only) - **4**: OCR read - **5**: Chip card read-data reliable - **6**: Track 1 read - **7**: Proximity payment originating using VSDC chip data rules - **90**: Entire content of magnetic stripe was transmitted in authorization request (CVV) - **91**: Proximity payment originating using magnetic strip data rules - **95**: Initiated by chip card: CVV data may be unreliable - `code` string — The unique identifier of the POS. - `description` string — A description of the POS. - `fees` object — Details of fees involved in the transaction, in the **bill_currency** - `atm_fees` string — ATM fees incurred. - `fx_fees` string — Foreign exchange fees incurred. - `mcc_padding_amount` number, float — The amount padded for this transaction. Learn more about [MCC padding](https://reap.readme.io/docs/risk-management-mcc-padding). - `wallet` string — Indicates if the transaction was processed through a digital wallet. Possible values: **ANDROID**: Transaction processed via Google Pay. **APPLE**: Transaction processed via Apple Pay. - `cleared_at` string — The date the transaction was cleared, if applicable. - `created_at` string — The date the transaction was created. - `status` string — Status of this transaction event. Possible values: **PENDING** **VOID** **DECLINED** **CLEARED** - `category` string — Card category. Default value **Others**. - `is_credit` boolean — Indicates whether the transaction is a reversal or refund. If the transaction is a reversal or refund, this field will return **true**. - `decline_reason` object — Details about a declined transaction. This field is populated only if the transaction status is **DECLINED**. - `response_code` string — The decline response code. Read more about [transaction decline](https://reap.readme.io/docs/transaction-decline). - `description` string — A description of the decline reason. Refer to this page for more information about decline reasons - `lifecycle_events` object[] — Details about how the transaction affects the lifecycle of the card balance. - `affect_balance` boolean, required — The card balance after this transaction. - `bill_amount` string, required — The billed amount. - `bill_currency` string, required — The billing currency. Defaults to the card program’s currency. - `created_at` string, required — The date the transaction was created. - `lifecycle_event_id` string, required — The unique identifier for this lifecycle event. - `mcc_padding_amount` string — The amount padded during the lifecycle event. - `transaction_amount` string, required — The transaction amount. - `transaction_currency` string, required — The transaction currency. - `type` 'authorization' | 'authorization.clearing' | 'authorization.reversal' | 'authorization.advice' | 'refund', required — The type of the transaction event. Possible values: **authorization** **authorization.clearing** **authorization.reversal** **authorization.advice** **refund** Learn more about all [transaction event types](https://reap.readme.io/reference/webhook-eventtype-transaction#/). - `pos_data` object - `pos_transaction_data` object, required - `cardholder_present_indicator` 'cardholder_not_present_unspecified' | 'cardholder_not_present_mail_order' | 'cardholder_not_present_telephone_order' | 'cardholder_not_present_standing_auth/recurring_transaction' | 'cardholder_not_present_ecommerce' | 'cardholder_not_present_installment_transaction' | 'unknown', required - `card_present_indicator` 'card_not_present' | 'card_present', required - `card_data_input_method` 'information_not_provided' | 'manual_no_terminal' | 'magnetic_stripe_read' | 'bar_code' | 'optical_character_recognition' | 'chip_dip/emv_contact' | 'key_entered_or_added_manually' | 'emv_contactless_or_vsdc_contactless' | 'ecommerce' | 'ecommerce_with_emv_cryptogram' | 'contactless_magnetic_stripe' | 'account_data_on_file' | 'key_entered_by_acquirer' | 'micr_reader' | 'qr_code' | 'unknown', required - `cardholder_authentication_method` string[], required - `cardholder_authentication_entity` string[], required - `pos_fraud_indicator` 'no_problem' | 'merchant_suspicious' | 'merchant_verified_the_cardholder_id' | 'unknown', required - `3d_secure_authentication_method` 'unknown/not_applicable' | '3ds_1.0.2_or_prior_or_3ds_1.0.2_frictionless_flow' | 'challenge_flow_using_otp_via_sms_method' | '3ds_2.0_challenge_flow_using_otp_via_any_other_method' | '3ds_2.0_challenge_flow_using_out_of_band_with_biometric_method' | '3ds_2.0_frictionless_flow', required - `security_protocol_between_cardholder_device_and_merchant` 'none' | 'channel_encryption' | 'not_applicable' | 'unknown', required - `card_device_type` 'card' | 'mini-card' | 'jewelry' | 'mobile_phone' | 'non-card' | 'unknown', required - `merchant_or_cardholder_initiated_indicator` 'cardholder_initiated' | 'merchant_initiated' | 'unknown', required - `merchant_initiated_transaction_type_indicator` 'credential_on_file' | 'standing_order' | 'subscription' | 'instalment' | 'partial_shipment' | 'related/delayed_charge' | 'no_show_charge' | 'resubmission' | 'unknown/not_applicable', required - `pos_terminal_capability` object, required - `partial_approval_support` 'not_supported' | 'supported' | 'unknown', required - `card_data_input_capability` string[], required - `cardholder_authentication_capability` string[], required - `card_capture_capability` 'card_capture_not_supported' | 'card_capture_supported' | 'unknown', required - `terminal_attended_indicator` 'no_terminal_used' | 'attended' | 'unattended' | 'unknown', required - `terminal_environment` 'no_terminal_used' | 'on_premises_of_card_acceptor' | 'off_premises_of_card_acceptor' | 'on_premises_of_cardholder' | 'unknown', required - `terminal_card_data_output_capability` 'unknown' | 'none' | 'magnetic_stripe_write' | 'icc' | 'other', required - `terminal_output_capability` 'unknown' | 'none' | 'print_only' | 'display_only' | 'print_and_display', required - `terminal_pin_capture_capability` 'none' | 'unknown' | 'yes_max_length_4_digits' | 'yes_max_length_5_digits' | 'yes_max_length_6_digits' | 'yes_max_length_7_digits' | 'yes_max_length_8_digits' | 'yes_max_length_9_digits' | 'yes_max_length_10_digits' | 'yes_max_length_11_digits' | 'yes_max_length_12_digits', required - `terminal_type` 'unknown/unspecified' | 'cat_level_1_automated_dispensing_machine' | 'cat_level_2_self_service_terminal' | 'cat_level_3_limited_amount_terminal' | 'cat_level_4_in_flight_commerce_terminal' | 'cat_level_5' | 'cat_level_6_e_commerce_terminal' | 'cat_level_7_transponder' | 'mobile_pos_acceptance_device' | 'manual' | 'atm' | 'electronic_cash_register_or_normal_attended_pos_device' | 'unknown', required ## Other responses - `404` — Not found --- [API](https://skmtc.net/reap-global/apis/reap-api.md) · [All operations](https://skmtc.net/reap-global/apis/reap-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reap-global/reap-api/revisions/525072733e02/schema)