# Card Payments > Card Payments group together interactions related to a single card payment, such as an authorization and its corresponding settlement. [Events](https://increase.com/documentation/events.md) will be generated for this resource. The possible event categories are: `card_payment.created` and `card_payment.updated`. ## The Card Payment object ### Example ```json { "account_id": "account_in71c4amph0vgo2qllky", "card_id": "card_oubs0hwk5rn6knuecxg2", "created_at": "2020-01-31T23:59:59Z", "digital_wallet_token_id": null, "elements": [ { "card_authorization": { "actioner": "increase", "additional_amounts": { "clinic": null, "dental": null, "original": null, "prescription": null, "surcharge": { "amount": 10, "currency": "USD" }, "total_cumulative": null, "total_healthcare": null, "transit": null, "unknown": null, "vision": null }, "amount": 100, "card_payment_id": "card_payment_nd3k2kacrqjli8482ave", "currency": "USD", "digital_wallet_token_id": null, "direction": "settlement", "expires_at": "2020-01-31T23:59:59Z", "id": "card_authorization_6iqxap6ivd0fo5eu3i8x", "merchant_acceptor_id": "5665270011000168", "merchant_category_code": "5734", "merchant_city": "New York", "merchant_country": "US", "merchant_descriptor": "AMAZON.COM", "merchant_postal_code": "10045", "merchant_state": "NY", "network_details": { "category": "visa", "pulse": null, "visa": { "electronic_commerce_indicator": "secure_electronic_commerce", "point_of_service_entry_mode": "manual", "stand_in_processing_reason": null, "terminal_entry_capability": "magnetic_stripe" } }, "network_identifiers": { "authorization_identification_response": null, "retrieval_reference_number": "785867080153", "trace_number": "487941", "transaction_id": "627199945183184" }, "network_risk_score": 10, "pending_transaction_id": null, "physical_card_id": null, "presentment_amount": 100, "presentment_currency": "USD", "processing_category": "purchase", "real_time_decision_id": null, "scheme_fees": [ { "amount": "0.137465", "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "fee_type": "visa_corporate_acceptance_fee", "fixed_component": null, "variable_rate": "0.0002" } ], "terminal_id": "RCN5VNXS", "type": "card_authorization", "verification": { "card_verification_code": { "result": "match" }, "cardholder_address": { "actual_line1": "33 Liberty Street", "actual_postal_code": "94131", "provided_line1": "33 Liberty Street", "provided_postal_code": "94132", "result": "postal_code_no_match_address_match" }, "cardholder_name": null } }, "category": "card_authorization", "created_at": "2020-01-31T23:59:59Z" }, { "card_reversal": { "card_authorization_id": "card_authorization_6iqxap6ivd0fo5eu3i8x", "currency": "USD", "id": "card_reversal_8vr9qy60cgf5d0slpb68", "merchant_acceptor_id": "5665270011000168", "merchant_category_code": "5734", "merchant_city": "New York", "merchant_country": "US", "merchant_descriptor": "AMAZON.COM", "merchant_postal_code": "10045", "merchant_state": "NY", "network": "visa", "network_identifiers": { "authorization_identification_response": null, "retrieval_reference_number": "785867080153", "trace_number": "487941", "transaction_id": "627199945183184" }, "pending_transaction_id": "pending_transaction_k1sfetcau2qbvjbzgju4", "presentment_currency": "USD", "reversal_amount": 20, "reversal_presentment_amount": 20, "reversal_reason": "reversed_by_customer", "scheme_fees": [ { "amount": "0.137465", "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "fee_type": "visa_corporate_acceptance_fee", "fixed_component": null, "variable_rate": "0.0002" } ], "terminal_id": "RCN5VNXS", "type": "card_reversal", "updated_authorization_amount": 80, "updated_authorization_presentment_amount": 80 }, "category": "card_reversal", "created_at": "2020-01-31T23:59:59Z" }, { "card_increment": { "actioner": "increase", "additional_amounts": { "clinic": null, "dental": null, "original": null, "prescription": null, "surcharge": null, "total_cumulative": null, "total_healthcare": null, "transit": null, "unknown": null, "vision": null }, "amount": 20, "card_authorization_id": "card_authorization_6iqxap6ivd0fo5eu3i8x", "currency": "USD", "id": "card_increment_6ztayc58j1od0rpebp3e", "network": "visa", "network_identifiers": { "authorization_identification_response": null, "retrieval_reference_number": "785867080153", "trace_number": "487941", "transaction_id": "627199945183184" }, "network_risk_score": 10, "pending_transaction_id": "pending_transaction_k1sfetcau2qbvjbzgju4", "presentment_amount": 20, "presentment_currency": "USD", "real_time_decision_id": null, "scheme_fees": [ { "amount": "0.137465", "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "fee_type": "visa_corporate_acceptance_fee", "fixed_component": null, "variable_rate": "0.0002" } ], "type": "card_increment", "updated_authorization_amount": 120 }, "category": "card_increment", "created_at": "2020-01-31T23:59:59Z" }, { "card_settlement": { "amount": 100, "card_authorization": null, "card_payment_id": "card_payment_nd3k2kacrqjli8482ave", "cashback": null, "currency": "USD", "id": "card_settlement_khv5kfeu0vndj291omg6", "interchange": { "amount": "0.137465", "code": "271", "currency": "USD" }, "merchant_acceptor_id": "5665270011000168", "merchant_category_code": "5734", "merchant_city": "New York", "merchant_country": "US", "merchant_name": "AMAZON.COM", "merchant_postal_code": "10045", "merchant_state": "NY", "network": "visa", "network_identifiers": { "acquirer_business_id": "69650702", "acquirer_reference_number": "83163715445437604865089", "authorization_identification_response": "ABC123", "transaction_id": "627199945183184" }, "pending_transaction_id": null, "presentment_amount": 100, "presentment_currency": "USD", "purchase_details": { "car_rental": null, "customer_reference_identifier": "51201", "local_tax_amount": null, "local_tax_currency": "usd", "lodging": { "check_in_date": "2023-07-20", "daily_room_rate_amount": 1000, "daily_room_rate_currency": "usd", "extra_charges": "restaurant", "folio_cash_advances_amount": 0, "folio_cash_advances_currency": "usd", "food_beverage_charges_amount": 0, "food_beverage_charges_currency": "usd", "no_show_indicator": "no_show", "prepaid_expenses_amount": 0, "prepaid_expenses_currency": "usd", "room_nights": 1, "total_room_tax_amount": 100, "total_room_tax_currency": "usd", "total_tax_amount": 100, "total_tax_currency": "usd" }, "national_tax_amount": null, "national_tax_currency": "usd", "purchase_identifier": "10203", "purchase_identifier_format": "order_number", "travel": null }, "scheme_fees": [ { "amount": "0.137465", "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "fee_type": "visa_corporate_acceptance_fee", "fixed_component": null, "variable_rate": "0.0002" } ], "surcharge": null, "transaction_id": "transaction_uyrp7fld2ium70oa7oi", "type": "card_settlement" }, "category": "card_settlement", "created_at": "2020-01-31T23:59:59Z" } ], "id": "card_payment_nd3k2kacrqjli8482ave", "physical_card_id": null, "state": { "authorized_amount": 100, "fuel_confirmed_amount": 0, "incremented_amount": 20, "refund_authorized_amount": 0, "refunded_amount": 0, "reversed_amount": 20, "settled_amount": 100 }, "type": "card_payment" } ``` ### Attributes - `account_id` (string) The identifier for the Account the Transaction belongs to. - `card_id` (string) The Card identifier for this payment. - `created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Card Payment was created. - `digital_wallet_token_id` (string, nullable) The Digital Wallet Token identifier for this payment. - `elements` (array of objects) The interactions related to this card payment. - `elements.card_authentication` (dictionary, nullable) A Card Authentication object. This field will be present in the JSON response if and only if `category` is equal to `card_authentication`. Card Authentications are attempts to authenticate a transaction or a card with 3DS. - `elements.card_authentication.access_control_server_transaction_identifier` (string) A unique identifier assigned by the Access Control Server (us) for this transaction. - `elements.card_authentication.billing_address_city` (string, nullable) The city of the cardholder billing address associated with the card used for this purchase. - `elements.card_authentication.billing_address_country` (string, nullable) The country of the cardholder billing address associated with the card used for this purchase. - `elements.card_authentication.billing_address_line1` (string, nullable) The first line of the cardholder billing address associated with the card used for this purchase. - `elements.card_authentication.billing_address_line2` (string, nullable) The second line of the cardholder billing address associated with the card used for this purchase. - `elements.card_authentication.billing_address_line3` (string, nullable) The third line of the cardholder billing address associated with the card used for this purchase. - `elements.card_authentication.billing_address_postal_code` (string, nullable) The postal code of the cardholder billing address associated with the card used for this purchase. - `elements.card_authentication.billing_address_state` (string, nullable) The US state of the cardholder billing address associated with the card used for this purchase. - `elements.card_authentication.card_id` (string) The identifier of the Card. - `elements.card_authentication.card_payment_id` (string) The ID of the Card Payment this transaction belongs to. - `elements.card_authentication.cardholder_email` (string, nullable) The email address of the cardholder. - `elements.card_authentication.cardholder_name` (string, nullable) The name of the cardholder. - `elements.card_authentication.challenge` (dictionary, nullable) Details about the challenge, if one was requested. - `elements.card_authentication.challenge.attempts` (array of objects) Details about the challenge verification attempts, if any happened. - `elements.card_authentication.challenge.attempts.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time of the Card Authentication Challenge Attempt. - `elements.card_authentication.challenge.attempts.outcome` (enum) The outcome of the Card Authentication Challenge Attempt. Cases: * `successful` (The attempt was successful.) * `failed` (The attempt was unsuccessful.) - `elements.card_authentication.challenge.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Card Authentication Challenge was started. - `elements.card_authentication.challenge.one_time_code` (string) The one-time code used for the Card Authentication Challenge. - `elements.card_authentication.challenge.real_time_decision_id` (string, nullable) The identifier of the Real-Time Decision used to deliver this challenge. - `elements.card_authentication.challenge.verification_method` (enum) The method used to verify the Card Authentication Challenge. Cases: * `text_message` (The one-time code was sent via text message.) * `email` (The one-time code was sent via email.) * `none_available` (The one-time code was not successfully delivered.) - `elements.card_authentication.challenge.verification_value` (string, nullable) E.g., the email address or phone number used for the Card Authentication Challenge. - `elements.card_authentication.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Card Authentication was attempted. - `elements.card_authentication.deny_reason` (enum, nullable) The reason why this authentication attempt was denied, if it was. Cases: * `group_locked` (The group was locked.) * `card_not_active` (The card was not active.) * `entity_not_active` (The entity was not active.) * `transaction_not_allowed` (The transaction was not allowed.) * `webhook_denied` (The webhook was denied.) * `webhook_timed_out` (The webhook timed out.) - `elements.card_authentication.device_channel` (dictionary) The device channel of the card authentication attempt. - `elements.card_authentication.device_channel.browser` (dictionary, nullable) Fields specific to the browser device channel. - `elements.card_authentication.device_channel.browser.accept_header` (string, nullable) The accept header from the cardholder's browser. - `elements.card_authentication.device_channel.browser.ip_address` (string, nullable) The IP address of the cardholder's browser. - `elements.card_authentication.device_channel.browser.javascript_enabled` (enum, nullable) Whether JavaScript is enabled in the cardholder's browser. Cases: * `enabled` (JavaScript is enabled in the cardholder's browser.) * `disabled` (JavaScript is not enabled in the cardholder's browser.) - `elements.card_authentication.device_channel.browser.language` (string, nullable) The language of the cardholder's browser. - `elements.card_authentication.device_channel.browser.user_agent` (string, nullable) The user agent of the cardholder's browser. - `elements.card_authentication.device_channel.category` (enum) The category of the device channel. Cases: * `app` (The authentication attempt was made from an app.) * `browser` (The authentication attempt was made from a browser.) * `three_ds_requestor_initiated` (The authentication attempt was initiated by the 3DS Requestor.) - `elements.card_authentication.device_channel.merchant_initiated` (dictionary, nullable) Fields specific to merchant initiated transactions. - `elements.card_authentication.device_channel.merchant_initiated.indicator` (enum) The merchant initiated indicator for the transaction. Cases: * `recurring_transaction` (Recurring transaction.) * `installment_transaction` (Installment transaction.) * `add_card` (Add card.) * `maintain_card_information` (Maintain card information.) * `account_verification` (Account verification.) * `split_delayed_shipment` (Split or delayed shipment.) * `top_up` (Top up.) * `mail_order` (Mail order.) * `telephone_order` (Telephone order.) * `whitelist_status_check` (Whitelist status check.) * `other_payment` (Other payment.) * `billing_agreement` (Billing agreement.) * `device_binding_status_check` (Device binding status check.) * `card_security_code_status_check` (Card security code status check.) * `delayed_shipment` (Delayed shipment.) * `split_payment` (Split payment.) * `fido_credential_deletion` (FIDO credential deletion.) * `fido_credential_registration` (FIDO credential registration.) * `decoupled_authentication_fallback` (Decoupled authentication fallback.) - `elements.card_authentication.directory_server_transaction_identifier` (string) A unique identifier assigned by the Directory Server (the card network) for this transaction. - `elements.card_authentication.id` (string) The Card Authentication identifier. - `elements.card_authentication.merchant_acceptor_id` (string, nullable) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `elements.card_authentication.merchant_category_code` (string, nullable) The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with. - `elements.card_authentication.merchant_country` (string, nullable) The country the merchant resides in. - `elements.card_authentication.merchant_name` (string, nullable) The name of the merchant. - `elements.card_authentication.message_category` (dictionary) The message category of the card authentication attempt. - `elements.card_authentication.message_category.category` (enum) The category of the card authentication attempt. Cases: * `payment_authentication` (The authentication attempt is for a payment.) * `non_payment_authentication` (The authentication attempt is not for a payment.) - `elements.card_authentication.message_category.non_payment` (dictionary, nullable) Fields specific to non-payment authentication attempts. - `elements.card_authentication.message_category.payment` (dictionary, nullable) Fields specific to payment authentication attempts. - `elements.card_authentication.message_category.payment.purchase_amount` (integer) The purchase amount in minor units. - `elements.card_authentication.message_category.payment.purchase_amount_cardholder_estimated` (integer, nullable) The purchase amount in the cardholder's currency (i.e., USD) estimated using daily conversion rates from the card network. - `elements.card_authentication.message_category.payment.purchase_currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the authentication attempt's purchase currency. - `elements.card_authentication.message_category.payment.transaction_type` (enum, nullable) The type of transaction being authenticated. Cases: * `goods_service_purchase` (Purchase of goods or services.) * `check_acceptance` (Check acceptance.) * `account_funding` (Account funding.) * `quasi_cash_transaction` (Quasi-cash transaction.) * `prepaid_activation_and_load` (Prepaid activation and load.) - `elements.card_authentication.prior_authenticated_card_payment_id` (string, nullable) The ID of a prior Card Authentication that the requestor used to authenticate this cardholder for a previous transaction. - `elements.card_authentication.real_time_decision_id` (string, nullable) The identifier of the Real-Time Decision sent to approve or decline this authentication attempt. - `elements.card_authentication.requestor_authentication_indicator` (enum, nullable) The 3DS requestor authentication indicator describes why the authentication attempt is performed, such as for a recurring transaction. Cases: * `payment_transaction` (The authentication is for a payment transaction.) * `recurring_transaction` (The authentication is for a recurring transaction.) * `installment_transaction` (The authentication is for an installment transaction.) * `add_card` (The authentication is for adding a card.) * `maintain_card` (The authentication is for maintaining a card.) * `emv_token_cardholder_verification` (The authentication is for EMV token cardholder verification.) * `billing_agreement` (The authentication is for a billing agreement.) - `elements.card_authentication.requestor_challenge_indicator` (enum, nullable) Indicates whether a challenge is requested for this transaction. Cases: * `no_preference` (No preference.) * `no_challenge_requested` (No challenge requested.) * `challenge_requested_3ds_requestor_preference` (Challenge requested, 3DS Requestor preference.) * `challenge_requested_mandate` (Challenge requested, mandate.) * `no_challenge_requested_transactional_risk_analysis_already_performed` (No challenge requested, transactional risk analysis already performed.) * `no_challenge_requested_data_share_only` (No challenge requested, data share only.) * `no_challenge_requested_strong_consumer_authentication_already_performed` (No challenge requested, strong consumer authentication already performed.) * `no_challenge_requested_utilize_whitelist_exemption_if_no_challenge_required` (No challenge requested, utilize whitelist exemption if no challenge required.) * `challenge_requested_whitelist_prompt_requested_if_challenge_required` (Challenge requested, whitelist prompt requested if challenge required.) - `elements.card_authentication.requestor_name` (string) The name of the 3DS requestor. - `elements.card_authentication.requestor_url` (string) The URL of the 3DS requestor. - `elements.card_authentication.shipping_address_city` (string, nullable) The city of the shipping address associated with this purchase. - `elements.card_authentication.shipping_address_country` (string, nullable) The country of the shipping address associated with this purchase. - `elements.card_authentication.shipping_address_line1` (string, nullable) The first line of the shipping address associated with this purchase. - `elements.card_authentication.shipping_address_line2` (string, nullable) The second line of the shipping address associated with this purchase. - `elements.card_authentication.shipping_address_line3` (string, nullable) The third line of the shipping address associated with this purchase. - `elements.card_authentication.shipping_address_postal_code` (string, nullable) The postal code of the shipping address associated with this purchase. - `elements.card_authentication.shipping_address_state` (string, nullable) The US state of the shipping address associated with this purchase. - `elements.card_authentication.status` (enum) The status of the card authentication. Cases: * `denied` (The authentication attempt was denied.) * `authenticated_with_challenge` (The authentication attempt was authenticated with a challenge.) * `authenticated_without_challenge` (The authentication attempt was authenticated without a challenge.) * `awaiting_challenge` (The authentication attempt is awaiting a challenge.) * `validating_challenge` (The authentication attempt is validating a challenge.) * `canceled` (The authentication attempt was canceled.) * `timed_out_awaiting_challenge` (The authentication attempt timed out while awaiting a challenge.) * `errored` (The authentication attempt errored.) * `exceeded_attempt_threshold` (The authentication attempt exceeded the attempt threshold.) - `elements.card_authentication.three_d_secure_server_transaction_identifier` (string) A unique identifier assigned by the 3DS Server initiating the authentication attempt for this transaction. - `elements.card_authentication.type` (string) A constant representing the object's type. For this resource it will always be `card_authentication`. - `elements.card_authorization` (dictionary, nullable) A Card Authorization object. This field will be present in the JSON response if and only if `category` is equal to `card_authorization`. Card Authorizations are temporary holds placed on a customer's funds with the intent to later clear a transaction. - `elements.card_authorization.actioner` (enum) Whether this authorization was approved by Increase, the card network through stand-in processing, or the user through a real-time decision. Cases: * `user` (This object was actioned by the user through a real-time decision.) * `increase` (This object was actioned by Increase without user intervention.) * `network` (This object was actioned by the network, through stand-in processing.) - `elements.card_authorization.additional_amounts` (dictionary) Additional amounts associated with the card authorization, such as ATM surcharges fees. These are usually a subset of the `amount` field and are used to provide more detailed information about the transaction. - `elements.card_authorization.additional_amounts.clinic` (dictionary, nullable) The part of this transaction amount that was for clinic-related services. - `elements.card_authorization.additional_amounts.clinic.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_authorization.additional_amounts.clinic.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_authorization.additional_amounts.dental` (dictionary, nullable) The part of this transaction amount that was for dental-related services. - `elements.card_authorization.additional_amounts.dental.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_authorization.additional_amounts.dental.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_authorization.additional_amounts.original` (dictionary, nullable) The original pre-authorized amount. - `elements.card_authorization.additional_amounts.original.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_authorization.additional_amounts.original.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_authorization.additional_amounts.prescription` (dictionary, nullable) The part of this transaction amount that was for healthcare prescriptions. - `elements.card_authorization.additional_amounts.prescription.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_authorization.additional_amounts.prescription.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_authorization.additional_amounts.surcharge` (dictionary, nullable) The surcharge amount charged for this transaction by the merchant. - `elements.card_authorization.additional_amounts.surcharge.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_authorization.additional_amounts.surcharge.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_authorization.additional_amounts.total_cumulative` (dictionary, nullable) The total amount of a series of incremental authorizations, optionally provided. - `elements.card_authorization.additional_amounts.total_cumulative.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_authorization.additional_amounts.total_cumulative.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_authorization.additional_amounts.total_healthcare` (dictionary, nullable) The total amount of healthcare-related additional amounts. - `elements.card_authorization.additional_amounts.total_healthcare.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_authorization.additional_amounts.total_healthcare.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_authorization.additional_amounts.transit` (dictionary, nullable) The part of this transaction amount that was for transit-related services. - `elements.card_authorization.additional_amounts.transit.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_authorization.additional_amounts.transit.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_authorization.additional_amounts.unknown` (dictionary, nullable) An unknown additional amount. - `elements.card_authorization.additional_amounts.unknown.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_authorization.additional_amounts.unknown.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_authorization.additional_amounts.vision` (dictionary, nullable) The part of this transaction amount that was for vision-related services. - `elements.card_authorization.additional_amounts.vision.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_authorization.additional_amounts.vision.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_authorization.amount` (integer) The pending amount in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `elements.card_authorization.card_payment_id` (string) The ID of the Card Payment this transaction belongs to. - `elements.card_authorization.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_authorization.digital_wallet_token_id` (string, nullable) If the authorization was made via a Digital Wallet Token (such as an Apple Pay purchase), the identifier of the token that was used. - `elements.card_authorization.direction` (enum) The direction describes the direction the funds will move, either from the cardholder to the merchant or from the merchant to the cardholder. Cases: * `settlement` (A regular card authorization where funds are debited from the cardholder.) * `refund` (A refund card authorization, sometimes referred to as a credit voucher authorization, where funds are credited to the cardholder.) - `elements.card_authorization.expires_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) when this authorization will expire and the pending transaction will be released. - `elements.card_authorization.id` (string) The Card Authorization identifier. - `elements.card_authorization.merchant_acceptor_id` (string) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `elements.card_authorization.merchant_category_code` (string) The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with. - `elements.card_authorization.merchant_city` (string, nullable) The city the merchant resides in. - `elements.card_authorization.merchant_country` (string) The country the merchant resides in. - `elements.card_authorization.merchant_descriptor` (string) The merchant descriptor of the merchant the card is transacting with. - `elements.card_authorization.merchant_postal_code` (string, nullable) The merchant's postal code. For US merchants this is either a 5-digit or 9-digit ZIP code, where the first 5 and last 4 are separated by a dash. - `elements.card_authorization.merchant_state` (string, nullable) The state the merchant resides in. - `elements.card_authorization.network_details` (dictionary) Fields specific to the `network`. - `elements.card_authorization.network_details.category` (enum) The payment network used to process this card authorization. Cases: * `visa` (Visa) * `pulse` (Pulse) - `elements.card_authorization.network_details.pulse` (dictionary, nullable) Fields specific to the `pulse` network. - `elements.card_authorization.network_details.visa` (dictionary, nullable) Fields specific to the `visa` network. - `elements.card_authorization.network_details.visa.electronic_commerce_indicator` (enum, nullable) For electronic commerce transactions, this identifies the level of security used in obtaining the customer's payment credential. For mail or telephone order transactions, identifies the type of mail or telephone order. Cases: * `mail_phone_order` (Single transaction of a mail/phone order: Use to indicate that the transaction is a mail/phone order purchase, not a recurring transaction or installment payment. For domestic transactions in the US region, this value may also indicate one bill payment transaction in the card-present or card-absent environments.) * `recurring` (Recurring transaction: Payment indicator used to indicate a recurring transaction that originates from an acquirer in the US region.) * `installment` (Installment payment: Payment indicator used to indicate one purchase of goods or services that is billed to the account in multiple charges over a period of time agreed upon by the cardholder and merchant from transactions that originate from an acquirer in the US region.) * `unknown_mail_phone_order` (Unknown classification: other mail order: Use to indicate that the type of mail/telephone order is unknown.) * `secure_electronic_commerce` (Secure electronic commerce transaction: Use to indicate that the electronic commerce transaction has been authenticated using e.g., 3-D Secure) * `non_authenticated_security_transaction_at_3ds_capable_merchant` (Non-authenticated security transaction at a 3-D Secure-capable merchant, and merchant attempted to authenticate the cardholder using 3-D Secure: Use to identify an electronic commerce transaction where the merchant attempted to authenticate the cardholder using 3-D Secure, but was unable to complete the authentication because the issuer or cardholder does not participate in the 3-D Secure program.) * `non_authenticated_security_transaction` (Non-authenticated security transaction: Use to identify an electronic commerce transaction that uses data encryption for security however, cardholder authentication is not performed using 3-D Secure.) * `non_secure_transaction` (Non-secure transaction: Use to identify an electronic commerce transaction that has no data protection.) - `elements.card_authorization.network_details.visa.point_of_service_entry_mode` (enum, nullable) The method used to enter the cardholder's primary account number and card expiration date. Cases: * `unknown` (Unknown) * `manual` (Manual key entry) * `magnetic_stripe_no_cvv` (Magnetic stripe read, without card verification value) * `optical_code` (Optical code) * `integrated_circuit_card` (Contact chip card) * `contactless` (Contactless read of chip card) * `credential_on_file` (Transaction initiated using a credential that has previously been stored on file) * `magnetic_stripe` (Magnetic stripe read) * `contactless_magnetic_stripe` (Contactless read of magnetic stripe data) * `integrated_circuit_card_no_cvv` (Contact chip card, without card verification value) - `elements.card_authorization.network_details.visa.stand_in_processing_reason` (enum, nullable) Only present when `actioner: network`. Describes why a card authorization was approved or declined by Visa through stand-in processing. Cases: * `issuer_error` (Increase failed to process the authorization in a timely manner.) * `invalid_physical_card` (The physical card read had an invalid CVV or dCVV.) * `invalid_cryptogram` (The card's authorization request cryptogram was invalid. The cryptogram can be from a physical card or a Digital Wallet Token purchase.) * `invalid_cardholder_authentication_verification_value` (The 3DS cardholder authentication verification value was invalid.) * `internal_visa_error` (An internal Visa error occurred. Visa uses this reason code for certain expected occurrences as well, such as Application Transaction Counter (ATC) replays.) * `merchant_transaction_advisory_service_authentication_required` (The merchant has enabled Visa's Transaction Advisory Service and requires further authentication to perform the transaction. In practice this is often utilized at fuel pumps to tell the cardholder to see the cashier.) * `payment_fraud_disruption_acquirer_block` (The transaction was blocked by Visa's Payment Fraud Disruption service due to fraudulent Acquirer behavior, such as card testing.) * `other` (An unspecific reason for stand-in processing.) - `elements.card_authorization.network_details.visa.terminal_entry_capability` (enum, nullable) The capability of the terminal being used to read the card. Shows whether a terminal can e.g., accept chip cards or if it only supports magnetic stripe reads. This reflects the highest capability of the terminal — for example, a terminal that supports both chip and magnetic stripe will be identified as chip-capable. Cases: * `unknown` (Unknown) * `terminal_not_used` (No terminal was used for this transaction.) * `magnetic_stripe` (The terminal can only read magnetic stripes and does not have chip or contactless reading capability.) * `barcode` (The terminal can only read barcodes.) * `optical_character_recognition` (The terminal can only read cards via Optical Character Recognition.) * `chip_or_contactless` (The terminal supports contact chip cards and can also read the magnetic stripe. If contact chip is supported, this value is used regardless of whether contactless is also supported.) * `contactless_only` (The terminal supports contactless reads but does not support contact chip. Only used when the terminal lacks contact chip capability.) * `no_capability` (The terminal has no card reading capability.) - `elements.card_authorization.network_identifiers` (dictionary) Network-specific identifiers for a specific request or transaction. - `elements.card_authorization.network_identifiers.authorization_identification_response` (string, nullable) The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response. - `elements.card_authorization.network_identifiers.retrieval_reference_number` (string, nullable) A life-cycle identifier used across e.g., an authorization and a reversal. Expected to be unique per acquirer within a window of time. For some card networks the retrieval reference number includes the trace counter. - `elements.card_authorization.network_identifiers.trace_number` (string, nullable) A counter used to verify an individual authorization. Expected to be unique per acquirer within a window of time. - `elements.card_authorization.network_identifiers.transaction_id` (string, nullable) A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests. - `elements.card_authorization.network_risk_score` (integer, nullable) The risk score generated by the card network. For Visa this is the Visa Advanced Authorization risk score, from 0 to 99, where 99 is the riskiest. For Pulse the score is from 0 to 999, where 999 is the riskiest. - `elements.card_authorization.pending_transaction_id` (string, nullable) The identifier of the Pending Transaction associated with this Transaction. - `elements.card_authorization.physical_card_id` (string, nullable) If the authorization was made in-person with a physical card, the Physical Card that was used. - `elements.card_authorization.presentment_amount` (integer) The pending amount in the minor unit of the transaction's presentment currency. - `elements.card_authorization.presentment_currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's presentment currency. - `elements.card_authorization.processing_category` (enum) The processing category describes the intent behind the authorization, such as whether it was used for bill payments or an automatic fuel dispenser. Cases: * `account_funding` (Account funding transactions are transactions used to e.g., fund an account or transfer funds between accounts.) * `automatic_fuel_dispenser` (Automatic fuel dispenser authorizations occur when a card is used at a gas pump, prior to the actual transaction amount being known. They are followed by an advice message that updates the amount of the pending transaction.) * `bill_payment` (A transaction used to pay a bill.) * `original_credit` (Original credit transactions are used to send money to a cardholder.) * `purchase` (A regular purchase.) * `quasi_cash` (Quasi-cash transactions represent purchases of items which may be convertible to cash.) * `refund` (A refund card authorization, sometimes referred to as a credit voucher authorization, where funds are credited to the cardholder.) * `cash_disbursement` (Cash disbursement transactions are used to withdraw cash from an ATM or a point of sale.) * `balance_inquiry` (A balance inquiry transaction is used to check the balance of an account associated with a card.) * `unknown` (The processing category is unknown.) - `elements.card_authorization.real_time_decision_id` (string, nullable) The identifier of the Real-Time Decision sent to approve or decline this transaction. - `elements.card_authorization.scheme_fees` (array of objects) The scheme fees associated with this card authorization. - `elements.card_authorization.scheme_fees.amount` (string) The fee amount given as a string containing a decimal number. - `elements.card_authorization.scheme_fees.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was created. - `elements.card_authorization.scheme_fees.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_authorization.scheme_fees.fee_type` (enum) The type of fee being assessed. Cases: * `visa_international_service_assessment_single_currency` (International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.) * `visa_international_service_assessment_cross_currency` (International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.) * `visa_authorization_domestic_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_international_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_canada_point_of_sale` (Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.) * `visa_authorization_reversal_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_reversal_international_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_address_verification_service` (A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.) * `visa_advanced_authorization` (Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).) * `visa_message_transmission` (Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.) * `visa_account_verification_domestic` (Activity, per inquiry, related to the domestic Issuer for Account Number Verification.) * `visa_account_verification_international` (Activity, per inquiry, related to the international Issuer for Account Number Verification.) * `visa_account_verification_canada` (Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.) * `visa_corporate_acceptance_fee` (The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_consumer_debit_acceptance_fee` (The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.) * `visa_business_debit_acceptance_fee` (The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.) * `visa_purchasing_acceptance_fee` (The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_purchase_domestic` (Activity and fees for the processing of a sales draft original for a purchase transaction.) * `visa_purchase_international` (Activity and fees for the processing of an international sales draft original for a purchase transaction.) * `visa_credit_purchase_token` (Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_debit_purchase_token` (Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_clearing_transmission` (A per transaction fee assessed for Base II financial draft - Issuer.) * `visa_direct_authorization` (Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.) * `visa_direct_transaction_domestic` (Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.) * `visa_service_commercial_credit` (Issuer card service fee for Commercial Credit cards.) * `visa_advertising_service_commercial_credit` (Issuer Advertising Service Fee for Commercial Credit cards.) * `visa_community_growth_acceleration_program` (Issuer Community Growth Acceleration Program Fee.) * `visa_processing_guarantee_commercial_credit` (Issuer Processing Guarantee for Commercial Credit cards.) * `pulse_switch_fee` (Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.) - `elements.card_authorization.scheme_fees.fixed_component` (string, nullable) The fixed component of the fee, if applicable, given in major units of the fee amount. - `elements.card_authorization.scheme_fees.variable_rate` (string, nullable) The variable rate component of the fee, if applicable, given as a decimal (e.g., 0.015 for 1.5%). - `elements.card_authorization.terminal_id` (string, nullable) The terminal identifier (commonly abbreviated as TID) of the terminal the card is transacting with. - `elements.card_authorization.type` (string) A constant representing the object's type. For this resource it will always be `card_authorization`. - `elements.card_authorization.verification` (dictionary) Fields related to verification of cardholder-provided values. - `elements.card_authorization.verification.card_verification_code` (dictionary) Fields related to verification of the Card Verification Code, a 3-digit code on the back of the card. - `elements.card_authorization.verification.card_verification_code.result` (enum) The result of verifying the Card Verification Code. Cases: * `not_checked` (No card verification code was provided in the authorization request.) * `match` (The card verification code matched the one on file.) * `no_match` (The card verification code did not match the one on file.) - `elements.card_authorization.verification.cardholder_address` (dictionary) Cardholder address provided in the authorization request and the address on file we verified it against. - `elements.card_authorization.verification.cardholder_address.actual_line1` (string, nullable) Line 1 of the address on file for the cardholder. - `elements.card_authorization.verification.cardholder_address.actual_postal_code` (string, nullable) The postal code of the address on file for the cardholder. - `elements.card_authorization.verification.cardholder_address.provided_line1` (string, nullable) The cardholder address line 1 provided for verification in the authorization request. - `elements.card_authorization.verification.cardholder_address.provided_postal_code` (string, nullable) The postal code provided for verification in the authorization request. - `elements.card_authorization.verification.cardholder_address.result` (enum) The address verification result returned to the card network. Cases: * `not_checked` (No address information was provided in the authorization request.) * `postal_code_match_address_no_match` (Postal code matches, but the street address does not match or was not provided.) * `postal_code_no_match_address_match` (Postal code does not match, but the street address matches or was not provided.) * `match` (Postal code and street address match.) * `no_match` (Postal code and street address do not match.) * `postal_code_match_address_not_checked` (Postal code matches, but the street address was not verified. (deprecated)) - `elements.card_authorization.verification.cardholder_name` (dictionary, nullable) Cardholder name provided in the authorization request. - `elements.card_authorization.verification.cardholder_name.provided_first_name` (string, nullable) The first name provided for verification in the authorization request. - `elements.card_authorization.verification.cardholder_name.provided_last_name` (string, nullable) The last name provided for verification in the authorization request. - `elements.card_authorization.verification.cardholder_name.provided_middle_name` (string, nullable) The middle name provided for verification in the authorization request. - `elements.card_authorization_expiration` (dictionary, nullable) A Card Authorization Expiration object. This field will be present in the JSON response if and only if `category` is equal to `card_authorization_expiration`. Card Authorization Expirations are cancellations of authorizations that were never settled by the acquirer. - `elements.card_authorization_expiration.card_authorization_id` (string) The identifier for the Card Authorization this reverses. - `elements.card_authorization_expiration.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the reversal's currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_authorization_expiration.expired_amount` (integer) The amount of this authorization expiration in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `elements.card_authorization_expiration.id` (string) The Card Authorization Expiration identifier. - `elements.card_authorization_expiration.network` (enum) The card network used to process this card authorization. Cases: * `visa` (Visa) * `pulse` (Pulse) - `elements.card_authorization_expiration.type` (string) A constant representing the object's type. For this resource it will always be `card_authorization_expiration`. - `elements.card_balance_inquiry` (dictionary, nullable) A Card Balance Inquiry object. This field will be present in the JSON response if and only if `category` is equal to `card_balance_inquiry`. Card Balance Inquiries are transactions that allow merchants to check the available balance on a card without placing a hold on funds, commonly used when a customer requests their balance at an ATM. - `elements.card_balance_inquiry.additional_amounts` (dictionary) Additional amounts associated with the card authorization, such as ATM surcharges fees. These are usually a subset of the `amount` field and are used to provide more detailed information about the transaction. - `elements.card_balance_inquiry.additional_amounts.clinic` (dictionary, nullable) The part of this transaction amount that was for clinic-related services. - `elements.card_balance_inquiry.additional_amounts.clinic.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_balance_inquiry.additional_amounts.clinic.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_balance_inquiry.additional_amounts.dental` (dictionary, nullable) The part of this transaction amount that was for dental-related services. - `elements.card_balance_inquiry.additional_amounts.dental.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_balance_inquiry.additional_amounts.dental.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_balance_inquiry.additional_amounts.original` (dictionary, nullable) The original pre-authorized amount. - `elements.card_balance_inquiry.additional_amounts.original.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_balance_inquiry.additional_amounts.original.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_balance_inquiry.additional_amounts.prescription` (dictionary, nullable) The part of this transaction amount that was for healthcare prescriptions. - `elements.card_balance_inquiry.additional_amounts.prescription.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_balance_inquiry.additional_amounts.prescription.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_balance_inquiry.additional_amounts.surcharge` (dictionary, nullable) The surcharge amount charged for this transaction by the merchant. - `elements.card_balance_inquiry.additional_amounts.surcharge.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_balance_inquiry.additional_amounts.surcharge.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_balance_inquiry.additional_amounts.total_cumulative` (dictionary, nullable) The total amount of a series of incremental authorizations, optionally provided. - `elements.card_balance_inquiry.additional_amounts.total_cumulative.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_balance_inquiry.additional_amounts.total_cumulative.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_balance_inquiry.additional_amounts.total_healthcare` (dictionary, nullable) The total amount of healthcare-related additional amounts. - `elements.card_balance_inquiry.additional_amounts.total_healthcare.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_balance_inquiry.additional_amounts.total_healthcare.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_balance_inquiry.additional_amounts.transit` (dictionary, nullable) The part of this transaction amount that was for transit-related services. - `elements.card_balance_inquiry.additional_amounts.transit.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_balance_inquiry.additional_amounts.transit.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_balance_inquiry.additional_amounts.unknown` (dictionary, nullable) An unknown additional amount. - `elements.card_balance_inquiry.additional_amounts.unknown.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_balance_inquiry.additional_amounts.unknown.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_balance_inquiry.additional_amounts.vision` (dictionary, nullable) The part of this transaction amount that was for vision-related services. - `elements.card_balance_inquiry.additional_amounts.vision.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_balance_inquiry.additional_amounts.vision.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_balance_inquiry.balance` (integer) The balance amount in the minor unit of the account's currency. For dollars, for example, this is cents. - `elements.card_balance_inquiry.card_payment_id` (string) The ID of the Card Payment this transaction belongs to. - `elements.card_balance_inquiry.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the account's currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_balance_inquiry.digital_wallet_token_id` (string, nullable) If the authorization was made via a Digital Wallet Token (such as an Apple Pay purchase), the identifier of the token that was used. - `elements.card_balance_inquiry.id` (string) The Card Balance Inquiry identifier. - `elements.card_balance_inquiry.merchant_acceptor_id` (string) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `elements.card_balance_inquiry.merchant_category_code` (string) The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with. - `elements.card_balance_inquiry.merchant_city` (string, nullable) The city the merchant resides in. - `elements.card_balance_inquiry.merchant_country` (string) The country the merchant resides in. - `elements.card_balance_inquiry.merchant_descriptor` (string) The merchant descriptor of the merchant the card is transacting with. - `elements.card_balance_inquiry.merchant_postal_code` (string, nullable) The merchant's postal code. For US merchants this is either a 5-digit or 9-digit ZIP code, where the first 5 and last 4 are separated by a dash. - `elements.card_balance_inquiry.merchant_state` (string, nullable) The state the merchant resides in. - `elements.card_balance_inquiry.network_details` (dictionary) Fields specific to the `network`. - `elements.card_balance_inquiry.network_details.category` (enum) The payment network used to process this card authorization. Cases: * `visa` (Visa) * `pulse` (Pulse) - `elements.card_balance_inquiry.network_details.pulse` (dictionary, nullable) Fields specific to the `pulse` network. - `elements.card_balance_inquiry.network_details.visa` (dictionary, nullable) Fields specific to the `visa` network. - `elements.card_balance_inquiry.network_details.visa.electronic_commerce_indicator` (enum, nullable) For electronic commerce transactions, this identifies the level of security used in obtaining the customer's payment credential. For mail or telephone order transactions, identifies the type of mail or telephone order. Cases: * `mail_phone_order` (Single transaction of a mail/phone order: Use to indicate that the transaction is a mail/phone order purchase, not a recurring transaction or installment payment. For domestic transactions in the US region, this value may also indicate one bill payment transaction in the card-present or card-absent environments.) * `recurring` (Recurring transaction: Payment indicator used to indicate a recurring transaction that originates from an acquirer in the US region.) * `installment` (Installment payment: Payment indicator used to indicate one purchase of goods or services that is billed to the account in multiple charges over a period of time agreed upon by the cardholder and merchant from transactions that originate from an acquirer in the US region.) * `unknown_mail_phone_order` (Unknown classification: other mail order: Use to indicate that the type of mail/telephone order is unknown.) * `secure_electronic_commerce` (Secure electronic commerce transaction: Use to indicate that the electronic commerce transaction has been authenticated using e.g., 3-D Secure) * `non_authenticated_security_transaction_at_3ds_capable_merchant` (Non-authenticated security transaction at a 3-D Secure-capable merchant, and merchant attempted to authenticate the cardholder using 3-D Secure: Use to identify an electronic commerce transaction where the merchant attempted to authenticate the cardholder using 3-D Secure, but was unable to complete the authentication because the issuer or cardholder does not participate in the 3-D Secure program.) * `non_authenticated_security_transaction` (Non-authenticated security transaction: Use to identify an electronic commerce transaction that uses data encryption for security however, cardholder authentication is not performed using 3-D Secure.) * `non_secure_transaction` (Non-secure transaction: Use to identify an electronic commerce transaction that has no data protection.) - `elements.card_balance_inquiry.network_details.visa.point_of_service_entry_mode` (enum, nullable) The method used to enter the cardholder's primary account number and card expiration date. Cases: * `unknown` (Unknown) * `manual` (Manual key entry) * `magnetic_stripe_no_cvv` (Magnetic stripe read, without card verification value) * `optical_code` (Optical code) * `integrated_circuit_card` (Contact chip card) * `contactless` (Contactless read of chip card) * `credential_on_file` (Transaction initiated using a credential that has previously been stored on file) * `magnetic_stripe` (Magnetic stripe read) * `contactless_magnetic_stripe` (Contactless read of magnetic stripe data) * `integrated_circuit_card_no_cvv` (Contact chip card, without card verification value) - `elements.card_balance_inquiry.network_details.visa.stand_in_processing_reason` (enum, nullable) Only present when `actioner: network`. Describes why a card authorization was approved or declined by Visa through stand-in processing. Cases: * `issuer_error` (Increase failed to process the authorization in a timely manner.) * `invalid_physical_card` (The physical card read had an invalid CVV or dCVV.) * `invalid_cryptogram` (The card's authorization request cryptogram was invalid. The cryptogram can be from a physical card or a Digital Wallet Token purchase.) * `invalid_cardholder_authentication_verification_value` (The 3DS cardholder authentication verification value was invalid.) * `internal_visa_error` (An internal Visa error occurred. Visa uses this reason code for certain expected occurrences as well, such as Application Transaction Counter (ATC) replays.) * `merchant_transaction_advisory_service_authentication_required` (The merchant has enabled Visa's Transaction Advisory Service and requires further authentication to perform the transaction. In practice this is often utilized at fuel pumps to tell the cardholder to see the cashier.) * `payment_fraud_disruption_acquirer_block` (The transaction was blocked by Visa's Payment Fraud Disruption service due to fraudulent Acquirer behavior, such as card testing.) * `other` (An unspecific reason for stand-in processing.) - `elements.card_balance_inquiry.network_details.visa.terminal_entry_capability` (enum, nullable) The capability of the terminal being used to read the card. Shows whether a terminal can e.g., accept chip cards or if it only supports magnetic stripe reads. This reflects the highest capability of the terminal — for example, a terminal that supports both chip and magnetic stripe will be identified as chip-capable. Cases: * `unknown` (Unknown) * `terminal_not_used` (No terminal was used for this transaction.) * `magnetic_stripe` (The terminal can only read magnetic stripes and does not have chip or contactless reading capability.) * `barcode` (The terminal can only read barcodes.) * `optical_character_recognition` (The terminal can only read cards via Optical Character Recognition.) * `chip_or_contactless` (The terminal supports contact chip cards and can also read the magnetic stripe. If contact chip is supported, this value is used regardless of whether contactless is also supported.) * `contactless_only` (The terminal supports contactless reads but does not support contact chip. Only used when the terminal lacks contact chip capability.) * `no_capability` (The terminal has no card reading capability.) - `elements.card_balance_inquiry.network_identifiers` (dictionary) Network-specific identifiers for a specific request or transaction. - `elements.card_balance_inquiry.network_identifiers.authorization_identification_response` (string, nullable) The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response. - `elements.card_balance_inquiry.network_identifiers.retrieval_reference_number` (string, nullable) A life-cycle identifier used across e.g., an authorization and a reversal. Expected to be unique per acquirer within a window of time. For some card networks the retrieval reference number includes the trace counter. - `elements.card_balance_inquiry.network_identifiers.trace_number` (string, nullable) A counter used to verify an individual authorization. Expected to be unique per acquirer within a window of time. - `elements.card_balance_inquiry.network_identifiers.transaction_id` (string, nullable) A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests. - `elements.card_balance_inquiry.network_risk_score` (integer, nullable) The risk score generated by the card network. For Visa this is the Visa Advanced Authorization risk score, from 0 to 99, where 99 is the riskiest. For Pulse the score is from 0 to 999, where 999 is the riskiest. - `elements.card_balance_inquiry.physical_card_id` (string, nullable) If the authorization was made in-person with a physical card, the Physical Card that was used. - `elements.card_balance_inquiry.real_time_decision_id` (string, nullable) The identifier of the Real-Time Decision sent to approve or decline this transaction. - `elements.card_balance_inquiry.scheme_fees` (array of objects) The scheme fees associated with this card balance inquiry. - `elements.card_balance_inquiry.scheme_fees.amount` (string) The fee amount given as a string containing a decimal number. - `elements.card_balance_inquiry.scheme_fees.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was created. - `elements.card_balance_inquiry.scheme_fees.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_balance_inquiry.scheme_fees.fee_type` (enum) The type of fee being assessed. Cases: * `visa_international_service_assessment_single_currency` (International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.) * `visa_international_service_assessment_cross_currency` (International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.) * `visa_authorization_domestic_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_international_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_canada_point_of_sale` (Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.) * `visa_authorization_reversal_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_reversal_international_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_address_verification_service` (A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.) * `visa_advanced_authorization` (Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).) * `visa_message_transmission` (Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.) * `visa_account_verification_domestic` (Activity, per inquiry, related to the domestic Issuer for Account Number Verification.) * `visa_account_verification_international` (Activity, per inquiry, related to the international Issuer for Account Number Verification.) * `visa_account_verification_canada` (Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.) * `visa_corporate_acceptance_fee` (The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_consumer_debit_acceptance_fee` (The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.) * `visa_business_debit_acceptance_fee` (The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.) * `visa_purchasing_acceptance_fee` (The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_purchase_domestic` (Activity and fees for the processing of a sales draft original for a purchase transaction.) * `visa_purchase_international` (Activity and fees for the processing of an international sales draft original for a purchase transaction.) * `visa_credit_purchase_token` (Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_debit_purchase_token` (Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_clearing_transmission` (A per transaction fee assessed for Base II financial draft - Issuer.) * `visa_direct_authorization` (Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.) * `visa_direct_transaction_domestic` (Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.) * `visa_service_commercial_credit` (Issuer card service fee for Commercial Credit cards.) * `visa_advertising_service_commercial_credit` (Issuer Advertising Service Fee for Commercial Credit cards.) * `visa_community_growth_acceleration_program` (Issuer Community Growth Acceleration Program Fee.) * `visa_processing_guarantee_commercial_credit` (Issuer Processing Guarantee for Commercial Credit cards.) * `pulse_switch_fee` (Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.) - `elements.card_balance_inquiry.scheme_fees.fixed_component` (string, nullable) The fixed component of the fee, if applicable, given in major units of the fee amount. - `elements.card_balance_inquiry.scheme_fees.variable_rate` (string, nullable) The variable rate component of the fee, if applicable, given as a decimal (e.g., 0.015 for 1.5%). - `elements.card_balance_inquiry.terminal_id` (string, nullable) The terminal identifier (commonly abbreviated as TID) of the terminal the card is transacting with. - `elements.card_balance_inquiry.type` (string) A constant representing the object's type. For this resource it will always be `card_balance_inquiry`. - `elements.card_balance_inquiry.verification` (dictionary) Fields related to verification of cardholder-provided values. - `elements.card_balance_inquiry.verification.card_verification_code` (dictionary) Fields related to verification of the Card Verification Code, a 3-digit code on the back of the card. - `elements.card_balance_inquiry.verification.card_verification_code.result` (enum) The result of verifying the Card Verification Code. Cases: * `not_checked` (No card verification code was provided in the authorization request.) * `match` (The card verification code matched the one on file.) * `no_match` (The card verification code did not match the one on file.) - `elements.card_balance_inquiry.verification.cardholder_address` (dictionary) Cardholder address provided in the authorization request and the address on file we verified it against. - `elements.card_balance_inquiry.verification.cardholder_address.actual_line1` (string, nullable) Line 1 of the address on file for the cardholder. - `elements.card_balance_inquiry.verification.cardholder_address.actual_postal_code` (string, nullable) The postal code of the address on file for the cardholder. - `elements.card_balance_inquiry.verification.cardholder_address.provided_line1` (string, nullable) The cardholder address line 1 provided for verification in the authorization request. - `elements.card_balance_inquiry.verification.cardholder_address.provided_postal_code` (string, nullable) The postal code provided for verification in the authorization request. - `elements.card_balance_inquiry.verification.cardholder_address.result` (enum) The address verification result returned to the card network. Cases: * `not_checked` (No address information was provided in the authorization request.) * `postal_code_match_address_no_match` (Postal code matches, but the street address does not match or was not provided.) * `postal_code_no_match_address_match` (Postal code does not match, but the street address matches or was not provided.) * `match` (Postal code and street address match.) * `no_match` (Postal code and street address do not match.) * `postal_code_match_address_not_checked` (Postal code matches, but the street address was not verified. (deprecated)) - `elements.card_balance_inquiry.verification.cardholder_name` (dictionary, nullable) Cardholder name provided in the authorization request. - `elements.card_balance_inquiry.verification.cardholder_name.provided_first_name` (string, nullable) The first name provided for verification in the authorization request. - `elements.card_balance_inquiry.verification.cardholder_name.provided_last_name` (string, nullable) The last name provided for verification in the authorization request. - `elements.card_balance_inquiry.verification.cardholder_name.provided_middle_name` (string, nullable) The middle name provided for verification in the authorization request. - `elements.card_decline` (dictionary, nullable) A Card Decline object. This field will be present in the JSON response if and only if `category` is equal to `card_decline`. - `elements.card_decline.actioner` (enum) Whether this authorization was approved by Increase, the card network through stand-in processing, or the user through a real-time decision. Cases: * `user` (This object was actioned by the user through a real-time decision.) * `increase` (This object was actioned by Increase without user intervention.) * `network` (This object was actioned by the network, through stand-in processing.) - `elements.card_decline.additional_amounts` (dictionary) Additional amounts associated with the card authorization, such as ATM surcharges fees. These are usually a subset of the `amount` field and are used to provide more detailed information about the transaction. - `elements.card_decline.additional_amounts.clinic` (dictionary, nullable) The part of this transaction amount that was for clinic-related services. - `elements.card_decline.additional_amounts.clinic.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_decline.additional_amounts.clinic.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_decline.additional_amounts.dental` (dictionary, nullable) The part of this transaction amount that was for dental-related services. - `elements.card_decline.additional_amounts.dental.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_decline.additional_amounts.dental.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_decline.additional_amounts.original` (dictionary, nullable) The original pre-authorized amount. - `elements.card_decline.additional_amounts.original.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_decline.additional_amounts.original.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_decline.additional_amounts.prescription` (dictionary, nullable) The part of this transaction amount that was for healthcare prescriptions. - `elements.card_decline.additional_amounts.prescription.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_decline.additional_amounts.prescription.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_decline.additional_amounts.surcharge` (dictionary, nullable) The surcharge amount charged for this transaction by the merchant. - `elements.card_decline.additional_amounts.surcharge.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_decline.additional_amounts.surcharge.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_decline.additional_amounts.total_cumulative` (dictionary, nullable) The total amount of a series of incremental authorizations, optionally provided. - `elements.card_decline.additional_amounts.total_cumulative.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_decline.additional_amounts.total_cumulative.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_decline.additional_amounts.total_healthcare` (dictionary, nullable) The total amount of healthcare-related additional amounts. - `elements.card_decline.additional_amounts.total_healthcare.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_decline.additional_amounts.total_healthcare.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_decline.additional_amounts.transit` (dictionary, nullable) The part of this transaction amount that was for transit-related services. - `elements.card_decline.additional_amounts.transit.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_decline.additional_amounts.transit.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_decline.additional_amounts.unknown` (dictionary, nullable) An unknown additional amount. - `elements.card_decline.additional_amounts.unknown.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_decline.additional_amounts.unknown.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_decline.additional_amounts.vision` (dictionary, nullable) The part of this transaction amount that was for vision-related services. - `elements.card_decline.additional_amounts.vision.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_decline.additional_amounts.vision.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_decline.amount` (integer) The declined amount in the minor unit of the destination account currency. For dollars, for example, this is cents. - `elements.card_decline.card_payment_id` (string) The ID of the Card Payment this transaction belongs to. - `elements.card_decline.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the destination account currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_decline.declined_transaction_id` (string) The identifier of the declined transaction created for this Card Decline. - `elements.card_decline.digital_wallet_token_id` (string, nullable) If the authorization was made via a Digital Wallet Token (such as an Apple Pay purchase), the identifier of the token that was used. - `elements.card_decline.direction` (enum) The direction describes the direction the funds will move, either from the cardholder to the merchant or from the merchant to the cardholder. Cases: * `settlement` (A regular card authorization where funds are debited from the cardholder.) * `refund` (A refund card authorization, sometimes referred to as a credit voucher authorization, where funds are credited to the cardholder.) - `elements.card_decline.id` (string) The Card Decline identifier. - `elements.card_decline.incremented_card_authorization_id` (string, nullable) The identifier of the card authorization this request attempted to incrementally authorize. - `elements.card_decline.merchant_acceptor_id` (string) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `elements.card_decline.merchant_category_code` (string) The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with. - `elements.card_decline.merchant_city` (string, nullable) The city the merchant resides in. - `elements.card_decline.merchant_country` (string) The country the merchant resides in. - `elements.card_decline.merchant_descriptor` (string) The merchant descriptor of the merchant the card is transacting with. - `elements.card_decline.merchant_postal_code` (string, nullable) The merchant's postal code. For US merchants this is either a 5-digit or 9-digit ZIP code, where the first 5 and last 4 are separated by a dash. - `elements.card_decline.merchant_state` (string, nullable) The state the merchant resides in. - `elements.card_decline.network_details` (dictionary) Fields specific to the `network`. - `elements.card_decline.network_details.category` (enum) The payment network used to process this card authorization. Cases: * `visa` (Visa) * `pulse` (Pulse) - `elements.card_decline.network_details.pulse` (dictionary, nullable) Fields specific to the `pulse` network. - `elements.card_decline.network_details.visa` (dictionary, nullable) Fields specific to the `visa` network. - `elements.card_decline.network_details.visa.electronic_commerce_indicator` (enum, nullable) For electronic commerce transactions, this identifies the level of security used in obtaining the customer's payment credential. For mail or telephone order transactions, identifies the type of mail or telephone order. Cases: * `mail_phone_order` (Single transaction of a mail/phone order: Use to indicate that the transaction is a mail/phone order purchase, not a recurring transaction or installment payment. For domestic transactions in the US region, this value may also indicate one bill payment transaction in the card-present or card-absent environments.) * `recurring` (Recurring transaction: Payment indicator used to indicate a recurring transaction that originates from an acquirer in the US region.) * `installment` (Installment payment: Payment indicator used to indicate one purchase of goods or services that is billed to the account in multiple charges over a period of time agreed upon by the cardholder and merchant from transactions that originate from an acquirer in the US region.) * `unknown_mail_phone_order` (Unknown classification: other mail order: Use to indicate that the type of mail/telephone order is unknown.) * `secure_electronic_commerce` (Secure electronic commerce transaction: Use to indicate that the electronic commerce transaction has been authenticated using e.g., 3-D Secure) * `non_authenticated_security_transaction_at_3ds_capable_merchant` (Non-authenticated security transaction at a 3-D Secure-capable merchant, and merchant attempted to authenticate the cardholder using 3-D Secure: Use to identify an electronic commerce transaction where the merchant attempted to authenticate the cardholder using 3-D Secure, but was unable to complete the authentication because the issuer or cardholder does not participate in the 3-D Secure program.) * `non_authenticated_security_transaction` (Non-authenticated security transaction: Use to identify an electronic commerce transaction that uses data encryption for security however, cardholder authentication is not performed using 3-D Secure.) * `non_secure_transaction` (Non-secure transaction: Use to identify an electronic commerce transaction that has no data protection.) - `elements.card_decline.network_details.visa.point_of_service_entry_mode` (enum, nullable) The method used to enter the cardholder's primary account number and card expiration date. Cases: * `unknown` (Unknown) * `manual` (Manual key entry) * `magnetic_stripe_no_cvv` (Magnetic stripe read, without card verification value) * `optical_code` (Optical code) * `integrated_circuit_card` (Contact chip card) * `contactless` (Contactless read of chip card) * `credential_on_file` (Transaction initiated using a credential that has previously been stored on file) * `magnetic_stripe` (Magnetic stripe read) * `contactless_magnetic_stripe` (Contactless read of magnetic stripe data) * `integrated_circuit_card_no_cvv` (Contact chip card, without card verification value) - `elements.card_decline.network_details.visa.stand_in_processing_reason` (enum, nullable) Only present when `actioner: network`. Describes why a card authorization was approved or declined by Visa through stand-in processing. Cases: * `issuer_error` (Increase failed to process the authorization in a timely manner.) * `invalid_physical_card` (The physical card read had an invalid CVV or dCVV.) * `invalid_cryptogram` (The card's authorization request cryptogram was invalid. The cryptogram can be from a physical card or a Digital Wallet Token purchase.) * `invalid_cardholder_authentication_verification_value` (The 3DS cardholder authentication verification value was invalid.) * `internal_visa_error` (An internal Visa error occurred. Visa uses this reason code for certain expected occurrences as well, such as Application Transaction Counter (ATC) replays.) * `merchant_transaction_advisory_service_authentication_required` (The merchant has enabled Visa's Transaction Advisory Service and requires further authentication to perform the transaction. In practice this is often utilized at fuel pumps to tell the cardholder to see the cashier.) * `payment_fraud_disruption_acquirer_block` (The transaction was blocked by Visa's Payment Fraud Disruption service due to fraudulent Acquirer behavior, such as card testing.) * `other` (An unspecific reason for stand-in processing.) - `elements.card_decline.network_details.visa.terminal_entry_capability` (enum, nullable) The capability of the terminal being used to read the card. Shows whether a terminal can e.g., accept chip cards or if it only supports magnetic stripe reads. This reflects the highest capability of the terminal — for example, a terminal that supports both chip and magnetic stripe will be identified as chip-capable. Cases: * `unknown` (Unknown) * `terminal_not_used` (No terminal was used for this transaction.) * `magnetic_stripe` (The terminal can only read magnetic stripes and does not have chip or contactless reading capability.) * `barcode` (The terminal can only read barcodes.) * `optical_character_recognition` (The terminal can only read cards via Optical Character Recognition.) * `chip_or_contactless` (The terminal supports contact chip cards and can also read the magnetic stripe. If contact chip is supported, this value is used regardless of whether contactless is also supported.) * `contactless_only` (The terminal supports contactless reads but does not support contact chip. Only used when the terminal lacks contact chip capability.) * `no_capability` (The terminal has no card reading capability.) - `elements.card_decline.network_identifiers` (dictionary) Network-specific identifiers for a specific request or transaction. - `elements.card_decline.network_identifiers.authorization_identification_response` (string, nullable) The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response. - `elements.card_decline.network_identifiers.retrieval_reference_number` (string, nullable) A life-cycle identifier used across e.g., an authorization and a reversal. Expected to be unique per acquirer within a window of time. For some card networks the retrieval reference number includes the trace counter. - `elements.card_decline.network_identifiers.trace_number` (string, nullable) A counter used to verify an individual authorization. Expected to be unique per acquirer within a window of time. - `elements.card_decline.network_identifiers.transaction_id` (string, nullable) A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests. - `elements.card_decline.network_risk_score` (integer, nullable) The risk score generated by the card network. For Visa this is the Visa Advanced Authorization risk score, from 0 to 99, where 99 is the riskiest. For Pulse the score is from 0 to 999, where 999 is the riskiest. - `elements.card_decline.physical_card_id` (string, nullable) If the authorization was made in-person with a physical card, the Physical Card that was used. - `elements.card_decline.presentment_amount` (integer) The declined amount in the minor unit of the transaction's presentment currency. - `elements.card_decline.presentment_currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's presentment currency. - `elements.card_decline.processing_category` (enum) The processing category describes the intent behind the authorization, such as whether it was used for bill payments or an automatic fuel dispenser. Cases: * `account_funding` (Account funding transactions are transactions used to e.g., fund an account or transfer funds between accounts.) * `automatic_fuel_dispenser` (Automatic fuel dispenser authorizations occur when a card is used at a gas pump, prior to the actual transaction amount being known. They are followed by an advice message that updates the amount of the pending transaction.) * `bill_payment` (A transaction used to pay a bill.) * `original_credit` (Original credit transactions are used to send money to a cardholder.) * `purchase` (A regular purchase.) * `quasi_cash` (Quasi-cash transactions represent purchases of items which may be convertible to cash.) * `refund` (A refund card authorization, sometimes referred to as a credit voucher authorization, where funds are credited to the cardholder.) * `cash_disbursement` (Cash disbursement transactions are used to withdraw cash from an ATM or a point of sale.) * `balance_inquiry` (A balance inquiry transaction is used to check the balance of an account associated with a card.) * `unknown` (The processing category is unknown.) - `elements.card_decline.real_time_decision_id` (string, nullable) The identifier of the Real-Time Decision sent to approve or decline this transaction. - `elements.card_decline.real_time_decision_reason` (enum, nullable) This is present if a specific decline reason was given in the real-time decision. Cases: * `insufficient_funds` (The cardholder does not have sufficient funds to cover the transaction. The merchant may attempt to process the transaction again.) * `transaction_never_allowed` (This type of transaction is not allowed for this card. This transaction should not be retried.) * `exceeds_approval_limit` (The transaction amount exceeds the cardholder's approval limit. The merchant may attempt to process the transaction again.) * `card_temporarily_disabled` (The card has been temporarily disabled or not yet activated. The merchant may attempt to process the transaction again.) * `suspected_fraud` (The transaction is suspected to be fraudulent. The merchant may attempt to process the transaction again.) * `other` (The transaction was declined for another reason. The merchant may attempt to process the transaction again. This should be used sparingly.) - `elements.card_decline.reason` (enum) Why the transaction was declined. Cases: * `account_closed` (The account has been closed.) * `card_not_active` (The Card was not active.) * `card_canceled` (The Card has been canceled.) * `physical_card_not_active` (The Physical Card was not active.) * `entity_not_active` (The account's entity was not active.) * `group_locked` (The account was inactive.) * `insufficient_funds` (The Card's Account did not have a sufficient available balance.) * `cvv2_mismatch` (The given CVV2 did not match the card's value.) * `pin_mismatch` (The given PIN did not match the card's value.) * `card_expiration_mismatch` (The given expiration date did not match the card's value. Only applies when a CVV2 is present.) * `transaction_not_allowed` (The attempted card transaction is not allowed per Increase's terms.) * `breaches_limit` (The transaction was blocked by a Limit.) * `webhook_declined` (Your application declined the transaction via webhook.) * `webhook_timed_out` (Your application webhook did not respond without the required timeout.) * `declined_by_stand_in_processing` (Declined by stand-in processing.) * `invalid_physical_card` (The card read had an invalid CVV or dCVV.) * `missing_original_authorization` (The original card authorization for this incremental authorization does not exist.) * `invalid_cryptogram` (The card's authorization request cryptogram was invalid. The cryptogram can be from a physical card or a Digital Wallet Token purchase.) * `failed_3ds_authentication` (The transaction was declined because the 3DS authentication failed.) * `suspected_card_testing` (The transaction was suspected to be used by a card tester to test for valid card numbers.) * `suspected_fraud` (The transaction was suspected to be fraudulent. Please reach out to support@increase.com for more information.) - `elements.card_decline.scheme_fees` (array of objects) The scheme fees associated with this card decline. - `elements.card_decline.scheme_fees.amount` (string) The fee amount given as a string containing a decimal number. - `elements.card_decline.scheme_fees.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was created. - `elements.card_decline.scheme_fees.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_decline.scheme_fees.fee_type` (enum) The type of fee being assessed. Cases: * `visa_international_service_assessment_single_currency` (International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.) * `visa_international_service_assessment_cross_currency` (International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.) * `visa_authorization_domestic_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_international_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_canada_point_of_sale` (Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.) * `visa_authorization_reversal_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_reversal_international_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_address_verification_service` (A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.) * `visa_advanced_authorization` (Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).) * `visa_message_transmission` (Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.) * `visa_account_verification_domestic` (Activity, per inquiry, related to the domestic Issuer for Account Number Verification.) * `visa_account_verification_international` (Activity, per inquiry, related to the international Issuer for Account Number Verification.) * `visa_account_verification_canada` (Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.) * `visa_corporate_acceptance_fee` (The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_consumer_debit_acceptance_fee` (The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.) * `visa_business_debit_acceptance_fee` (The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.) * `visa_purchasing_acceptance_fee` (The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_purchase_domestic` (Activity and fees for the processing of a sales draft original for a purchase transaction.) * `visa_purchase_international` (Activity and fees for the processing of an international sales draft original for a purchase transaction.) * `visa_credit_purchase_token` (Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_debit_purchase_token` (Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_clearing_transmission` (A per transaction fee assessed for Base II financial draft - Issuer.) * `visa_direct_authorization` (Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.) * `visa_direct_transaction_domestic` (Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.) * `visa_service_commercial_credit` (Issuer card service fee for Commercial Credit cards.) * `visa_advertising_service_commercial_credit` (Issuer Advertising Service Fee for Commercial Credit cards.) * `visa_community_growth_acceleration_program` (Issuer Community Growth Acceleration Program Fee.) * `visa_processing_guarantee_commercial_credit` (Issuer Processing Guarantee for Commercial Credit cards.) * `pulse_switch_fee` (Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.) - `elements.card_decline.scheme_fees.fixed_component` (string, nullable) The fixed component of the fee, if applicable, given in major units of the fee amount. - `elements.card_decline.scheme_fees.variable_rate` (string, nullable) The variable rate component of the fee, if applicable, given as a decimal (e.g., 0.015 for 1.5%). - `elements.card_decline.terminal_id` (string, nullable) The terminal identifier (commonly abbreviated as TID) of the terminal the card is transacting with. - `elements.card_decline.verification` (dictionary) Fields related to verification of cardholder-provided values. - `elements.card_decline.verification.card_verification_code` (dictionary) Fields related to verification of the Card Verification Code, a 3-digit code on the back of the card. - `elements.card_decline.verification.card_verification_code.result` (enum) The result of verifying the Card Verification Code. Cases: * `not_checked` (No card verification code was provided in the authorization request.) * `match` (The card verification code matched the one on file.) * `no_match` (The card verification code did not match the one on file.) - `elements.card_decline.verification.cardholder_address` (dictionary) Cardholder address provided in the authorization request and the address on file we verified it against. - `elements.card_decline.verification.cardholder_address.actual_line1` (string, nullable) Line 1 of the address on file for the cardholder. - `elements.card_decline.verification.cardholder_address.actual_postal_code` (string, nullable) The postal code of the address on file for the cardholder. - `elements.card_decline.verification.cardholder_address.provided_line1` (string, nullable) The cardholder address line 1 provided for verification in the authorization request. - `elements.card_decline.verification.cardholder_address.provided_postal_code` (string, nullable) The postal code provided for verification in the authorization request. - `elements.card_decline.verification.cardholder_address.result` (enum) The address verification result returned to the card network. Cases: * `not_checked` (No address information was provided in the authorization request.) * `postal_code_match_address_no_match` (Postal code matches, but the street address does not match or was not provided.) * `postal_code_no_match_address_match` (Postal code does not match, but the street address matches or was not provided.) * `match` (Postal code and street address match.) * `no_match` (Postal code and street address do not match.) * `postal_code_match_address_not_checked` (Postal code matches, but the street address was not verified. (deprecated)) - `elements.card_decline.verification.cardholder_name` (dictionary, nullable) Cardholder name provided in the authorization request. - `elements.card_decline.verification.cardholder_name.provided_first_name` (string, nullable) The first name provided for verification in the authorization request. - `elements.card_decline.verification.cardholder_name.provided_last_name` (string, nullable) The last name provided for verification in the authorization request. - `elements.card_decline.verification.cardholder_name.provided_middle_name` (string, nullable) The middle name provided for verification in the authorization request. - `elements.card_financial` (dictionary, nullable) A Card Financial object. This field will be present in the JSON response if and only if `category` is equal to `card_financial`. Card Financials are temporary holds placed on a customer's funds with the intent to later clear a transaction. - `elements.card_financial.actioner` (enum) Whether this financial was approved by Increase, the card network through stand-in processing, or the user through a real-time decision. Cases: * `user` (This object was actioned by the user through a real-time decision.) * `increase` (This object was actioned by Increase without user intervention.) * `network` (This object was actioned by the network, through stand-in processing.) - `elements.card_financial.additional_amounts` (dictionary) Additional amounts associated with the card authorization, such as ATM surcharges fees. These are usually a subset of the `amount` field and are used to provide more detailed information about the transaction. - `elements.card_financial.additional_amounts.clinic` (dictionary, nullable) The part of this transaction amount that was for clinic-related services. - `elements.card_financial.additional_amounts.clinic.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_financial.additional_amounts.clinic.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_financial.additional_amounts.dental` (dictionary, nullable) The part of this transaction amount that was for dental-related services. - `elements.card_financial.additional_amounts.dental.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_financial.additional_amounts.dental.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_financial.additional_amounts.original` (dictionary, nullable) The original pre-authorized amount. - `elements.card_financial.additional_amounts.original.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_financial.additional_amounts.original.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_financial.additional_amounts.prescription` (dictionary, nullable) The part of this transaction amount that was for healthcare prescriptions. - `elements.card_financial.additional_amounts.prescription.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_financial.additional_amounts.prescription.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_financial.additional_amounts.surcharge` (dictionary, nullable) The surcharge amount charged for this transaction by the merchant. - `elements.card_financial.additional_amounts.surcharge.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_financial.additional_amounts.surcharge.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_financial.additional_amounts.total_cumulative` (dictionary, nullable) The total amount of a series of incremental authorizations, optionally provided. - `elements.card_financial.additional_amounts.total_cumulative.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_financial.additional_amounts.total_cumulative.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_financial.additional_amounts.total_healthcare` (dictionary, nullable) The total amount of healthcare-related additional amounts. - `elements.card_financial.additional_amounts.total_healthcare.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_financial.additional_amounts.total_healthcare.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_financial.additional_amounts.transit` (dictionary, nullable) The part of this transaction amount that was for transit-related services. - `elements.card_financial.additional_amounts.transit.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_financial.additional_amounts.transit.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_financial.additional_amounts.unknown` (dictionary, nullable) An unknown additional amount. - `elements.card_financial.additional_amounts.unknown.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_financial.additional_amounts.unknown.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_financial.additional_amounts.vision` (dictionary, nullable) The part of this transaction amount that was for vision-related services. - `elements.card_financial.additional_amounts.vision.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_financial.additional_amounts.vision.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_financial.amount` (integer) The pending amount in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `elements.card_financial.card_payment_id` (string) The ID of the Card Payment this transaction belongs to. - `elements.card_financial.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_financial.digital_wallet_token_id` (string, nullable) If the authorization was made via a Digital Wallet Token (such as an Apple Pay purchase), the identifier of the token that was used. - `elements.card_financial.direction` (enum) The direction describes the direction the funds will move, either from the cardholder to the merchant or from the merchant to the cardholder. Cases: * `settlement` (A regular card authorization where funds are debited from the cardholder.) * `refund` (A refund card authorization, sometimes referred to as a credit voucher authorization, where funds are credited to the cardholder.) - `elements.card_financial.id` (string) The Card Financial identifier. - `elements.card_financial.merchant_acceptor_id` (string) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `elements.card_financial.merchant_category_code` (string) The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with. - `elements.card_financial.merchant_city` (string, nullable) The city the merchant resides in. - `elements.card_financial.merchant_country` (string) The country the merchant resides in. - `elements.card_financial.merchant_descriptor` (string) The merchant descriptor of the merchant the card is transacting with. - `elements.card_financial.merchant_postal_code` (string, nullable) The merchant's postal code. For US merchants this is either a 5-digit or 9-digit ZIP code, where the first 5 and last 4 are separated by a dash. - `elements.card_financial.merchant_state` (string, nullable) The state the merchant resides in. - `elements.card_financial.network_details` (dictionary) Fields specific to the `network`. - `elements.card_financial.network_details.category` (enum) The payment network used to process this card authorization. Cases: * `visa` (Visa) * `pulse` (Pulse) - `elements.card_financial.network_details.pulse` (dictionary, nullable) Fields specific to the `pulse` network. - `elements.card_financial.network_details.visa` (dictionary, nullable) Fields specific to the `visa` network. - `elements.card_financial.network_details.visa.electronic_commerce_indicator` (enum, nullable) For electronic commerce transactions, this identifies the level of security used in obtaining the customer's payment credential. For mail or telephone order transactions, identifies the type of mail or telephone order. Cases: * `mail_phone_order` (Single transaction of a mail/phone order: Use to indicate that the transaction is a mail/phone order purchase, not a recurring transaction or installment payment. For domestic transactions in the US region, this value may also indicate one bill payment transaction in the card-present or card-absent environments.) * `recurring` (Recurring transaction: Payment indicator used to indicate a recurring transaction that originates from an acquirer in the US region.) * `installment` (Installment payment: Payment indicator used to indicate one purchase of goods or services that is billed to the account in multiple charges over a period of time agreed upon by the cardholder and merchant from transactions that originate from an acquirer in the US region.) * `unknown_mail_phone_order` (Unknown classification: other mail order: Use to indicate that the type of mail/telephone order is unknown.) * `secure_electronic_commerce` (Secure electronic commerce transaction: Use to indicate that the electronic commerce transaction has been authenticated using e.g., 3-D Secure) * `non_authenticated_security_transaction_at_3ds_capable_merchant` (Non-authenticated security transaction at a 3-D Secure-capable merchant, and merchant attempted to authenticate the cardholder using 3-D Secure: Use to identify an electronic commerce transaction where the merchant attempted to authenticate the cardholder using 3-D Secure, but was unable to complete the authentication because the issuer or cardholder does not participate in the 3-D Secure program.) * `non_authenticated_security_transaction` (Non-authenticated security transaction: Use to identify an electronic commerce transaction that uses data encryption for security however, cardholder authentication is not performed using 3-D Secure.) * `non_secure_transaction` (Non-secure transaction: Use to identify an electronic commerce transaction that has no data protection.) - `elements.card_financial.network_details.visa.point_of_service_entry_mode` (enum, nullable) The method used to enter the cardholder's primary account number and card expiration date. Cases: * `unknown` (Unknown) * `manual` (Manual key entry) * `magnetic_stripe_no_cvv` (Magnetic stripe read, without card verification value) * `optical_code` (Optical code) * `integrated_circuit_card` (Contact chip card) * `contactless` (Contactless read of chip card) * `credential_on_file` (Transaction initiated using a credential that has previously been stored on file) * `magnetic_stripe` (Magnetic stripe read) * `contactless_magnetic_stripe` (Contactless read of magnetic stripe data) * `integrated_circuit_card_no_cvv` (Contact chip card, without card verification value) - `elements.card_financial.network_details.visa.stand_in_processing_reason` (enum, nullable) Only present when `actioner: network`. Describes why a card authorization was approved or declined by Visa through stand-in processing. Cases: * `issuer_error` (Increase failed to process the authorization in a timely manner.) * `invalid_physical_card` (The physical card read had an invalid CVV or dCVV.) * `invalid_cryptogram` (The card's authorization request cryptogram was invalid. The cryptogram can be from a physical card or a Digital Wallet Token purchase.) * `invalid_cardholder_authentication_verification_value` (The 3DS cardholder authentication verification value was invalid.) * `internal_visa_error` (An internal Visa error occurred. Visa uses this reason code for certain expected occurrences as well, such as Application Transaction Counter (ATC) replays.) * `merchant_transaction_advisory_service_authentication_required` (The merchant has enabled Visa's Transaction Advisory Service and requires further authentication to perform the transaction. In practice this is often utilized at fuel pumps to tell the cardholder to see the cashier.) * `payment_fraud_disruption_acquirer_block` (The transaction was blocked by Visa's Payment Fraud Disruption service due to fraudulent Acquirer behavior, such as card testing.) * `other` (An unspecific reason for stand-in processing.) - `elements.card_financial.network_details.visa.terminal_entry_capability` (enum, nullable) The capability of the terminal being used to read the card. Shows whether a terminal can e.g., accept chip cards or if it only supports magnetic stripe reads. This reflects the highest capability of the terminal — for example, a terminal that supports both chip and magnetic stripe will be identified as chip-capable. Cases: * `unknown` (Unknown) * `terminal_not_used` (No terminal was used for this transaction.) * `magnetic_stripe` (The terminal can only read magnetic stripes and does not have chip or contactless reading capability.) * `barcode` (The terminal can only read barcodes.) * `optical_character_recognition` (The terminal can only read cards via Optical Character Recognition.) * `chip_or_contactless` (The terminal supports contact chip cards and can also read the magnetic stripe. If contact chip is supported, this value is used regardless of whether contactless is also supported.) * `contactless_only` (The terminal supports contactless reads but does not support contact chip. Only used when the terminal lacks contact chip capability.) * `no_capability` (The terminal has no card reading capability.) - `elements.card_financial.network_identifiers` (dictionary) Network-specific identifiers for a specific request or transaction. - `elements.card_financial.network_identifiers.authorization_identification_response` (string, nullable) The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response. - `elements.card_financial.network_identifiers.retrieval_reference_number` (string, nullable) A life-cycle identifier used across e.g., an authorization and a reversal. Expected to be unique per acquirer within a window of time. For some card networks the retrieval reference number includes the trace counter. - `elements.card_financial.network_identifiers.trace_number` (string, nullable) A counter used to verify an individual authorization. Expected to be unique per acquirer within a window of time. - `elements.card_financial.network_identifiers.transaction_id` (string, nullable) A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests. - `elements.card_financial.network_risk_score` (integer, nullable) The risk score generated by the card network. For Visa this is the Visa Advanced Authorization risk score, from 0 to 99, where 99 is the riskiest. For Pulse the score is from 0 to 999, where 999 is the riskiest. - `elements.card_financial.physical_card_id` (string, nullable) If the authorization was made in-person with a physical card, the Physical Card that was used. - `elements.card_financial.presentment_amount` (integer) The pending amount in the minor unit of the transaction's presentment currency. - `elements.card_financial.presentment_currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's presentment currency. - `elements.card_financial.processing_category` (enum) The processing category describes the intent behind the financial, such as whether it was used for bill payments or an automatic fuel dispenser. Cases: * `account_funding` (Account funding transactions are transactions used to e.g., fund an account or transfer funds between accounts.) * `automatic_fuel_dispenser` (Automatic fuel dispenser authorizations occur when a card is used at a gas pump, prior to the actual transaction amount being known. They are followed by an advice message that updates the amount of the pending transaction.) * `bill_payment` (A transaction used to pay a bill.) * `original_credit` (Original credit transactions are used to send money to a cardholder.) * `purchase` (A regular purchase.) * `quasi_cash` (Quasi-cash transactions represent purchases of items which may be convertible to cash.) * `refund` (A refund card authorization, sometimes referred to as a credit voucher authorization, where funds are credited to the cardholder.) * `cash_disbursement` (Cash disbursement transactions are used to withdraw cash from an ATM or a point of sale.) * `balance_inquiry` (A balance inquiry transaction is used to check the balance of an account associated with a card.) * `unknown` (The processing category is unknown.) - `elements.card_financial.real_time_decision_id` (string, nullable) The identifier of the Real-Time Decision sent to approve or decline this transaction. - `elements.card_financial.scheme_fees` (array of objects) The scheme fees associated with this card financial. - `elements.card_financial.scheme_fees.amount` (string) The fee amount given as a string containing a decimal number. - `elements.card_financial.scheme_fees.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was created. - `elements.card_financial.scheme_fees.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_financial.scheme_fees.fee_type` (enum) The type of fee being assessed. Cases: * `visa_international_service_assessment_single_currency` (International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.) * `visa_international_service_assessment_cross_currency` (International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.) * `visa_authorization_domestic_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_international_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_canada_point_of_sale` (Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.) * `visa_authorization_reversal_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_reversal_international_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_address_verification_service` (A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.) * `visa_advanced_authorization` (Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).) * `visa_message_transmission` (Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.) * `visa_account_verification_domestic` (Activity, per inquiry, related to the domestic Issuer for Account Number Verification.) * `visa_account_verification_international` (Activity, per inquiry, related to the international Issuer for Account Number Verification.) * `visa_account_verification_canada` (Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.) * `visa_corporate_acceptance_fee` (The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_consumer_debit_acceptance_fee` (The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.) * `visa_business_debit_acceptance_fee` (The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.) * `visa_purchasing_acceptance_fee` (The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_purchase_domestic` (Activity and fees for the processing of a sales draft original for a purchase transaction.) * `visa_purchase_international` (Activity and fees for the processing of an international sales draft original for a purchase transaction.) * `visa_credit_purchase_token` (Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_debit_purchase_token` (Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_clearing_transmission` (A per transaction fee assessed for Base II financial draft - Issuer.) * `visa_direct_authorization` (Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.) * `visa_direct_transaction_domestic` (Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.) * `visa_service_commercial_credit` (Issuer card service fee for Commercial Credit cards.) * `visa_advertising_service_commercial_credit` (Issuer Advertising Service Fee for Commercial Credit cards.) * `visa_community_growth_acceleration_program` (Issuer Community Growth Acceleration Program Fee.) * `visa_processing_guarantee_commercial_credit` (Issuer Processing Guarantee for Commercial Credit cards.) * `pulse_switch_fee` (Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.) - `elements.card_financial.scheme_fees.fixed_component` (string, nullable) The fixed component of the fee, if applicable, given in major units of the fee amount. - `elements.card_financial.scheme_fees.variable_rate` (string, nullable) The variable rate component of the fee, if applicable, given as a decimal (e.g., 0.015 for 1.5%). - `elements.card_financial.terminal_id` (string, nullable) The terminal identifier (commonly abbreviated as TID) of the terminal the card is transacting with. - `elements.card_financial.transaction_id` (string) The identifier of the Transaction associated with this Transaction. - `elements.card_financial.type` (string) A constant representing the object's type. For this resource it will always be `card_financial`. - `elements.card_financial.verification` (dictionary) Fields related to verification of cardholder-provided values. - `elements.card_financial.verification.card_verification_code` (dictionary) Fields related to verification of the Card Verification Code, a 3-digit code on the back of the card. - `elements.card_financial.verification.card_verification_code.result` (enum) The result of verifying the Card Verification Code. Cases: * `not_checked` (No card verification code was provided in the authorization request.) * `match` (The card verification code matched the one on file.) * `no_match` (The card verification code did not match the one on file.) - `elements.card_financial.verification.cardholder_address` (dictionary) Cardholder address provided in the authorization request and the address on file we verified it against. - `elements.card_financial.verification.cardholder_address.actual_line1` (string, nullable) Line 1 of the address on file for the cardholder. - `elements.card_financial.verification.cardholder_address.actual_postal_code` (string, nullable) The postal code of the address on file for the cardholder. - `elements.card_financial.verification.cardholder_address.provided_line1` (string, nullable) The cardholder address line 1 provided for verification in the authorization request. - `elements.card_financial.verification.cardholder_address.provided_postal_code` (string, nullable) The postal code provided for verification in the authorization request. - `elements.card_financial.verification.cardholder_address.result` (enum) The address verification result returned to the card network. Cases: * `not_checked` (No address information was provided in the authorization request.) * `postal_code_match_address_no_match` (Postal code matches, but the street address does not match or was not provided.) * `postal_code_no_match_address_match` (Postal code does not match, but the street address matches or was not provided.) * `match` (Postal code and street address match.) * `no_match` (Postal code and street address do not match.) * `postal_code_match_address_not_checked` (Postal code matches, but the street address was not verified. (deprecated)) - `elements.card_financial.verification.cardholder_name` (dictionary, nullable) Cardholder name provided in the authorization request. - `elements.card_financial.verification.cardholder_name.provided_first_name` (string, nullable) The first name provided for verification in the authorization request. - `elements.card_financial.verification.cardholder_name.provided_last_name` (string, nullable) The last name provided for verification in the authorization request. - `elements.card_financial.verification.cardholder_name.provided_middle_name` (string, nullable) The middle name provided for verification in the authorization request. - `elements.card_fuel_confirmation` (dictionary, nullable) A Card Fuel Confirmation object. This field will be present in the JSON response if and only if `category` is equal to `card_fuel_confirmation`. Card Fuel Confirmations update the amount of a Card Authorization after a fuel pump transaction is completed. - `elements.card_fuel_confirmation.card_authorization_id` (string) The identifier for the Card Authorization this updates. - `elements.card_fuel_confirmation.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the increment's currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_fuel_confirmation.id` (string) The Card Fuel Confirmation identifier. - `elements.card_fuel_confirmation.network` (enum) The card network used to process this card authorization. Cases: * `visa` (Visa) * `pulse` (Pulse) - `elements.card_fuel_confirmation.network_identifiers` (dictionary) Network-specific identifiers for a specific request or transaction. - `elements.card_fuel_confirmation.network_identifiers.authorization_identification_response` (string, nullable) The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response. - `elements.card_fuel_confirmation.network_identifiers.retrieval_reference_number` (string, nullable) A life-cycle identifier used across e.g., an authorization and a reversal. Expected to be unique per acquirer within a window of time. For some card networks the retrieval reference number includes the trace counter. - `elements.card_fuel_confirmation.network_identifiers.trace_number` (string, nullable) A counter used to verify an individual authorization. Expected to be unique per acquirer within a window of time. - `elements.card_fuel_confirmation.network_identifiers.transaction_id` (string, nullable) A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests. - `elements.card_fuel_confirmation.pending_transaction_id` (string, nullable) The identifier of the Pending Transaction associated with this Card Fuel Confirmation. - `elements.card_fuel_confirmation.scheme_fees` (array of objects) The scheme fees associated with this card fuel confirmation. - `elements.card_fuel_confirmation.scheme_fees.amount` (string) The fee amount given as a string containing a decimal number. - `elements.card_fuel_confirmation.scheme_fees.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was created. - `elements.card_fuel_confirmation.scheme_fees.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_fuel_confirmation.scheme_fees.fee_type` (enum) The type of fee being assessed. Cases: * `visa_international_service_assessment_single_currency` (International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.) * `visa_international_service_assessment_cross_currency` (International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.) * `visa_authorization_domestic_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_international_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_canada_point_of_sale` (Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.) * `visa_authorization_reversal_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_reversal_international_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_address_verification_service` (A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.) * `visa_advanced_authorization` (Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).) * `visa_message_transmission` (Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.) * `visa_account_verification_domestic` (Activity, per inquiry, related to the domestic Issuer for Account Number Verification.) * `visa_account_verification_international` (Activity, per inquiry, related to the international Issuer for Account Number Verification.) * `visa_account_verification_canada` (Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.) * `visa_corporate_acceptance_fee` (The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_consumer_debit_acceptance_fee` (The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.) * `visa_business_debit_acceptance_fee` (The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.) * `visa_purchasing_acceptance_fee` (The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_purchase_domestic` (Activity and fees for the processing of a sales draft original for a purchase transaction.) * `visa_purchase_international` (Activity and fees for the processing of an international sales draft original for a purchase transaction.) * `visa_credit_purchase_token` (Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_debit_purchase_token` (Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_clearing_transmission` (A per transaction fee assessed for Base II financial draft - Issuer.) * `visa_direct_authorization` (Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.) * `visa_direct_transaction_domestic` (Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.) * `visa_service_commercial_credit` (Issuer card service fee for Commercial Credit cards.) * `visa_advertising_service_commercial_credit` (Issuer Advertising Service Fee for Commercial Credit cards.) * `visa_community_growth_acceleration_program` (Issuer Community Growth Acceleration Program Fee.) * `visa_processing_guarantee_commercial_credit` (Issuer Processing Guarantee for Commercial Credit cards.) * `pulse_switch_fee` (Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.) - `elements.card_fuel_confirmation.scheme_fees.fixed_component` (string, nullable) The fixed component of the fee, if applicable, given in major units of the fee amount. - `elements.card_fuel_confirmation.scheme_fees.variable_rate` (string, nullable) The variable rate component of the fee, if applicable, given as a decimal (e.g., 0.015 for 1.5%). - `elements.card_fuel_confirmation.type` (string) A constant representing the object's type. For this resource it will always be `card_fuel_confirmation`. - `elements.card_fuel_confirmation.updated_authorization_amount` (integer) The updated authorization amount after this fuel confirmation, in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `elements.card_increment` (dictionary, nullable) A Card Increment object. This field will be present in the JSON response if and only if `category` is equal to `card_increment`. Card Increments increase the pending amount of an authorized transaction. - `elements.card_increment.actioner` (enum) Whether this authorization was approved by Increase, the card network through stand-in processing, or the user through a real-time decision. Cases: * `user` (This object was actioned by the user through a real-time decision.) * `increase` (This object was actioned by Increase without user intervention.) * `network` (This object was actioned by the network, through stand-in processing.) - `elements.card_increment.additional_amounts` (dictionary) Additional amounts associated with the card authorization, such as ATM surcharges fees. These are usually a subset of the `amount` field and are used to provide more detailed information about the transaction. - `elements.card_increment.additional_amounts.clinic` (dictionary, nullable) The part of this transaction amount that was for clinic-related services. - `elements.card_increment.additional_amounts.clinic.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_increment.additional_amounts.clinic.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_increment.additional_amounts.dental` (dictionary, nullable) The part of this transaction amount that was for dental-related services. - `elements.card_increment.additional_amounts.dental.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_increment.additional_amounts.dental.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_increment.additional_amounts.original` (dictionary, nullable) The original pre-authorized amount. - `elements.card_increment.additional_amounts.original.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_increment.additional_amounts.original.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_increment.additional_amounts.prescription` (dictionary, nullable) The part of this transaction amount that was for healthcare prescriptions. - `elements.card_increment.additional_amounts.prescription.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_increment.additional_amounts.prescription.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_increment.additional_amounts.surcharge` (dictionary, nullable) The surcharge amount charged for this transaction by the merchant. - `elements.card_increment.additional_amounts.surcharge.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_increment.additional_amounts.surcharge.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_increment.additional_amounts.total_cumulative` (dictionary, nullable) The total amount of a series of incremental authorizations, optionally provided. - `elements.card_increment.additional_amounts.total_cumulative.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_increment.additional_amounts.total_cumulative.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_increment.additional_amounts.total_healthcare` (dictionary, nullable) The total amount of healthcare-related additional amounts. - `elements.card_increment.additional_amounts.total_healthcare.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_increment.additional_amounts.total_healthcare.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_increment.additional_amounts.transit` (dictionary, nullable) The part of this transaction amount that was for transit-related services. - `elements.card_increment.additional_amounts.transit.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_increment.additional_amounts.transit.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_increment.additional_amounts.unknown` (dictionary, nullable) An unknown additional amount. - `elements.card_increment.additional_amounts.unknown.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_increment.additional_amounts.unknown.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_increment.additional_amounts.vision` (dictionary, nullable) The part of this transaction amount that was for vision-related services. - `elements.card_increment.additional_amounts.vision.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_increment.additional_amounts.vision.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_increment.amount` (integer) The amount of this increment in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `elements.card_increment.card_authorization_id` (string) The identifier for the Card Authorization this increments. - `elements.card_increment.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the increment's currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_increment.id` (string) The Card Increment identifier. - `elements.card_increment.network` (enum) The card network used to process this card authorization. Cases: * `visa` (Visa) * `pulse` (Pulse) - `elements.card_increment.network_identifiers` (dictionary) Network-specific identifiers for a specific request or transaction. - `elements.card_increment.network_identifiers.authorization_identification_response` (string, nullable) The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response. - `elements.card_increment.network_identifiers.retrieval_reference_number` (string, nullable) A life-cycle identifier used across e.g., an authorization and a reversal. Expected to be unique per acquirer within a window of time. For some card networks the retrieval reference number includes the trace counter. - `elements.card_increment.network_identifiers.trace_number` (string, nullable) A counter used to verify an individual authorization. Expected to be unique per acquirer within a window of time. - `elements.card_increment.network_identifiers.transaction_id` (string, nullable) A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests. - `elements.card_increment.network_risk_score` (integer, nullable) The risk score generated by the card network. For Visa this is the Visa Advanced Authorization risk score, from 0 to 99, where 99 is the riskiest. - `elements.card_increment.pending_transaction_id` (string, nullable) The identifier of the Pending Transaction associated with this Card Increment. - `elements.card_increment.presentment_amount` (integer) The amount of this increment in the minor unit of the transaction's presentment currency. - `elements.card_increment.presentment_currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's presentment currency. - `elements.card_increment.real_time_decision_id` (string, nullable) The identifier of the Real-Time Decision sent to approve or decline this incremental authorization. - `elements.card_increment.scheme_fees` (array of objects) The scheme fees associated with this card increment. - `elements.card_increment.scheme_fees.amount` (string) The fee amount given as a string containing a decimal number. - `elements.card_increment.scheme_fees.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was created. - `elements.card_increment.scheme_fees.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_increment.scheme_fees.fee_type` (enum) The type of fee being assessed. Cases: * `visa_international_service_assessment_single_currency` (International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.) * `visa_international_service_assessment_cross_currency` (International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.) * `visa_authorization_domestic_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_international_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_canada_point_of_sale` (Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.) * `visa_authorization_reversal_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_reversal_international_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_address_verification_service` (A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.) * `visa_advanced_authorization` (Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).) * `visa_message_transmission` (Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.) * `visa_account_verification_domestic` (Activity, per inquiry, related to the domestic Issuer for Account Number Verification.) * `visa_account_verification_international` (Activity, per inquiry, related to the international Issuer for Account Number Verification.) * `visa_account_verification_canada` (Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.) * `visa_corporate_acceptance_fee` (The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_consumer_debit_acceptance_fee` (The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.) * `visa_business_debit_acceptance_fee` (The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.) * `visa_purchasing_acceptance_fee` (The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_purchase_domestic` (Activity and fees for the processing of a sales draft original for a purchase transaction.) * `visa_purchase_international` (Activity and fees for the processing of an international sales draft original for a purchase transaction.) * `visa_credit_purchase_token` (Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_debit_purchase_token` (Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_clearing_transmission` (A per transaction fee assessed for Base II financial draft - Issuer.) * `visa_direct_authorization` (Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.) * `visa_direct_transaction_domestic` (Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.) * `visa_service_commercial_credit` (Issuer card service fee for Commercial Credit cards.) * `visa_advertising_service_commercial_credit` (Issuer Advertising Service Fee for Commercial Credit cards.) * `visa_community_growth_acceleration_program` (Issuer Community Growth Acceleration Program Fee.) * `visa_processing_guarantee_commercial_credit` (Issuer Processing Guarantee for Commercial Credit cards.) * `pulse_switch_fee` (Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.) - `elements.card_increment.scheme_fees.fixed_component` (string, nullable) The fixed component of the fee, if applicable, given in major units of the fee amount. - `elements.card_increment.scheme_fees.variable_rate` (string, nullable) The variable rate component of the fee, if applicable, given as a decimal (e.g., 0.015 for 1.5%). - `elements.card_increment.type` (string) A constant representing the object's type. For this resource it will always be `card_increment`. - `elements.card_increment.updated_authorization_amount` (integer) The updated authorization amount after this increment, in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `elements.card_refund` (dictionary, nullable) A Card Refund object. This field will be present in the JSON response if and only if `category` is equal to `card_refund`. Card Refunds move money back to the cardholder. While they are usually connected to a Card Settlement, an acquirer can also refund money directly to a card without relation to a transaction. - `elements.card_refund.amount` (integer) The amount in the minor unit of the transaction's settlement currency. For dollars, for example, this is cents. - `elements.card_refund.card_payment_id` (string) The ID of the Card Payment this transaction belongs to. - `elements.card_refund.cashback` (dictionary, nullable) Cashback debited for this transaction, if eligible. Cashback is paid out in aggregate, monthly. - `elements.card_refund.cashback.amount` (string) The cashback amount given as a string containing a decimal number. The amount is a positive number if it will be credited to you (e.g., settlements) and a negative number if it will be debited (e.g., refunds). - `elements.card_refund.cashback.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the cashback. Cases: * `USD` (US Dollar (USD)) - `elements.card_refund.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's settlement currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_refund.id` (string) The Card Refund identifier. - `elements.card_refund.interchange` (dictionary, nullable) Interchange assessed as a part of this transaction. - `elements.card_refund.interchange.amount` (string) The interchange amount given as a string containing a decimal number in major units (so e.g., "3.14" for $3.14). The amount is a positive number if it is credited to Increase (e.g., settlements) and a negative number if it is debited (e.g., refunds). - `elements.card_refund.interchange.code` (string, nullable) The card network specific interchange code. - `elements.card_refund.interchange.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the interchange reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_refund.merchant_acceptor_id` (string) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `elements.card_refund.merchant_category_code` (string) The 4-digit MCC describing the merchant's business. - `elements.card_refund.merchant_city` (string) The city the merchant resides in. - `elements.card_refund.merchant_country` (string) The country the merchant resides in. - `elements.card_refund.merchant_name` (string) The name of the merchant. - `elements.card_refund.merchant_postal_code` (string, nullable) The merchant's postal code. For US merchants this is always a 5-digit ZIP code. - `elements.card_refund.merchant_state` (string, nullable) The state the merchant resides in. - `elements.card_refund.network_identifiers` (dictionary) Network-specific identifiers for this refund. - `elements.card_refund.network_identifiers.acquirer_business_id` (string) A network assigned business ID that identifies the acquirer that processed this transaction. - `elements.card_refund.network_identifiers.acquirer_reference_number` (string) A globally unique identifier for this settlement. - `elements.card_refund.network_identifiers.authorization_identification_response` (string, nullable) The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response. - `elements.card_refund.network_identifiers.transaction_id` (string, nullable) A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests. - `elements.card_refund.presentment_amount` (integer) The amount in the minor unit of the transaction's presentment currency. - `elements.card_refund.presentment_currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's presentment currency. - `elements.card_refund.purchase_details` (dictionary, nullable) Additional details about the card purchase, such as tax and industry-specific fields. - `elements.card_refund.purchase_details.car_rental` (dictionary, nullable) Fields specific to car rentals. - `elements.card_refund.purchase_details.car_rental.car_class_code` (string, nullable) Code indicating the vehicle's class. - `elements.card_refund.purchase_details.car_rental.checkout_date` (string, nullable) Date the customer picked up the car or, in the case of a no-show or pre-pay transaction, the scheduled pick up date. - `elements.card_refund.purchase_details.car_rental.daily_rental_rate_amount` (integer, nullable) Daily rate being charged for the vehicle. - `elements.card_refund.purchase_details.car_rental.daily_rental_rate_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the daily rental rate. - `elements.card_refund.purchase_details.car_rental.days_rented` (integer, nullable) Number of days the vehicle was rented. - `elements.card_refund.purchase_details.car_rental.extra_charges` (enum, nullable) Additional charges (gas, late fee, etc.) being billed. Cases: * `no_extra_charge` (No extra charge) * `gas` (Gas) * `extra_mileage` (Extra mileage) * `late_return` (Late return) * `one_way_service_fee` (One way service fee) * `parking_violation` (Parking violation) - `elements.card_refund.purchase_details.car_rental.fuel_charges_amount` (integer, nullable) Fuel charges for the vehicle. - `elements.card_refund.purchase_details.car_rental.fuel_charges_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fuel charges assessed. - `elements.card_refund.purchase_details.car_rental.insurance_charges_amount` (integer, nullable) Any insurance being charged for the vehicle. - `elements.card_refund.purchase_details.car_rental.insurance_charges_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the insurance charges assessed. - `elements.card_refund.purchase_details.car_rental.no_show_indicator` (enum, nullable) An indicator that the cardholder is being billed for a reserved vehicle that was not actually rented (that is, a "no-show" charge). Cases: * `not_applicable` (Not applicable) * `no_show_for_specialized_vehicle` (No show for specialized vehicle) - `elements.card_refund.purchase_details.car_rental.one_way_drop_off_charges_amount` (integer, nullable) Charges for returning the vehicle at a different location than where it was picked up. - `elements.card_refund.purchase_details.car_rental.one_way_drop_off_charges_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the one-way drop-off charges assessed. - `elements.card_refund.purchase_details.car_rental.renter_name` (string, nullable) Name of the person renting the vehicle. - `elements.card_refund.purchase_details.car_rental.weekly_rental_rate_amount` (integer, nullable) Weekly rate being charged for the vehicle. - `elements.card_refund.purchase_details.car_rental.weekly_rental_rate_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the weekly rental rate. - `elements.card_refund.purchase_details.customer_reference_identifier` (string, nullable) An identifier from the merchant for the customer or consumer. - `elements.card_refund.purchase_details.local_tax_amount` (integer, nullable) The state or provincial tax amount in minor units. - `elements.card_refund.purchase_details.local_tax_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the local tax assessed. - `elements.card_refund.purchase_details.lodging` (dictionary, nullable) Fields specific to lodging. - `elements.card_refund.purchase_details.lodging.check_in_date` (string, nullable) Date the customer checked in. - `elements.card_refund.purchase_details.lodging.daily_room_rate_amount` (integer, nullable) Daily rate being charged for the room. - `elements.card_refund.purchase_details.lodging.daily_room_rate_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the daily room rate. - `elements.card_refund.purchase_details.lodging.extra_charges` (enum, nullable) Additional charges (phone, late check-out, etc.) being billed. Cases: * `no_extra_charge` (No extra charge) * `restaurant` (Restaurant) * `gift_shop` (Gift shop) * `mini_bar` (Mini bar) * `telephone` (Telephone) * `other` (Other) * `laundry` (Laundry) - `elements.card_refund.purchase_details.lodging.folio_cash_advances_amount` (integer, nullable) Folio cash advances for the room. - `elements.card_refund.purchase_details.lodging.folio_cash_advances_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the folio cash advances. - `elements.card_refund.purchase_details.lodging.food_beverage_charges_amount` (integer, nullable) Food and beverage charges for the room. - `elements.card_refund.purchase_details.lodging.food_beverage_charges_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the food and beverage charges. - `elements.card_refund.purchase_details.lodging.no_show_indicator` (enum, nullable) Indicator that the cardholder is being billed for a reserved room that was not actually used. Cases: * `not_applicable` (Not applicable) * `no_show` (No show) - `elements.card_refund.purchase_details.lodging.prepaid_expenses_amount` (integer, nullable) Prepaid expenses being charged for the room. - `elements.card_refund.purchase_details.lodging.prepaid_expenses_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the prepaid expenses. - `elements.card_refund.purchase_details.lodging.room_nights` (integer, nullable) Number of nights the room was rented. - `elements.card_refund.purchase_details.lodging.total_room_tax_amount` (integer, nullable) Total room tax being charged. - `elements.card_refund.purchase_details.lodging.total_room_tax_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the total room tax. - `elements.card_refund.purchase_details.lodging.total_tax_amount` (integer, nullable) Total tax being charged for the room. - `elements.card_refund.purchase_details.lodging.total_tax_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the total tax assessed. - `elements.card_refund.purchase_details.national_tax_amount` (integer, nullable) The national tax amount in minor units. - `elements.card_refund.purchase_details.national_tax_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the local tax assessed. - `elements.card_refund.purchase_details.purchase_identifier` (string, nullable) An identifier from the merchant for the purchase to the issuer and cardholder. - `elements.card_refund.purchase_details.purchase_identifier_format` (enum, nullable) The format of the purchase identifier. Cases: * `free_text` (Free text) * `order_number` (Order number) * `rental_agreement_number` (Rental agreement number) * `hotel_folio_number` (Hotel folio number) * `invoice_number` (Invoice number) - `elements.card_refund.purchase_details.travel` (dictionary, nullable) Fields specific to travel. - `elements.card_refund.purchase_details.travel.ancillary` (dictionary, nullable) Ancillary purchases in addition to the airfare. - `elements.card_refund.purchase_details.travel.ancillary.connected_ticket_document_number` (string, nullable) If this purchase has a connection or relationship to another purchase, such as a baggage fee for a passenger transport ticket, this field should contain the ticket document number for the other purchase. - `elements.card_refund.purchase_details.travel.ancillary.credit_reason_indicator` (enum, nullable) Indicates the reason for a credit to the cardholder. Cases: * `no_credit` (No credit) * `passenger_transport_ancillary_purchase_cancellation` (Passenger transport ancillary purchase cancellation) * `airline_ticket_and_passenger_transport_ancillary_purchase_cancellation` (Airline ticket and passenger transport ancillary purchase cancellation) * `other` (Other) - `elements.card_refund.purchase_details.travel.ancillary.passenger_name_or_description` (string, nullable) Name of the passenger or description of the ancillary purchase. - `elements.card_refund.purchase_details.travel.ancillary.services` (array of objects) Additional travel charges, such as baggage fees. - `elements.card_refund.purchase_details.travel.ancillary.services.category` (enum, nullable) Category of the ancillary service. Cases: * `none` (None) * `bundled_service` (Bundled service) * `baggage_fee` (Baggage fee) * `change_fee` (Change fee) * `cargo` (Cargo) * `carbon_offset` (Carbon offset) * `frequent_flyer` (Frequent flyer) * `gift_card` (Gift card) * `ground_transport` (Ground transport) * `in_flight_entertainment` (In-flight entertainment) * `lounge` (Lounge) * `medical` (Medical) * `meal_beverage` (Meal beverage) * `other` (Other) * `passenger_assist_fee` (Passenger assist fee) * `pets` (Pets) * `seat_fees` (Seat fees) * `standby` (Standby) * `service_fee` (Service fee) * `store` (Store) * `travel_service` (Travel service) * `unaccompanied_travel` (Unaccompanied travel) * `upgrades` (Upgrades) * `wifi` (Wi-fi) - `elements.card_refund.purchase_details.travel.ancillary.services.sub_category` (string, nullable) Sub-category of the ancillary service, free-form. - `elements.card_refund.purchase_details.travel.ancillary.ticket_document_number` (string, nullable) Ticket document number. - `elements.card_refund.purchase_details.travel.computerized_reservation_system` (string, nullable) Indicates the computerized reservation system used to book the ticket. - `elements.card_refund.purchase_details.travel.credit_reason_indicator` (enum, nullable) Indicates the reason for a credit to the cardholder. Cases: * `no_credit` (No credit) * `passenger_transport_ancillary_purchase_cancellation` (Passenger transport ancillary purchase cancellation) * `airline_ticket_and_passenger_transport_ancillary_purchase_cancellation` (Airline ticket and passenger transport ancillary purchase cancellation) * `airline_ticket_cancellation` (Airline ticket cancellation) * `other` (Other) * `partial_refund_of_airline_ticket` (Partial refund of airline ticket) - `elements.card_refund.purchase_details.travel.departure_date` (string, nullable) Date of departure. - `elements.card_refund.purchase_details.travel.origination_city_airport_code` (string, nullable) Code for the originating city or airport. - `elements.card_refund.purchase_details.travel.passenger_name` (string, nullable) Name of the passenger. - `elements.card_refund.purchase_details.travel.restricted_ticket_indicator` (enum, nullable) Indicates whether this ticket is non-refundable. Cases: * `no_restrictions` (No restrictions) * `restricted_non_refundable_ticket` (Restricted non-refundable ticket) - `elements.card_refund.purchase_details.travel.ticket_change_indicator` (enum, nullable) Indicates why a ticket was changed. Cases: * `none` (None) * `change_to_existing_ticket` (Change to existing ticket) * `new_ticket` (New ticket) - `elements.card_refund.purchase_details.travel.ticket_number` (string, nullable) Ticket number. - `elements.card_refund.purchase_details.travel.travel_agency_code` (string, nullable) Code for the travel agency if the ticket was issued by a travel agency. - `elements.card_refund.purchase_details.travel.travel_agency_name` (string, nullable) Name of the travel agency if the ticket was issued by a travel agency. - `elements.card_refund.purchase_details.travel.trip_legs` (array of objects, nullable) Fields specific to each leg of the journey. - `elements.card_refund.purchase_details.travel.trip_legs.carrier_code` (string, nullable) Carrier code (e.g., United Airlines, Jet Blue, etc.). - `elements.card_refund.purchase_details.travel.trip_legs.destination_city_airport_code` (string, nullable) Code for the destination city or airport. - `elements.card_refund.purchase_details.travel.trip_legs.fare_basis_code` (string, nullable) Fare basis code. - `elements.card_refund.purchase_details.travel.trip_legs.flight_number` (string, nullable) Flight number. - `elements.card_refund.purchase_details.travel.trip_legs.service_class` (string, nullable) Service class (e.g., first class, business class, etc.). - `elements.card_refund.purchase_details.travel.trip_legs.stop_over_code` (enum, nullable) Indicates whether a stopover is allowed on this ticket. Cases: * `none` (None) * `stop_over_allowed` (Stop over allowed) * `stop_over_not_allowed` (Stop over not allowed) - `elements.card_refund.scheme_fees` (array of objects) The scheme fees associated with this card refund. - `elements.card_refund.scheme_fees.amount` (string) The fee amount given as a string containing a decimal number. - `elements.card_refund.scheme_fees.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was created. - `elements.card_refund.scheme_fees.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_refund.scheme_fees.fee_type` (enum) The type of fee being assessed. Cases: * `visa_international_service_assessment_single_currency` (International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.) * `visa_international_service_assessment_cross_currency` (International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.) * `visa_authorization_domestic_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_international_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_canada_point_of_sale` (Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.) * `visa_authorization_reversal_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_reversal_international_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_address_verification_service` (A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.) * `visa_advanced_authorization` (Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).) * `visa_message_transmission` (Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.) * `visa_account_verification_domestic` (Activity, per inquiry, related to the domestic Issuer for Account Number Verification.) * `visa_account_verification_international` (Activity, per inquiry, related to the international Issuer for Account Number Verification.) * `visa_account_verification_canada` (Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.) * `visa_corporate_acceptance_fee` (The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_consumer_debit_acceptance_fee` (The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.) * `visa_business_debit_acceptance_fee` (The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.) * `visa_purchasing_acceptance_fee` (The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_purchase_domestic` (Activity and fees for the processing of a sales draft original for a purchase transaction.) * `visa_purchase_international` (Activity and fees for the processing of an international sales draft original for a purchase transaction.) * `visa_credit_purchase_token` (Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_debit_purchase_token` (Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_clearing_transmission` (A per transaction fee assessed for Base II financial draft - Issuer.) * `visa_direct_authorization` (Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.) * `visa_direct_transaction_domestic` (Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.) * `visa_service_commercial_credit` (Issuer card service fee for Commercial Credit cards.) * `visa_advertising_service_commercial_credit` (Issuer Advertising Service Fee for Commercial Credit cards.) * `visa_community_growth_acceleration_program` (Issuer Community Growth Acceleration Program Fee.) * `visa_processing_guarantee_commercial_credit` (Issuer Processing Guarantee for Commercial Credit cards.) * `pulse_switch_fee` (Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.) - `elements.card_refund.scheme_fees.fixed_component` (string, nullable) The fixed component of the fee, if applicable, given in major units of the fee amount. - `elements.card_refund.scheme_fees.variable_rate` (string, nullable) The variable rate component of the fee, if applicable, given as a decimal (e.g., 0.015 for 1.5%). - `elements.card_refund.transaction_id` (string) The identifier of the Transaction associated with this Transaction. - `elements.card_refund.type` (string) A constant representing the object's type. For this resource it will always be `card_refund`. - `elements.card_reversal` (dictionary, nullable) A Card Reversal object. This field will be present in the JSON response if and only if `category` is equal to `card_reversal`. Card Reversals cancel parts of or the entirety of an existing Card Authorization. - `elements.card_reversal.card_authorization_id` (string) The identifier for the Card Authorization this reverses. - `elements.card_reversal.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the reversal's currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_reversal.id` (string) The Card Reversal identifier. - `elements.card_reversal.merchant_acceptor_id` (string) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `elements.card_reversal.merchant_category_code` (string) The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with. - `elements.card_reversal.merchant_city` (string, nullable) The city the merchant resides in. - `elements.card_reversal.merchant_country` (string, nullable) The country the merchant resides in. - `elements.card_reversal.merchant_descriptor` (string) The merchant descriptor of the merchant the card is transacting with. - `elements.card_reversal.merchant_postal_code` (string, nullable) The merchant's postal code. For US merchants this is either a 5-digit or 9-digit ZIP code, where the first 5 and last 4 are separated by a dash. - `elements.card_reversal.merchant_state` (string, nullable) The state the merchant resides in. - `elements.card_reversal.network` (enum) The card network used to process this card authorization. Cases: * `visa` (Visa) * `pulse` (Pulse) - `elements.card_reversal.network_identifiers` (dictionary) Network-specific identifiers for a specific request or transaction. - `elements.card_reversal.network_identifiers.authorization_identification_response` (string, nullable) The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response. - `elements.card_reversal.network_identifiers.retrieval_reference_number` (string, nullable) A life-cycle identifier used across e.g., an authorization and a reversal. Expected to be unique per acquirer within a window of time. For some card networks the retrieval reference number includes the trace counter. - `elements.card_reversal.network_identifiers.trace_number` (string, nullable) A counter used to verify an individual authorization. Expected to be unique per acquirer within a window of time. - `elements.card_reversal.network_identifiers.transaction_id` (string, nullable) A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests. - `elements.card_reversal.pending_transaction_id` (string, nullable) The identifier of the Pending Transaction associated with this Card Reversal. - `elements.card_reversal.presentment_currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the reversal's presentment currency. - `elements.card_reversal.reversal_amount` (integer) The amount of this reversal in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `elements.card_reversal.reversal_presentment_amount` (integer) The amount of this reversal in the minor unit of the transaction's presentment currency. For dollars, for example, this is cents. - `elements.card_reversal.reversal_reason` (enum, nullable) Why this reversal was initiated. Cases: * `reversed_by_customer` (The Card Reversal was initiated at the customer's request.) * `reversed_by_network_or_acquirer` (The Card Reversal was initiated by the network or acquirer.) * `reversed_by_point_of_sale` (The Card Reversal was initiated by the point of sale device.) * `partial_reversal` (The Card Reversal was a partial reversal, for any reason.) - `elements.card_reversal.scheme_fees` (array of objects) The scheme fees associated with this card reversal. - `elements.card_reversal.scheme_fees.amount` (string) The fee amount given as a string containing a decimal number. - `elements.card_reversal.scheme_fees.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was created. - `elements.card_reversal.scheme_fees.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_reversal.scheme_fees.fee_type` (enum) The type of fee being assessed. Cases: * `visa_international_service_assessment_single_currency` (International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.) * `visa_international_service_assessment_cross_currency` (International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.) * `visa_authorization_domestic_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_international_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_canada_point_of_sale` (Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.) * `visa_authorization_reversal_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_reversal_international_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_address_verification_service` (A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.) * `visa_advanced_authorization` (Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).) * `visa_message_transmission` (Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.) * `visa_account_verification_domestic` (Activity, per inquiry, related to the domestic Issuer for Account Number Verification.) * `visa_account_verification_international` (Activity, per inquiry, related to the international Issuer for Account Number Verification.) * `visa_account_verification_canada` (Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.) * `visa_corporate_acceptance_fee` (The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_consumer_debit_acceptance_fee` (The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.) * `visa_business_debit_acceptance_fee` (The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.) * `visa_purchasing_acceptance_fee` (The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_purchase_domestic` (Activity and fees for the processing of a sales draft original for a purchase transaction.) * `visa_purchase_international` (Activity and fees for the processing of an international sales draft original for a purchase transaction.) * `visa_credit_purchase_token` (Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_debit_purchase_token` (Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_clearing_transmission` (A per transaction fee assessed for Base II financial draft - Issuer.) * `visa_direct_authorization` (Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.) * `visa_direct_transaction_domestic` (Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.) * `visa_service_commercial_credit` (Issuer card service fee for Commercial Credit cards.) * `visa_advertising_service_commercial_credit` (Issuer Advertising Service Fee for Commercial Credit cards.) * `visa_community_growth_acceleration_program` (Issuer Community Growth Acceleration Program Fee.) * `visa_processing_guarantee_commercial_credit` (Issuer Processing Guarantee for Commercial Credit cards.) * `pulse_switch_fee` (Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.) - `elements.card_reversal.scheme_fees.fixed_component` (string, nullable) The fixed component of the fee, if applicable, given in major units of the fee amount. - `elements.card_reversal.scheme_fees.variable_rate` (string, nullable) The variable rate component of the fee, if applicable, given as a decimal (e.g., 0.015 for 1.5%). - `elements.card_reversal.terminal_id` (string, nullable) The terminal identifier (commonly abbreviated as TID) of the terminal the card is transacting with. - `elements.card_reversal.type` (string) A constant representing the object's type. For this resource it will always be `card_reversal`. - `elements.card_reversal.updated_authorization_amount` (integer) The amount left pending on the Card Authorization in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `elements.card_reversal.updated_authorization_presentment_amount` (integer) The amount left pending on the Card Authorization in the minor unit of the transaction's presentment currency. For dollars, for example, this is cents. - `elements.card_settlement` (dictionary, nullable) A Card Settlement object. This field will be present in the JSON response if and only if `category` is equal to `card_settlement`. Card Settlements are card transactions that have cleared and settled. While a settlement is usually preceded by an authorization, an acquirer can also directly clear a transaction without first authorizing it. - `elements.card_settlement.amount` (integer) The amount in the minor unit of the transaction's settlement currency. For dollars, for example, this is cents. - `elements.card_settlement.card_authorization` (string, nullable) The Card Authorization that was created prior to this Card Settlement, if one exists. - `elements.card_settlement.card_payment_id` (string) The ID of the Card Payment this transaction belongs to. - `elements.card_settlement.cashback` (dictionary, nullable) Cashback earned on this transaction, if eligible. Cashback is paid out in aggregate, monthly. - `elements.card_settlement.cashback.amount` (string) The cashback amount given as a string containing a decimal number. The amount is a positive number if it will be credited to you (e.g., settlements) and a negative number if it will be debited (e.g., refunds). - `elements.card_settlement.cashback.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the cashback. Cases: * `USD` (US Dollar (USD)) - `elements.card_settlement.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's settlement currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_settlement.id` (string) The Card Settlement identifier. - `elements.card_settlement.interchange` (dictionary, nullable) Interchange assessed as a part of this transaction. - `elements.card_settlement.interchange.amount` (string) The interchange amount given as a string containing a decimal number in major units (so e.g., "3.14" for $3.14). The amount is a positive number if it is credited to Increase (e.g., settlements) and a negative number if it is debited (e.g., refunds). - `elements.card_settlement.interchange.code` (string, nullable) The card network specific interchange code. - `elements.card_settlement.interchange.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the interchange reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_settlement.merchant_acceptor_id` (string) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `elements.card_settlement.merchant_category_code` (string) The 4-digit MCC describing the merchant's business. - `elements.card_settlement.merchant_city` (string) The city the merchant resides in. - `elements.card_settlement.merchant_country` (string) The country the merchant resides in. - `elements.card_settlement.merchant_name` (string) The name of the merchant. - `elements.card_settlement.merchant_postal_code` (string, nullable) The merchant's postal code. For US merchants this is always a 5-digit ZIP code. - `elements.card_settlement.merchant_state` (string, nullable) The state the merchant resides in. - `elements.card_settlement.network` (enum) The card network on which this transaction was processed. Cases: * `visa` (Visa) * `pulse` (Pulse) - `elements.card_settlement.network_identifiers` (dictionary) Network-specific identifiers for this refund. - `elements.card_settlement.network_identifiers.acquirer_business_id` (string) A network assigned business ID that identifies the acquirer that processed this transaction. - `elements.card_settlement.network_identifiers.acquirer_reference_number` (string) A globally unique identifier for this settlement. - `elements.card_settlement.network_identifiers.authorization_identification_response` (string, nullable) The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response. - `elements.card_settlement.network_identifiers.transaction_id` (string, nullable) A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests. - `elements.card_settlement.pending_transaction_id` (string, nullable) The identifier of the Pending Transaction associated with this Transaction. - `elements.card_settlement.presentment_amount` (integer) The amount in the minor unit of the transaction's presentment currency. - `elements.card_settlement.presentment_currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's presentment currency. - `elements.card_settlement.purchase_details` (dictionary, nullable) Additional details about the card purchase, such as tax and industry-specific fields. - `elements.card_settlement.purchase_details.car_rental` (dictionary, nullable) Fields specific to car rentals. - `elements.card_settlement.purchase_details.car_rental.car_class_code` (string, nullable) Code indicating the vehicle's class. - `elements.card_settlement.purchase_details.car_rental.checkout_date` (string, nullable) Date the customer picked up the car or, in the case of a no-show or pre-pay transaction, the scheduled pick up date. - `elements.card_settlement.purchase_details.car_rental.daily_rental_rate_amount` (integer, nullable) Daily rate being charged for the vehicle. - `elements.card_settlement.purchase_details.car_rental.daily_rental_rate_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the daily rental rate. - `elements.card_settlement.purchase_details.car_rental.days_rented` (integer, nullable) Number of days the vehicle was rented. - `elements.card_settlement.purchase_details.car_rental.extra_charges` (enum, nullable) Additional charges (gas, late fee, etc.) being billed. Cases: * `no_extra_charge` (No extra charge) * `gas` (Gas) * `extra_mileage` (Extra mileage) * `late_return` (Late return) * `one_way_service_fee` (One way service fee) * `parking_violation` (Parking violation) - `elements.card_settlement.purchase_details.car_rental.fuel_charges_amount` (integer, nullable) Fuel charges for the vehicle. - `elements.card_settlement.purchase_details.car_rental.fuel_charges_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fuel charges assessed. - `elements.card_settlement.purchase_details.car_rental.insurance_charges_amount` (integer, nullable) Any insurance being charged for the vehicle. - `elements.card_settlement.purchase_details.car_rental.insurance_charges_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the insurance charges assessed. - `elements.card_settlement.purchase_details.car_rental.no_show_indicator` (enum, nullable) An indicator that the cardholder is being billed for a reserved vehicle that was not actually rented (that is, a "no-show" charge). Cases: * `not_applicable` (Not applicable) * `no_show_for_specialized_vehicle` (No show for specialized vehicle) - `elements.card_settlement.purchase_details.car_rental.one_way_drop_off_charges_amount` (integer, nullable) Charges for returning the vehicle at a different location than where it was picked up. - `elements.card_settlement.purchase_details.car_rental.one_way_drop_off_charges_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the one-way drop-off charges assessed. - `elements.card_settlement.purchase_details.car_rental.renter_name` (string, nullable) Name of the person renting the vehicle. - `elements.card_settlement.purchase_details.car_rental.weekly_rental_rate_amount` (integer, nullable) Weekly rate being charged for the vehicle. - `elements.card_settlement.purchase_details.car_rental.weekly_rental_rate_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the weekly rental rate. - `elements.card_settlement.purchase_details.customer_reference_identifier` (string, nullable) An identifier from the merchant for the customer or consumer. - `elements.card_settlement.purchase_details.local_tax_amount` (integer, nullable) The state or provincial tax amount in minor units. - `elements.card_settlement.purchase_details.local_tax_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the local tax assessed. - `elements.card_settlement.purchase_details.lodging` (dictionary, nullable) Fields specific to lodging. - `elements.card_settlement.purchase_details.lodging.check_in_date` (string, nullable) Date the customer checked in. - `elements.card_settlement.purchase_details.lodging.daily_room_rate_amount` (integer, nullable) Daily rate being charged for the room. - `elements.card_settlement.purchase_details.lodging.daily_room_rate_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the daily room rate. - `elements.card_settlement.purchase_details.lodging.extra_charges` (enum, nullable) Additional charges (phone, late check-out, etc.) being billed. Cases: * `no_extra_charge` (No extra charge) * `restaurant` (Restaurant) * `gift_shop` (Gift shop) * `mini_bar` (Mini bar) * `telephone` (Telephone) * `other` (Other) * `laundry` (Laundry) - `elements.card_settlement.purchase_details.lodging.folio_cash_advances_amount` (integer, nullable) Folio cash advances for the room. - `elements.card_settlement.purchase_details.lodging.folio_cash_advances_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the folio cash advances. - `elements.card_settlement.purchase_details.lodging.food_beverage_charges_amount` (integer, nullable) Food and beverage charges for the room. - `elements.card_settlement.purchase_details.lodging.food_beverage_charges_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the food and beverage charges. - `elements.card_settlement.purchase_details.lodging.no_show_indicator` (enum, nullable) Indicator that the cardholder is being billed for a reserved room that was not actually used. Cases: * `not_applicable` (Not applicable) * `no_show` (No show) - `elements.card_settlement.purchase_details.lodging.prepaid_expenses_amount` (integer, nullable) Prepaid expenses being charged for the room. - `elements.card_settlement.purchase_details.lodging.prepaid_expenses_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the prepaid expenses. - `elements.card_settlement.purchase_details.lodging.room_nights` (integer, nullable) Number of nights the room was rented. - `elements.card_settlement.purchase_details.lodging.total_room_tax_amount` (integer, nullable) Total room tax being charged. - `elements.card_settlement.purchase_details.lodging.total_room_tax_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the total room tax. - `elements.card_settlement.purchase_details.lodging.total_tax_amount` (integer, nullable) Total tax being charged for the room. - `elements.card_settlement.purchase_details.lodging.total_tax_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the total tax assessed. - `elements.card_settlement.purchase_details.national_tax_amount` (integer, nullable) The national tax amount in minor units. - `elements.card_settlement.purchase_details.national_tax_currency` (string, nullable) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the local tax assessed. - `elements.card_settlement.purchase_details.purchase_identifier` (string, nullable) An identifier from the merchant for the purchase to the issuer and cardholder. - `elements.card_settlement.purchase_details.purchase_identifier_format` (enum, nullable) The format of the purchase identifier. Cases: * `free_text` (Free text) * `order_number` (Order number) * `rental_agreement_number` (Rental agreement number) * `hotel_folio_number` (Hotel folio number) * `invoice_number` (Invoice number) - `elements.card_settlement.purchase_details.travel` (dictionary, nullable) Fields specific to travel. - `elements.card_settlement.purchase_details.travel.ancillary` (dictionary, nullable) Ancillary purchases in addition to the airfare. - `elements.card_settlement.purchase_details.travel.ancillary.connected_ticket_document_number` (string, nullable) If this purchase has a connection or relationship to another purchase, such as a baggage fee for a passenger transport ticket, this field should contain the ticket document number for the other purchase. - `elements.card_settlement.purchase_details.travel.ancillary.credit_reason_indicator` (enum, nullable) Indicates the reason for a credit to the cardholder. Cases: * `no_credit` (No credit) * `passenger_transport_ancillary_purchase_cancellation` (Passenger transport ancillary purchase cancellation) * `airline_ticket_and_passenger_transport_ancillary_purchase_cancellation` (Airline ticket and passenger transport ancillary purchase cancellation) * `other` (Other) - `elements.card_settlement.purchase_details.travel.ancillary.passenger_name_or_description` (string, nullable) Name of the passenger or description of the ancillary purchase. - `elements.card_settlement.purchase_details.travel.ancillary.services` (array of objects) Additional travel charges, such as baggage fees. - `elements.card_settlement.purchase_details.travel.ancillary.services.category` (enum, nullable) Category of the ancillary service. Cases: * `none` (None) * `bundled_service` (Bundled service) * `baggage_fee` (Baggage fee) * `change_fee` (Change fee) * `cargo` (Cargo) * `carbon_offset` (Carbon offset) * `frequent_flyer` (Frequent flyer) * `gift_card` (Gift card) * `ground_transport` (Ground transport) * `in_flight_entertainment` (In-flight entertainment) * `lounge` (Lounge) * `medical` (Medical) * `meal_beverage` (Meal beverage) * `other` (Other) * `passenger_assist_fee` (Passenger assist fee) * `pets` (Pets) * `seat_fees` (Seat fees) * `standby` (Standby) * `service_fee` (Service fee) * `store` (Store) * `travel_service` (Travel service) * `unaccompanied_travel` (Unaccompanied travel) * `upgrades` (Upgrades) * `wifi` (Wi-fi) - `elements.card_settlement.purchase_details.travel.ancillary.services.sub_category` (string, nullable) Sub-category of the ancillary service, free-form. - `elements.card_settlement.purchase_details.travel.ancillary.ticket_document_number` (string, nullable) Ticket document number. - `elements.card_settlement.purchase_details.travel.computerized_reservation_system` (string, nullable) Indicates the computerized reservation system used to book the ticket. - `elements.card_settlement.purchase_details.travel.credit_reason_indicator` (enum, nullable) Indicates the reason for a credit to the cardholder. Cases: * `no_credit` (No credit) * `passenger_transport_ancillary_purchase_cancellation` (Passenger transport ancillary purchase cancellation) * `airline_ticket_and_passenger_transport_ancillary_purchase_cancellation` (Airline ticket and passenger transport ancillary purchase cancellation) * `airline_ticket_cancellation` (Airline ticket cancellation) * `other` (Other) * `partial_refund_of_airline_ticket` (Partial refund of airline ticket) - `elements.card_settlement.purchase_details.travel.departure_date` (string, nullable) Date of departure. - `elements.card_settlement.purchase_details.travel.origination_city_airport_code` (string, nullable) Code for the originating city or airport. - `elements.card_settlement.purchase_details.travel.passenger_name` (string, nullable) Name of the passenger. - `elements.card_settlement.purchase_details.travel.restricted_ticket_indicator` (enum, nullable) Indicates whether this ticket is non-refundable. Cases: * `no_restrictions` (No restrictions) * `restricted_non_refundable_ticket` (Restricted non-refundable ticket) - `elements.card_settlement.purchase_details.travel.ticket_change_indicator` (enum, nullable) Indicates why a ticket was changed. Cases: * `none` (None) * `change_to_existing_ticket` (Change to existing ticket) * `new_ticket` (New ticket) - `elements.card_settlement.purchase_details.travel.ticket_number` (string, nullable) Ticket number. - `elements.card_settlement.purchase_details.travel.travel_agency_code` (string, nullable) Code for the travel agency if the ticket was issued by a travel agency. - `elements.card_settlement.purchase_details.travel.travel_agency_name` (string, nullable) Name of the travel agency if the ticket was issued by a travel agency. - `elements.card_settlement.purchase_details.travel.trip_legs` (array of objects, nullable) Fields specific to each leg of the journey. - `elements.card_settlement.purchase_details.travel.trip_legs.carrier_code` (string, nullable) Carrier code (e.g., United Airlines, Jet Blue, etc.). - `elements.card_settlement.purchase_details.travel.trip_legs.destination_city_airport_code` (string, nullable) Code for the destination city or airport. - `elements.card_settlement.purchase_details.travel.trip_legs.fare_basis_code` (string, nullable) Fare basis code. - `elements.card_settlement.purchase_details.travel.trip_legs.flight_number` (string, nullable) Flight number. - `elements.card_settlement.purchase_details.travel.trip_legs.service_class` (string, nullable) Service class (e.g., first class, business class, etc.). - `elements.card_settlement.purchase_details.travel.trip_legs.stop_over_code` (enum, nullable) Indicates whether a stopover is allowed on this ticket. Cases: * `none` (None) * `stop_over_allowed` (Stop over allowed) * `stop_over_not_allowed` (Stop over not allowed) - `elements.card_settlement.scheme_fees` (array of objects) The scheme fees associated with this card settlement. - `elements.card_settlement.scheme_fees.amount` (string) The fee amount given as a string containing a decimal number. - `elements.card_settlement.scheme_fees.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was created. - `elements.card_settlement.scheme_fees.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_settlement.scheme_fees.fee_type` (enum) The type of fee being assessed. Cases: * `visa_international_service_assessment_single_currency` (International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.) * `visa_international_service_assessment_cross_currency` (International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.) * `visa_authorization_domestic_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_international_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_canada_point_of_sale` (Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.) * `visa_authorization_reversal_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_reversal_international_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_address_verification_service` (A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.) * `visa_advanced_authorization` (Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).) * `visa_message_transmission` (Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.) * `visa_account_verification_domestic` (Activity, per inquiry, related to the domestic Issuer for Account Number Verification.) * `visa_account_verification_international` (Activity, per inquiry, related to the international Issuer for Account Number Verification.) * `visa_account_verification_canada` (Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.) * `visa_corporate_acceptance_fee` (The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_consumer_debit_acceptance_fee` (The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.) * `visa_business_debit_acceptance_fee` (The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.) * `visa_purchasing_acceptance_fee` (The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_purchase_domestic` (Activity and fees for the processing of a sales draft original for a purchase transaction.) * `visa_purchase_international` (Activity and fees for the processing of an international sales draft original for a purchase transaction.) * `visa_credit_purchase_token` (Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_debit_purchase_token` (Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_clearing_transmission` (A per transaction fee assessed for Base II financial draft - Issuer.) * `visa_direct_authorization` (Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.) * `visa_direct_transaction_domestic` (Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.) * `visa_service_commercial_credit` (Issuer card service fee for Commercial Credit cards.) * `visa_advertising_service_commercial_credit` (Issuer Advertising Service Fee for Commercial Credit cards.) * `visa_community_growth_acceleration_program` (Issuer Community Growth Acceleration Program Fee.) * `visa_processing_guarantee_commercial_credit` (Issuer Processing Guarantee for Commercial Credit cards.) * `pulse_switch_fee` (Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.) - `elements.card_settlement.scheme_fees.fixed_component` (string, nullable) The fixed component of the fee, if applicable, given in major units of the fee amount. - `elements.card_settlement.scheme_fees.variable_rate` (string, nullable) The variable rate component of the fee, if applicable, given as a decimal (e.g., 0.015 for 1.5%). - `elements.card_settlement.surcharge` (dictionary, nullable) Surcharge amount details, if applicable. The amount is positive if the surcharge is added to the overall transaction amount (surcharge), and negative if the surcharge is deducted from the overall transaction amount (discount). - `elements.card_settlement.surcharge.amount` (integer) The surcharge amount in the minor unit of the transaction's settlement currency. - `elements.card_settlement.surcharge.presentment_amount` (integer) The surcharge amount in the minor unit of the transaction's presentment currency. - `elements.card_settlement.transaction_id` (string) The identifier of the Transaction associated with this Transaction. - `elements.card_settlement.type` (string) A constant representing the object's type. For this resource it will always be `card_settlement`. - `elements.card_validation` (dictionary, nullable) An Inbound Card Validation object. This field will be present in the JSON response if and only if `category` is equal to `card_validation`. Inbound Card Validations are requests from a merchant to verify that a card number and optionally its address and/or Card Verification Value are valid. - `elements.card_validation.actioner` (enum) Whether this authorization was approved by Increase, the card network through stand-in processing, or the user through a real-time decision. Cases: * `user` (This object was actioned by the user through a real-time decision.) * `increase` (This object was actioned by Increase without user intervention.) * `network` (This object was actioned by the network, through stand-in processing.) - `elements.card_validation.additional_amounts` (dictionary) Additional amounts associated with the card authorization, such as ATM surcharges fees. These are usually a subset of the `amount` field and are used to provide more detailed information about the transaction. - `elements.card_validation.additional_amounts.clinic` (dictionary, nullable) The part of this transaction amount that was for clinic-related services. - `elements.card_validation.additional_amounts.clinic.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_validation.additional_amounts.clinic.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_validation.additional_amounts.dental` (dictionary, nullable) The part of this transaction amount that was for dental-related services. - `elements.card_validation.additional_amounts.dental.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_validation.additional_amounts.dental.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_validation.additional_amounts.original` (dictionary, nullable) The original pre-authorized amount. - `elements.card_validation.additional_amounts.original.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_validation.additional_amounts.original.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_validation.additional_amounts.prescription` (dictionary, nullable) The part of this transaction amount that was for healthcare prescriptions. - `elements.card_validation.additional_amounts.prescription.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_validation.additional_amounts.prescription.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_validation.additional_amounts.surcharge` (dictionary, nullable) The surcharge amount charged for this transaction by the merchant. - `elements.card_validation.additional_amounts.surcharge.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_validation.additional_amounts.surcharge.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_validation.additional_amounts.total_cumulative` (dictionary, nullable) The total amount of a series of incremental authorizations, optionally provided. - `elements.card_validation.additional_amounts.total_cumulative.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_validation.additional_amounts.total_cumulative.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_validation.additional_amounts.total_healthcare` (dictionary, nullable) The total amount of healthcare-related additional amounts. - `elements.card_validation.additional_amounts.total_healthcare.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_validation.additional_amounts.total_healthcare.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_validation.additional_amounts.transit` (dictionary, nullable) The part of this transaction amount that was for transit-related services. - `elements.card_validation.additional_amounts.transit.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_validation.additional_amounts.transit.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_validation.additional_amounts.unknown` (dictionary, nullable) An unknown additional amount. - `elements.card_validation.additional_amounts.unknown.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_validation.additional_amounts.unknown.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_validation.additional_amounts.vision` (dictionary, nullable) The part of this transaction amount that was for vision-related services. - `elements.card_validation.additional_amounts.vision.amount` (integer) The amount in minor units of the `currency` field. The amount is positive if it is added to the amount (such as an ATM surcharge fee) and negative if it is subtracted from the amount (such as a discount). - `elements.card_validation.additional_amounts.vision.currency` (string) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the additional amount's currency. - `elements.card_validation.card_payment_id` (string) The ID of the Card Payment this transaction belongs to. - `elements.card_validation.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transaction's currency. Cases: * `USD` (US Dollar (USD)) - `elements.card_validation.digital_wallet_token_id` (string, nullable) If the authorization was made via a Digital Wallet Token (such as an Apple Pay purchase), the identifier of the token that was used. - `elements.card_validation.id` (string) The Card Validation identifier. - `elements.card_validation.merchant_acceptor_id` (string) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `elements.card_validation.merchant_category_code` (string) The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with. - `elements.card_validation.merchant_city` (string, nullable) The city the merchant resides in. - `elements.card_validation.merchant_country` (string) The country the merchant resides in. - `elements.card_validation.merchant_descriptor` (string) The merchant descriptor of the merchant the card is transacting with. - `elements.card_validation.merchant_postal_code` (string, nullable) The merchant's postal code. For US merchants this is either a 5-digit or 9-digit ZIP code, where the first 5 and last 4 are separated by a dash. - `elements.card_validation.merchant_state` (string, nullable) The state the merchant resides in. - `elements.card_validation.network_details` (dictionary) Fields specific to the `network`. - `elements.card_validation.network_details.category` (enum) The payment network used to process this card authorization. Cases: * `visa` (Visa) * `pulse` (Pulse) - `elements.card_validation.network_details.pulse` (dictionary, nullable) Fields specific to the `pulse` network. - `elements.card_validation.network_details.visa` (dictionary, nullable) Fields specific to the `visa` network. - `elements.card_validation.network_details.visa.electronic_commerce_indicator` (enum, nullable) For electronic commerce transactions, this identifies the level of security used in obtaining the customer's payment credential. For mail or telephone order transactions, identifies the type of mail or telephone order. Cases: * `mail_phone_order` (Single transaction of a mail/phone order: Use to indicate that the transaction is a mail/phone order purchase, not a recurring transaction or installment payment. For domestic transactions in the US region, this value may also indicate one bill payment transaction in the card-present or card-absent environments.) * `recurring` (Recurring transaction: Payment indicator used to indicate a recurring transaction that originates from an acquirer in the US region.) * `installment` (Installment payment: Payment indicator used to indicate one purchase of goods or services that is billed to the account in multiple charges over a period of time agreed upon by the cardholder and merchant from transactions that originate from an acquirer in the US region.) * `unknown_mail_phone_order` (Unknown classification: other mail order: Use to indicate that the type of mail/telephone order is unknown.) * `secure_electronic_commerce` (Secure electronic commerce transaction: Use to indicate that the electronic commerce transaction has been authenticated using e.g., 3-D Secure) * `non_authenticated_security_transaction_at_3ds_capable_merchant` (Non-authenticated security transaction at a 3-D Secure-capable merchant, and merchant attempted to authenticate the cardholder using 3-D Secure: Use to identify an electronic commerce transaction where the merchant attempted to authenticate the cardholder using 3-D Secure, but was unable to complete the authentication because the issuer or cardholder does not participate in the 3-D Secure program.) * `non_authenticated_security_transaction` (Non-authenticated security transaction: Use to identify an electronic commerce transaction that uses data encryption for security however, cardholder authentication is not performed using 3-D Secure.) * `non_secure_transaction` (Non-secure transaction: Use to identify an electronic commerce transaction that has no data protection.) - `elements.card_validation.network_details.visa.point_of_service_entry_mode` (enum, nullable) The method used to enter the cardholder's primary account number and card expiration date. Cases: * `unknown` (Unknown) * `manual` (Manual key entry) * `magnetic_stripe_no_cvv` (Magnetic stripe read, without card verification value) * `optical_code` (Optical code) * `integrated_circuit_card` (Contact chip card) * `contactless` (Contactless read of chip card) * `credential_on_file` (Transaction initiated using a credential that has previously been stored on file) * `magnetic_stripe` (Magnetic stripe read) * `contactless_magnetic_stripe` (Contactless read of magnetic stripe data) * `integrated_circuit_card_no_cvv` (Contact chip card, without card verification value) - `elements.card_validation.network_details.visa.stand_in_processing_reason` (enum, nullable) Only present when `actioner: network`. Describes why a card authorization was approved or declined by Visa through stand-in processing. Cases: * `issuer_error` (Increase failed to process the authorization in a timely manner.) * `invalid_physical_card` (The physical card read had an invalid CVV or dCVV.) * `invalid_cryptogram` (The card's authorization request cryptogram was invalid. The cryptogram can be from a physical card or a Digital Wallet Token purchase.) * `invalid_cardholder_authentication_verification_value` (The 3DS cardholder authentication verification value was invalid.) * `internal_visa_error` (An internal Visa error occurred. Visa uses this reason code for certain expected occurrences as well, such as Application Transaction Counter (ATC) replays.) * `merchant_transaction_advisory_service_authentication_required` (The merchant has enabled Visa's Transaction Advisory Service and requires further authentication to perform the transaction. In practice this is often utilized at fuel pumps to tell the cardholder to see the cashier.) * `payment_fraud_disruption_acquirer_block` (The transaction was blocked by Visa's Payment Fraud Disruption service due to fraudulent Acquirer behavior, such as card testing.) * `other` (An unspecific reason for stand-in processing.) - `elements.card_validation.network_details.visa.terminal_entry_capability` (enum, nullable) The capability of the terminal being used to read the card. Shows whether a terminal can e.g., accept chip cards or if it only supports magnetic stripe reads. This reflects the highest capability of the terminal — for example, a terminal that supports both chip and magnetic stripe will be identified as chip-capable. Cases: * `unknown` (Unknown) * `terminal_not_used` (No terminal was used for this transaction.) * `magnetic_stripe` (The terminal can only read magnetic stripes and does not have chip or contactless reading capability.) * `barcode` (The terminal can only read barcodes.) * `optical_character_recognition` (The terminal can only read cards via Optical Character Recognition.) * `chip_or_contactless` (The terminal supports contact chip cards and can also read the magnetic stripe. If contact chip is supported, this value is used regardless of whether contactless is also supported.) * `contactless_only` (The terminal supports contactless reads but does not support contact chip. Only used when the terminal lacks contact chip capability.) * `no_capability` (The terminal has no card reading capability.) - `elements.card_validation.network_identifiers` (dictionary) Network-specific identifiers for a specific request or transaction. - `elements.card_validation.network_identifiers.authorization_identification_response` (string, nullable) The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response. - `elements.card_validation.network_identifiers.retrieval_reference_number` (string, nullable) A life-cycle identifier used across e.g., an authorization and a reversal. Expected to be unique per acquirer within a window of time. For some card networks the retrieval reference number includes the trace counter. - `elements.card_validation.network_identifiers.trace_number` (string, nullable) A counter used to verify an individual authorization. Expected to be unique per acquirer within a window of time. - `elements.card_validation.network_identifiers.transaction_id` (string, nullable) A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests. - `elements.card_validation.network_risk_score` (integer, nullable) The risk score generated by the card network. For Visa this is the Visa Advanced Authorization risk score, from 0 to 99, where 99 is the riskiest. For Pulse the score is from 0 to 999, where 999 is the riskiest. - `elements.card_validation.physical_card_id` (string, nullable) If the authorization was made in-person with a physical card, the Physical Card that was used. - `elements.card_validation.real_time_decision_id` (string, nullable) The identifier of the Real-Time Decision sent to approve or decline this transaction. - `elements.card_validation.scheme_fees` (array of objects) The scheme fees associated with this card validation. - `elements.card_validation.scheme_fees.amount` (string) The fee amount given as a string containing a decimal number. - `elements.card_validation.scheme_fees.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the fee was created. - `elements.card_validation.scheme_fees.currency` (enum) The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the fee reimbursement. Cases: * `USD` (US Dollar (USD)) - `elements.card_validation.scheme_fees.fee_type` (enum) The type of fee being assessed. Cases: * `visa_international_service_assessment_single_currency` (International Service Assessment (ISA) single-currency is a fee assessed by the card network for cross-border transactions presented and settled in the same currency.) * `visa_international_service_assessment_cross_currency` (International Service Assessment (ISA) cross-currency is a fee assessed by the card network for cross-border transactions presented and settled in different currencies.) * `visa_authorization_domestic_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_international_point_of_sale` (Activity and charges for Visa Settlement System processing for POS (Point-Of-Sale) International authorization transactions. Authorization is the process of approving or declining the transaction amount specified. The fee is assessed to the Issuer.) * `visa_authorization_canada_point_of_sale` (Activity and charges for Visa Settlement System processing for Canada Region POS (Point-of-Sale) authorization transactions. Authorization is the process of approving or declining the transaction amount specified.) * `visa_authorization_reversal_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_reversal_international_point_of_sale` (Activity only for Visa Settlement System authorization processing of POS (Point-Of-Sale) International reversal transactions. Authorization reversal represents a VSS message that undoes the complete or partial actions of a previous authorization request.) * `visa_authorization_address_verification_service` (A per Address Verification Service (AVS) result fee. Applies to all usable AVS result codes.) * `visa_advanced_authorization` (Advanced Authorization is a fraud detection tool that monitors and risk evaluates 100 percent of US VisaNet authorizations in real-time. Activity related to Purchase (includes Signature Authenticated Visa and PIN Authenticated Visa Debit (PAVD) transactions).) * `visa_message_transmission` (Issuer Transactions Visa represents a charge based on total actual monthly processing (Visa transactions only) through a VisaNet Access Point (VAP). Charges are assessed to the processor for each VisaNet Access Point.) * `visa_account_verification_domestic` (Activity, per inquiry, related to the domestic Issuer for Account Number Verification.) * `visa_account_verification_international` (Activity, per inquiry, related to the international Issuer for Account Number Verification.) * `visa_account_verification_canada` (Activity, per inquiry, related to the US-Canada Issuer for Account Number Verification.) * `visa_corporate_acceptance_fee` (The Corporate Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_consumer_debit_acceptance_fee` (The Consumer Debit Acceptance Fee is charged to issuers and is based on the monthly sales volume of Consumer Debit or Prepaid card transactions. The cashback portion of a Debit and Prepaid card transaction is excluded from the sales volume calculation.) * `visa_business_debit_acceptance_fee` (The Business Acceptance Fee is charged to issuers and is based on the monthly sales volume on Business Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions. The cashback portion is included in the sales volume calculation with the exception of a Debit and Prepaid card transactions.) * `visa_purchasing_acceptance_fee` (The Purchasing Card Acceptance Fee is charged to issuers and is based on the monthly sales volume on Commercial and Government Debit, Prepaid, Credit, Charge, or Deferred Debit card transactions.) * `visa_purchase_domestic` (Activity and fees for the processing of a sales draft original for a purchase transaction.) * `visa_purchase_international` (Activity and fees for the processing of an international sales draft original for a purchase transaction.) * `visa_credit_purchase_token` (Apple Pay Credit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_debit_purchase_token` (Apple Pay Debit Product Token Purchase Original Transactions. This fee is billed by Visa on behalf of Apple Inc. for Apple Pay transactions.) * `visa_clearing_transmission` (A per transaction fee assessed for Base II financial draft - Issuer.) * `visa_direct_authorization` (Issuer charge for Non-Financial OCT/AFT Authorization 0100 and Declined Financial OCT/AFT 0200 transactions.) * `visa_direct_transaction_domestic` (Data processing charge for Visa Direct OCTs for all business application identifiers (BAIs) other than money transfer-bank initiated (BI). BASE II transactions.) * `visa_service_commercial_credit` (Issuer card service fee for Commercial Credit cards.) * `visa_advertising_service_commercial_credit` (Issuer Advertising Service Fee for Commercial Credit cards.) * `visa_community_growth_acceleration_program` (Issuer Community Growth Acceleration Program Fee.) * `visa_processing_guarantee_commercial_credit` (Issuer Processing Guarantee for Commercial Credit cards.) * `pulse_switch_fee` (Pulse Switch Fee is a fee charged by the Pulse network for processing transactions on its network.) - `elements.card_validation.scheme_fees.fixed_component` (string, nullable) The fixed component of the fee, if applicable, given in major units of the fee amount. - `elements.card_validation.scheme_fees.variable_rate` (string, nullable) The variable rate component of the fee, if applicable, given as a decimal (e.g., 0.015 for 1.5%). - `elements.card_validation.terminal_id` (string, nullable) The terminal identifier (commonly abbreviated as TID) of the terminal the card is transacting with. - `elements.card_validation.type` (string) A constant representing the object's type. For this resource it will always be `inbound_card_validation`. - `elements.card_validation.verification` (dictionary) Fields related to verification of cardholder-provided values. - `elements.card_validation.verification.card_verification_code` (dictionary) Fields related to verification of the Card Verification Code, a 3-digit code on the back of the card. - `elements.card_validation.verification.card_verification_code.result` (enum) The result of verifying the Card Verification Code. Cases: * `not_checked` (No card verification code was provided in the authorization request.) * `match` (The card verification code matched the one on file.) * `no_match` (The card verification code did not match the one on file.) - `elements.card_validation.verification.cardholder_address` (dictionary) Cardholder address provided in the authorization request and the address on file we verified it against. - `elements.card_validation.verification.cardholder_address.actual_line1` (string, nullable) Line 1 of the address on file for the cardholder. - `elements.card_validation.verification.cardholder_address.actual_postal_code` (string, nullable) The postal code of the address on file for the cardholder. - `elements.card_validation.verification.cardholder_address.provided_line1` (string, nullable) The cardholder address line 1 provided for verification in the authorization request. - `elements.card_validation.verification.cardholder_address.provided_postal_code` (string, nullable) The postal code provided for verification in the authorization request. - `elements.card_validation.verification.cardholder_address.result` (enum) The address verification result returned to the card network. Cases: * `not_checked` (No address information was provided in the authorization request.) * `postal_code_match_address_no_match` (Postal code matches, but the street address does not match or was not provided.) * `postal_code_no_match_address_match` (Postal code does not match, but the street address matches or was not provided.) * `match` (Postal code and street address match.) * `no_match` (Postal code and street address do not match.) * `postal_code_match_address_not_checked` (Postal code matches, but the street address was not verified. (deprecated)) - `elements.card_validation.verification.cardholder_name` (dictionary, nullable) Cardholder name provided in the authorization request. - `elements.card_validation.verification.cardholder_name.provided_first_name` (string, nullable) The first name provided for verification in the authorization request. - `elements.card_validation.verification.cardholder_name.provided_last_name` (string, nullable) The last name provided for verification in the authorization request. - `elements.card_validation.verification.cardholder_name.provided_middle_name` (string, nullable) The middle name provided for verification in the authorization request. - `elements.category` (enum) The type of the resource. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully. Cases: * `card_authorization` (Card Authorization: details will be under the `card_authorization` object.) * `card_authentication` (Card Authentication: details will be under the `card_authentication` object.) * `card_balance_inquiry` (Card Balance Inquiry: details will be under the `card_balance_inquiry` object.) * `card_validation` (Inbound Card Validation: details will be under the `card_validation` object.) * `card_decline` (Card Decline: details will be under the `card_decline` object.) * `card_reversal` (Card Reversal: details will be under the `card_reversal` object.) * `card_authorization_expiration` (Card Authorization Expiration: details will be under the `card_authorization_expiration` object.) * `card_increment` (Card Increment: details will be under the `card_increment` object.) * `card_settlement` (Card Settlement: details will be under the `card_settlement` object.) * `card_refund` (Card Refund: details will be under the `card_refund` object.) * `card_fuel_confirmation` (Card Fuel Confirmation: details will be under the `card_fuel_confirmation` object.) * `card_financial` (Card Financial: details will be under the `card_financial` object.) * `other` (Unknown card payment element.) - `elements.created_at` (string) The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the card payment element was created. - `elements.other` (dictionary, nullable) If the category of this Transaction source is equal to `other`, this field will contain an empty object, otherwise it will contain null. - `id` (string) The Card Payment identifier. - `physical_card_id` (string, nullable) The Physical Card identifier for this payment. - `state` (dictionary) The summarized state of this card payment. - `state.authorized_amount` (integer) The total authorized amount in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `state.fuel_confirmed_amount` (integer) The total amount from fuel confirmations in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `state.incremented_amount` (integer) The total incrementally updated authorized amount in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `state.refund_authorized_amount` (integer) The total refund authorized amount in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `state.refunded_amount` (integer) The total refunded amount in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `state.reversed_amount` (integer) The total reversed amount in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `state.settled_amount` (integer) The total settled amount in the minor unit of the transaction's currency. For dollars, for example, this is cents. - `type` (string) A constant representing the object's type. For this resource it will always be `card_payment`. ## List Card Payments GET /card_payments ### Example ```curl curl \ --url "${INCREASE_URL}/card_payments?account_id=account_in71c4amph0vgo2qllky" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" ``` ### Query Parameters - `cursor` (string, optional) Return the page of entries after this one. - `limit` (integer, optional) Limit the size of the list that is returned. The default (and maximum) is 100 objects. - `account_id` (string, optional) Filter Card Payments to ones belonging to the specified Account. - `card_id` (string, optional) Filter Card Payments to ones belonging to the specified Card. - `created_at.after` (string, optional) Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `created_at.before` (string, optional) Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `created_at.on_or_after` (string, optional) Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `created_at.on_or_before` (string, optional) Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. ### Returns a Card Payment List object: ```json { "data": [ { "account_id": "account_in71c4amph0vgo2qllky", "card_id": "card_oubs0hwk5rn6knuecxg2", "created_at": "2020-01-31T23:59:59Z", "digital_wallet_token_id": null, "elements": [ { "card_authorization": { "actioner": "increase", "additional_amounts": { "clinic": null, "dental": null, "original": null, "prescription": null, "surcharge": { "amount": 10, "currency": "USD" }, "total_cumulative": null, "total_healthcare": null, "transit": null, "unknown": null, "vision": null }, "amount": 100, "card_payment_id": "card_payment_nd3k2kacrqjli8482ave", "currency": "USD", "digital_wallet_token_id": null, "direction": "settlement", "expires_at": "2020-01-31T23:59:59Z", "id": "card_authorization_6iqxap6ivd0fo5eu3i8x", "merchant_acceptor_id": "5665270011000168", "merchant_category_code": "5734", "merchant_city": "New York", "merchant_country": "US", "merchant_descriptor": "AMAZON.COM", "merchant_postal_code": "10045", "merchant_state": "NY", "network_details": { "category": "visa", "pulse": null, "visa": { "electronic_commerce_indicator": "secure_electronic_commerce", "point_of_service_entry_mode": "manual", "stand_in_processing_reason": null, "terminal_entry_capability": "magnetic_stripe" } }, "network_identifiers": { "authorization_identification_response": null, "retrieval_reference_number": "785867080153", "trace_number": "487941", "transaction_id": "627199945183184" }, "network_risk_score": 10, "pending_transaction_id": null, "physical_card_id": null, "presentment_amount": 100, "presentment_currency": "USD", "processing_category": "purchase", "real_time_decision_id": null, "scheme_fees": [ { "amount": "0.137465", "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "fee_type": "visa_corporate_acceptance_fee", "fixed_component": null, "variable_rate": "0.0002" } ], "terminal_id": "RCN5VNXS", "type": "card_authorization", "verification": { "card_verification_code": { "result": "match" }, "cardholder_address": { "actual_line1": "33 Liberty Street", "actual_postal_code": "94131", "provided_line1": "33 Liberty Street", "provided_postal_code": "94132", "result": "postal_code_no_match_address_match" }, "cardholder_name": null } }, "category": "card_authorization", "created_at": "2020-01-31T23:59:59Z" }, { "card_reversal": { "card_authorization_id": "card_authorization_6iqxap6ivd0fo5eu3i8x", "currency": "USD", "id": "card_reversal_8vr9qy60cgf5d0slpb68", "merchant_acceptor_id": "5665270011000168", "merchant_category_code": "5734", "merchant_city": "New York", "merchant_country": "US", "merchant_descriptor": "AMAZON.COM", "merchant_postal_code": "10045", "merchant_state": "NY", "network": "visa", "network_identifiers": { "authorization_identification_response": null, "retrieval_reference_number": "785867080153", "trace_number": "487941", "transaction_id": "627199945183184" }, "pending_transaction_id": "pending_transaction_k1sfetcau2qbvjbzgju4", "presentment_currency": "USD", "reversal_amount": 20, "reversal_presentment_amount": 20, "reversal_reason": "reversed_by_customer", "scheme_fees": [ { "amount": "0.137465", "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "fee_type": "visa_corporate_acceptance_fee", "fixed_component": null, "variable_rate": "0.0002" } ], "terminal_id": "RCN5VNXS", "type": "card_reversal", "updated_authorization_amount": 80, "updated_authorization_presentment_amount": 80 }, "category": "card_reversal", "created_at": "2020-01-31T23:59:59Z" }, { "card_increment": { "actioner": "increase", "additional_amounts": { "clinic": null, "dental": null, "original": null, "prescription": null, "surcharge": null, "total_cumulative": null, "total_healthcare": null, "transit": null, "unknown": null, "vision": null }, "amount": 20, "card_authorization_id": "card_authorization_6iqxap6ivd0fo5eu3i8x", "currency": "USD", "id": "card_increment_6ztayc58j1od0rpebp3e", "network": "visa", "network_identifiers": { "authorization_identification_response": null, "retrieval_reference_number": "785867080153", "trace_number": "487941", "transaction_id": "627199945183184" }, "network_risk_score": 10, "pending_transaction_id": "pending_transaction_k1sfetcau2qbvjbzgju4", "presentment_amount": 20, "presentment_currency": "USD", "real_time_decision_id": null, "scheme_fees": [ { "amount": "0.137465", "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "fee_type": "visa_corporate_acceptance_fee", "fixed_component": null, "variable_rate": "0.0002" } ], "type": "card_increment", "updated_authorization_amount": 120 }, "category": "card_increment", "created_at": "2020-01-31T23:59:59Z" }, { "card_settlement": { "amount": 100, "card_authorization": null, "card_payment_id": "card_payment_nd3k2kacrqjli8482ave", "cashback": null, "currency": "USD", "id": "card_settlement_khv5kfeu0vndj291omg6", "interchange": { "amount": "0.137465", "code": "271", "currency": "USD" }, "merchant_acceptor_id": "5665270011000168", "merchant_category_code": "5734", "merchant_city": "New York", "merchant_country": "US", "merchant_name": "AMAZON.COM", "merchant_postal_code": "10045", "merchant_state": "NY", "network": "visa", "network_identifiers": { "acquirer_business_id": "69650702", "acquirer_reference_number": "83163715445437604865089", "authorization_identification_response": "ABC123", "transaction_id": "627199945183184" }, "pending_transaction_id": null, "presentment_amount": 100, "presentment_currency": "USD", "purchase_details": { "car_rental": null, "customer_reference_identifier": "51201", "local_tax_amount": null, "local_tax_currency": "usd", "lodging": { "check_in_date": "2023-07-20", "daily_room_rate_amount": 1000, "daily_room_rate_currency": "usd", "extra_charges": "restaurant", "folio_cash_advances_amount": 0, "folio_cash_advances_currency": "usd", "food_beverage_charges_amount": 0, "food_beverage_charges_currency": "usd", "no_show_indicator": "no_show", "prepaid_expenses_amount": 0, "prepaid_expenses_currency": "usd", "room_nights": 1, "total_room_tax_amount": 100, "total_room_tax_currency": "usd", "total_tax_amount": 100, "total_tax_currency": "usd" }, "national_tax_amount": null, "national_tax_currency": "usd", "purchase_identifier": "10203", "purchase_identifier_format": "order_number", "travel": null }, "scheme_fees": [ { "amount": "0.137465", "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "fee_type": "visa_corporate_acceptance_fee", "fixed_component": null, "variable_rate": "0.0002" } ], "surcharge": null, "transaction_id": "transaction_uyrp7fld2ium70oa7oi", "type": "card_settlement" }, "category": "card_settlement", "created_at": "2020-01-31T23:59:59Z" } ], "id": "card_payment_nd3k2kacrqjli8482ave", "physical_card_id": null, "state": { "authorized_amount": 100, "fuel_confirmed_amount": 0, "incremented_amount": 20, "refund_authorized_amount": 0, "refunded_amount": 0, "reversed_amount": 20, "settled_amount": 100 }, "type": "card_payment" } ], "next_cursor": "v57w5d" } ``` ## Retrieve a Card Payment GET /card_payments/{card_payment_id} ### Example ```curl curl \ --url "${INCREASE_URL}/card_payments/card_payment_nd3k2kacrqjli8482ave" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" ``` ### Path Parameters - `card_payment_id` (string, required) The identifier of the Card Payment. ## Sandbox: Create a Card Authentication attempt POST /simulations/card_authentications > Simulates a Card Authentication attempt on a [Card](#cards). The attempt always results in a [Card Payment](#card_payments) being created, either with a status that allows further action or a terminal failed status. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_authentications" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "card_id": "card_oubs0hwk5rn6knuecxg2", "merchant_acceptor_id": "5665270011000168", "merchant_category_code": "5734", "merchant_country": "US", "purchase_amount": 1000 }' ``` ### Body Parameters - `card_id` (string, required) The identifier of the Card to be authorized. - `category` (enum, optional) The category of the card authentication attempt. Cases: * `payment_authentication` (The authentication attempt is for a payment.) * `non_payment_authentication` (The authentication attempt is not for a payment.) - `device_channel` (enum, optional) The device channel of the card authentication attempt. Cases: * `app` (The authentication attempt was made from an app.) * `browser` (The authentication attempt was made from a browser.) * `three_ds_requestor_initiated` (The authentication attempt was initiated by the 3DS Requestor.) - `merchant_acceptor_id` (string, optional) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `merchant_category_code` (string, optional) The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with. - `merchant_country` (string, optional) The country the merchant resides in. - `merchant_name` (string, optional) The name of the merchant - `purchase_amount` (integer, optional) The purchase amount in cents. ## Sandbox: Create a Card Authentication Challenge attempt POST /simulations/card_authentications/{card_payment_id}/challenge_attempts > Simulates an attempt at a Card Authentication Challenge. This updates the `card_authentications` object under the [Card Payment](#card_payments). You can also attempt the challenge by navigating to https://dashboard.increase.com/card_authentication_simulation/:card_payment_id. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_authentications/card_payment_nd3k2kacrqjli8482ave/challenge_attempts" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "one_time_code": "123456" }' ``` ### Path Parameters - `card_payment_id` (string, required) The identifier of the Card Payment to be challenged. ### Body Parameters - `one_time_code` (string, required) The one-time code to be validated. ## Sandbox: Create an initial Card Authentication Challenge POST /simulations/card_authentications/{card_payment_id}/challenges > Simulates starting a Card Authentication Challenge for an existing Card Authentication. This updates the `card_authentications` object under the [Card Payment](#card_payments). To attempt the challenge, use the `/simulations/card_authentications/:card_payment_id/challenge_attempts` endpoint or navigate to https://dashboard.increase.com/card_authentication_simulation/:card_payment_id. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_authentications/card_payment_nd3k2kacrqjli8482ave/challenges" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" ``` ### Path Parameters - `card_payment_id` (string, required) The identifier of the Card Payment to be challenged. ## Sandbox: Expire a Card Authorization POST /simulations/card_authorization_expirations > Simulates expiring a Card Authorization immediately. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_authorization_expirations" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "card_payment_id": "card_payment_nd3k2kacrqjli8482ave" }' ``` ### Body Parameters - `card_payment_id` (string, required) The identifier of the Card Payment to expire. ## Sandbox: Create a Card Authorization POST /simulations/card_authorizations > Simulates a purchase authorization on a [Card](#cards). Depending on the balance available to the card and the `amount` submitted, the authorization activity will result in a [Pending Transaction](#pending-transactions) of type `card_authorization` or a [Declined Transaction](#declined-transactions) of type `card_decline`. You can pass either a Card id or a [Digital Wallet Token](#digital-wallet-tokens) id to simulate the two different ways purchases can be made. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_authorizations" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "amount": 1000, "card_id": "card_oubs0hwk5rn6knuecxg2", "event_subscription_id": "event_subscription_001dzz0r20rcdxgb013zqb8m04g", "merchant_acceptor_id": "5665270011000168", "merchant_category_code": "5734", "merchant_city": "New York", "merchant_country": "US", "merchant_descriptor": "AMAZON.COM", "merchant_state": "NY" }' ``` ### Body Parameters - `amount` (integer, required) The authorization amount in cents. - `authenticated_card_payment_id` (string, optional) The identifier of a Card Payment with a `card_authentication` if you want to simulate an authenticated authorization. - `card_id` (string, optional) The identifier of the Card to be authorized. - `decline_reason` (enum, optional) Forces a card decline with a specific reason. No real time decision will be sent. Cases: * `account_closed` (The account has been closed.) * `card_not_active` (The Card was not active.) * `card_canceled` (The Card has been canceled.) * `physical_card_not_active` (The Physical Card was not active.) * `entity_not_active` (The account's entity was not active.) * `group_locked` (The account was inactive.) * `insufficient_funds` (The Card's Account did not have a sufficient available balance.) * `cvv2_mismatch` (The given CVV2 did not match the card's value.) * `pin_mismatch` (The given PIN did not match the card's value.) * `card_expiration_mismatch` (The given expiration date did not match the card's value. Only applies when a CVV2 is present.) * `transaction_not_allowed` (The attempted card transaction is not allowed per Increase's terms.) * `breaches_limit` (The transaction was blocked by a Limit.) * `webhook_declined` (Your application declined the transaction via webhook.) * `webhook_timed_out` (Your application webhook did not respond without the required timeout.) * `declined_by_stand_in_processing` (Declined by stand-in processing.) * `invalid_physical_card` (The card read had an invalid CVV or dCVV.) * `missing_original_authorization` (The original card authorization for this incremental authorization does not exist.) * `invalid_cryptogram` (The card's authorization request cryptogram was invalid. The cryptogram can be from a physical card or a Digital Wallet Token purchase.) * `failed_3ds_authentication` (The transaction was declined because the 3DS authentication failed.) * `suspected_card_testing` (The transaction was suspected to be used by a card tester to test for valid card numbers.) * `suspected_fraud` (The transaction was suspected to be fraudulent. Please reach out to support@increase.com for more information.) - `digital_wallet_token_id` (string, optional) The identifier of the Digital Wallet Token to be authorized. - `event_subscription_id` (string, optional) The identifier of the Event Subscription to use. If provided, will override the default real time event subscription. Because you can only create one real time decision event subscription, you can use this field to route events to any specified event subscription for testing purposes. - `merchant_acceptor_id` (string, optional) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `merchant_category_code` (string, optional) The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with. - `merchant_city` (string, optional) The city the merchant resides in. - `merchant_country` (string, optional) The country the merchant resides in. - `merchant_descriptor` (string, optional) The merchant descriptor of the merchant the card is transacting with. - `merchant_state` (string, optional) The state the merchant resides in. - `network_details` (dictionary, optional) Fields specific to a given card network. - `network_details.visa` (dictionary, required) Fields specific to the Visa network. - `network_details.visa.stand_in_processing_reason` (enum, optional) The reason code for the stand-in processing. Cases: * `issuer_error` (Increase failed to process the authorization in a timely manner.) * `invalid_physical_card` (The physical card read had an invalid CVV or dCVV.) * `invalid_cryptogram` (The card's authorization request cryptogram was invalid. The cryptogram can be from a physical card or a Digital Wallet Token purchase.) * `invalid_cardholder_authentication_verification_value` (The 3DS cardholder authentication verification value was invalid.) * `internal_visa_error` (An internal Visa error occurred. Visa uses this reason code for certain expected occurrences as well, such as Application Transaction Counter (ATC) replays.) * `merchant_transaction_advisory_service_authentication_required` (The merchant has enabled Visa's Transaction Advisory Service and requires further authentication to perform the transaction. In practice this is often utilized at fuel pumps to tell the cardholder to see the cashier.) * `payment_fraud_disruption_acquirer_block` (The transaction was blocked by Visa's Payment Fraud Disruption service due to fraudulent Acquirer behavior, such as card testing.) * `other` (An unspecific reason for stand-in processing.) - `network_risk_score` (integer, optional) The risk score generated by the card network. For Visa this is the Visa Advanced Authorization risk score, from 0 to 99, where 99 is the riskiest. - `physical_card_id` (string, optional) The identifier of the Physical Card to be authorized. - `processing_category` (dictionary, optional) Fields specific to a specific type of authorization, such as Automatic Fuel Dispensers, Refund Authorizations, or Cash Disbursements. - `processing_category.category` (enum, required) The processing category describes the intent behind the authorization, such as whether it was used for bill payments or an automatic fuel dispenser. Cases: * `account_funding` (Account funding transactions are transactions used to e.g., fund an account or transfer funds between accounts.) * `automatic_fuel_dispenser` (Automatic fuel dispenser authorizations occur when a card is used at a gas pump, prior to the actual transaction amount being known. They are followed by an advice message that updates the amount of the pending transaction.) * `bill_payment` (A transaction used to pay a bill.) * `original_credit` (Original credit transactions are used to send money to a cardholder.) * `purchase` (A regular purchase.) * `quasi_cash` (Quasi-cash transactions represent purchases of items which may be convertible to cash.) * `refund` (A refund card authorization, sometimes referred to as a credit voucher authorization, where funds are credited to the cardholder.) * `cash_disbursement` (Cash disbursement transactions are used to withdraw cash from an ATM or a point of sale.) * `balance_inquiry` (A balance inquiry transaction is used to check the balance of an account associated with a card.) - `processing_category.refund` (dictionary, optional) Details related to refund authorizations. - `processing_category.refund.original_card_payment_id` (string, optional) The card payment to link this refund to. - `terminal_id` (string, optional) The terminal identifier (commonly abbreviated as TID) of the terminal the card is transacting with. ### Returns a Inbound Card Authorization Simulation Result object: ```json { "declined_transaction": null, "pending_transaction": { "account_id": "account_in71c4amph0vgo2qllky", "amount": 100, "completed_at": null, "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "description": "INVOICE 2468", "held_amount": 100, "id": "pending_transaction_k1sfetcau2qbvjbzgju4", "route_id": "card_oubs0hwk5rn6knuecxg2", "route_type": "card", "source": { "card_authorization": { "actioner": "increase", "additional_amounts": { "clinic": null, "dental": null, "original": null, "prescription": null, "surcharge": { "amount": 10, "currency": "USD" }, "total_cumulative": null, "total_healthcare": null, "transit": null, "unknown": null, "vision": null }, "amount": 100, "card_payment_id": "card_payment_nd3k2kacrqjli8482ave", "currency": "USD", "digital_wallet_token_id": null, "direction": "settlement", "expires_at": "2020-01-31T23:59:59Z", "id": "card_authorization_6iqxap6ivd0fo5eu3i8x", "merchant_acceptor_id": "5665270011000168", "merchant_category_code": "5734", "merchant_city": "New York", "merchant_country": "US", "merchant_descriptor": "AMAZON.COM", "merchant_postal_code": "10045", "merchant_state": "NY", "network_details": { "category": "visa", "pulse": null, "visa": { "electronic_commerce_indicator": "secure_electronic_commerce", "point_of_service_entry_mode": "manual", "stand_in_processing_reason": null, "terminal_entry_capability": "magnetic_stripe" } }, "network_identifiers": { "authorization_identification_response": null, "retrieval_reference_number": "785867080153", "trace_number": "487941", "transaction_id": "627199945183184" }, "network_risk_score": 10, "pending_transaction_id": null, "physical_card_id": null, "presentment_amount": 100, "presentment_currency": "USD", "processing_category": "purchase", "real_time_decision_id": null, "scheme_fees": [ { "amount": "0.137465", "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "fee_type": "visa_corporate_acceptance_fee", "fixed_component": null, "variable_rate": "0.0002" } ], "terminal_id": "RCN5VNXS", "type": "card_authorization", "verification": { "card_verification_code": { "result": "match" }, "cardholder_address": { "actual_line1": "33 Liberty Street", "actual_postal_code": "94131", "provided_line1": "33 Liberty Street", "provided_postal_code": "94132", "result": "postal_code_no_match_address_match" }, "cardholder_name": null } }, "category": "card_authorization" }, "status": "pending", "type": "pending_transaction" }, "type": "inbound_card_authorization_simulation_result" } ``` ## Sandbox: Create a Card Balance Inquiry POST /simulations/card_balance_inquiries > Simulates a balance inquiry on a [Card](#cards). ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_balance_inquiries" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "balance": 1000000, "card_id": "card_oubs0hwk5rn6knuecxg2", "event_subscription_id": "event_subscription_001dzz0r20rcdxgb013zqb8m04g", "merchant_acceptor_id": "5665270011000168", "merchant_category_code": "5734", "merchant_city": "New York", "merchant_country": "US", "merchant_descriptor": "CITIBANK", "merchant_state": "NY" }' ``` ### Body Parameters - `balance` (integer, optional) The balance amount in cents. The account balance will be used if not provided. - `card_id` (string, optional) The identifier of the Card to be authorized. - `decline_reason` (enum, optional) Forces a card decline with a specific reason. No real time decision will be sent. Cases: * `account_closed` (The account has been closed.) * `card_not_active` (The Card was not active.) * `card_canceled` (The Card has been canceled.) * `physical_card_not_active` (The Physical Card was not active.) * `entity_not_active` (The account's entity was not active.) * `group_locked` (The account was inactive.) * `insufficient_funds` (The Card's Account did not have a sufficient available balance.) * `cvv2_mismatch` (The given CVV2 did not match the card's value.) * `pin_mismatch` (The given PIN did not match the card's value.) * `card_expiration_mismatch` (The given expiration date did not match the card's value. Only applies when a CVV2 is present.) * `transaction_not_allowed` (The attempted card transaction is not allowed per Increase's terms.) * `breaches_limit` (The transaction was blocked by a Limit.) * `webhook_declined` (Your application declined the transaction via webhook.) * `webhook_timed_out` (Your application webhook did not respond without the required timeout.) * `declined_by_stand_in_processing` (Declined by stand-in processing.) * `invalid_physical_card` (The card read had an invalid CVV or dCVV.) * `missing_original_authorization` (The original card authorization for this incremental authorization does not exist.) * `invalid_cryptogram` (The card's authorization request cryptogram was invalid. The cryptogram can be from a physical card or a Digital Wallet Token purchase.) * `failed_3ds_authentication` (The transaction was declined because the 3DS authentication failed.) * `suspected_card_testing` (The transaction was suspected to be used by a card tester to test for valid card numbers.) * `suspected_fraud` (The transaction was suspected to be fraudulent. Please reach out to support@increase.com for more information.) - `digital_wallet_token_id` (string, optional) The identifier of the Digital Wallet Token to be authorized. - `event_subscription_id` (string, optional) The identifier of the Event Subscription to use. If provided, will override the default real time event subscription. Because you can only create one real time decision event subscription, you can use this field to route events to any specified event subscription for testing purposes. - `merchant_acceptor_id` (string, optional) The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with. - `merchant_category_code` (string, optional) The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with. - `merchant_city` (string, optional) The city the merchant resides in. - `merchant_country` (string, optional) The country the merchant resides in. - `merchant_descriptor` (string, optional) The merchant descriptor of the merchant the card is transacting with. - `merchant_state` (string, optional) The state the merchant resides in. - `network_details` (dictionary, optional) Fields specific to a given card network. - `network_details.visa` (dictionary, required) Fields specific to the Visa network. - `network_details.visa.stand_in_processing_reason` (enum, optional) The reason code for the stand-in processing. Cases: * `issuer_error` (Increase failed to process the authorization in a timely manner.) * `invalid_physical_card` (The physical card read had an invalid CVV or dCVV.) * `invalid_cryptogram` (The card's authorization request cryptogram was invalid. The cryptogram can be from a physical card or a Digital Wallet Token purchase.) * `invalid_cardholder_authentication_verification_value` (The 3DS cardholder authentication verification value was invalid.) * `internal_visa_error` (An internal Visa error occurred. Visa uses this reason code for certain expected occurrences as well, such as Application Transaction Counter (ATC) replays.) * `merchant_transaction_advisory_service_authentication_required` (The merchant has enabled Visa's Transaction Advisory Service and requires further authentication to perform the transaction. In practice this is often utilized at fuel pumps to tell the cardholder to see the cashier.) * `payment_fraud_disruption_acquirer_block` (The transaction was blocked by Visa's Payment Fraud Disruption service due to fraudulent Acquirer behavior, such as card testing.) * `other` (An unspecific reason for stand-in processing.) - `network_risk_score` (integer, optional) The risk score generated by the card network. For Visa this is the Visa Advanced Authorization risk score, from 0 to 99, where 99 is the riskiest. - `physical_card_id` (string, optional) The identifier of the Physical Card to be authorized. - `terminal_id` (string, optional) The terminal identifier (commonly abbreviated as TID) of the terminal the card is transacting with. ## Sandbox: Confirm the fuel pump amount for a Card Authorization POST /simulations/card_fuel_confirmations > Simulates the fuel confirmation of an authorization by a card acquirer. This happens asynchronously right after a fuel pump transaction is completed. A fuel confirmation can only happen once per authorization. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_fuel_confirmations" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "amount": 5000, "card_payment_id": "card_payment_nd3k2kacrqjli8482ave" }' ``` ### Body Parameters - `amount` (integer, required) The amount of the fuel_confirmation in minor units in the card authorization's currency. - `card_payment_id` (string, required) The identifier of the Card Payment to create a fuel_confirmation on. ## Sandbox: Increment a Card Authorization POST /simulations/card_increments > Simulates the increment of an authorization by a card acquirer. An authorization can be incremented multiple times. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_increments" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "amount": 500, "card_payment_id": "card_payment_nd3k2kacrqjli8482ave" }' ``` ### Body Parameters - `amount` (integer, required) The amount of the increment in minor units in the card authorization's currency. - `card_payment_id` (string, required) The identifier of the Card Payment to create an increment on. - `event_subscription_id` (string, optional) The identifier of the Event Subscription to use. If provided, will override the default real time event subscription. Because you can only create one real time decision event subscription, you can use this field to route events to any specified event subscription for testing purposes. ## Sandbox: Refund a card transaction POST /simulations/card_refunds > Simulates refunding a card transaction. The full value of the original sandbox transaction is refunded. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_refunds" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "transaction_id": "transaction_uyrp7fld2ium70oa7oi" }' ``` ### Body Parameters - `amount` (integer, optional) The refund amount in cents. Pulled off the `pending_transaction` or the `transaction` if not provided. - `pending_transaction_id` (string, optional) The identifier of the Pending Transaction for the refund authorization. If this is provided, `transaction` must not be provided as a refund with a refund authorized can not be linked to a regular transaction. - `transaction_id` (string, optional) The identifier for the Transaction to refund. The Transaction's source must have a category of card_settlement. ### Returns a Transaction object: ```json { "account_id": "account_in71c4amph0vgo2qllky", "amount": 100, "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "description": "INVOICE 2468", "id": "transaction_uyrp7fld2ium70oa7oi", "route_id": "account_number_v18nkfqm6afpsrvy82b2", "route_type": "account_number", "source": { "category": "inbound_ach_transfer", "inbound_ach_transfer": { "addenda": null, "amount": 100, "originator_company_descriptive_date": null, "originator_company_discretionary_data": null, "originator_company_entry_description": "RESERVE", "originator_company_id": "0987654321", "originator_company_name": "BIG BANK", "receiver_id_number": "12345678900", "receiver_name": "IAN CREASE", "trace_number": "021000038461022", "transfer_id": "inbound_ach_transfer_tdrwqr3fq9gnnq49odev" } }, "type": "transaction" } ``` ## Sandbox: Reverse a Card Authorization POST /simulations/card_reversals > Simulates the reversal of an authorization by a card acquirer. An authorization can be partially reversed multiple times, up until the total authorized amount. Marks the pending transaction as complete if the authorization is fully reversed. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_reversals" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "card_payment_id": "card_payment_nd3k2kacrqjli8482ave" }' ``` ### Body Parameters - `amount` (integer, optional) The amount of the reversal in minor units in the card authorization's currency. This defaults to the authorization amount. - `card_payment_id` (string, required) The identifier of the Card Payment to create a reversal on. ## Sandbox: Settle a Card Authorization POST /simulations/card_settlements > Simulates the settlement of an authorization by a card acquirer. After a card authorization is created, the merchant will eventually send a settlement. This simulates that event, which may occur many days after the purchase in production. The amount settled can be different from the amount originally authorized, for example, when adding a tip to a restaurant bill. ### Example ```curl curl -X "POST" \ --url "${INCREASE_URL}/simulations/card_settlements" \ -H "Authorization: Bearer ${INCREASE_API_KEY}" \ -H "Content-Type: application/json" \ -d $'{ "card_id": "card_oubs0hwk5rn6knuecxg2", "pending_transaction_id": "pending_transaction_k1sfetcau2qbvjbzgju4" }' ``` ### Body Parameters - `amount` (integer, optional) The amount to be settled. This defaults to the amount of the Pending Transaction being settled. - `card_id` (string, required) The identifier of the Card to create a settlement on. - `pending_transaction_id` (string, required) The identifier of the Pending Transaction for the Card Authorization you wish to settle. ### Returns a Transaction object: ```json { "account_id": "account_in71c4amph0vgo2qllky", "amount": 100, "created_at": "2020-01-31T23:59:59Z", "currency": "USD", "description": "INVOICE 2468", "id": "transaction_uyrp7fld2ium70oa7oi", "route_id": "account_number_v18nkfqm6afpsrvy82b2", "route_type": "account_number", "source": { "category": "inbound_ach_transfer", "inbound_ach_transfer": { "addenda": null, "amount": 100, "originator_company_descriptive_date": null, "originator_company_discretionary_data": null, "originator_company_entry_description": "RESERVE", "originator_company_id": "0987654321", "originator_company_name": "BIG BANK", "receiver_id_number": "12345678900", "receiver_name": "IAN CREASE", "trace_number": "021000038461022", "transfer_id": "inbound_ach_transfer_tdrwqr3fq9gnnq49odev" } }, "type": "transaction" } ```