In Auth Payload

Header

Property	Type	Description
`correlationId`	Guid	Correlation Identifier for track (aka `ContextId`)
`event`	EventPayload	Transaction information
`ts`	DateTimeOffset	Time at which the object was created
`idToken`	String	Customer Token

EventPayload

Payload	Type	Description	Payload Data Mapping
`acquirerInstitutionCountryCode`	string	Country where the acquiring institution is located	https://docs.helix.q2.com/docs/countrycurrencycodes
`additionalAmountsGratuity`	decimal	Amount of gratuity provided when the transaction occurred
`additionalAmountsPurchase`	decimal	Partial pay amount
`additionalFeesCCA`	decimal	Mastercard Currency Conversation Assessment (CCA) fees
`additionalFeesICA`	decimal	Issuer Cross-border Assessment (ICA) fees
`amount`	decimal	Amount of funds represented by the transaction
`cardAcceptorCountryCode`	string	Country code of the card acceptor
`cardId`	int32	Unique Helix-assignedID for the card to which this event applies
`cashbackAmount`	decimal	Amount of cashback provided when the transaction occurred.
`cashDepositAmount`	decimal	Amount of cash deposited when the transaction occurred
`customerId`	int32	Unique Helix-assigned ID for the customer
`cvv2PresenceIndicator`	string	CVV2 Presence Indicator	`0` -CVV2 Value is deliberately bypassed or is not provided by the merchant `1` - CVV2 Value is present `2` - CVV2 Value is on the card, but is illegible `9` - Cardholder states that the card has no CVV2 imprint
`cvv2Result`	string	CVV2 Result	`M` - CVV2 Match `N` - CVV2 No Match `P` - Not Processed `S` - CVV2 should be on the card, but the merchant has indicated that CVV2 is not present `U` - Issuer is not certified and/or has not provided Visa with the encryption keys
`fromAccountAmount`	decimal	Total balance of the debited customer account after the debit was applied, including funds with holds placed on them Represents all settled transactions to date
`fromAccountId`	int32	Unique identifier for the debited customer account
`fromAccountNumberMasked`	string	Masked version of the account number of the debited customer account
`fromAvailableAmount`	decimal	Balance available for immediate withdrawal from the debited customer account after the debit was applied
`fromCategory`	string	Caller-specified category to which the debited customer account belongs
`fromCreatedDate`	dateimeoffset	Date customer account was created
`fromCustomField1`	string	CustomField1 property of the account object that was debited
`fromCustomField2`	string	CustomField2 property of the account object that was debited
`fromCustomField3`	string	CustomField3 property of the account object that was debited
`fromCustomField4`	string	CustomField4 property of the account object that was debited
`fromCustomField5`	string	CustomField5 property of the account object that was debited
`fromLegalName1`	string	First legal name used to identify the customer account that was debited
`fromLegalName2`	string	Secondary legal name used to identify the customer account that was debited
`fromName`	string	Caller-specified, user-friendly name for the customer account that was debited
`fromPrimaryCustomerId`	int32	Denotes the customer considered the primary owner for the account that was debited
`fromSubCategory`	string	Caller-specified subcategory to which the customer account that was debited belongs
`fromTag`	string	Unique, caller-specified identifier for the customer account that was debited
`fromTargetAmount`	decimal	Amount the customer wants the from Available Amount to reach on the account that was debited
`fromTargetDate`	datetimeoffset	Date the customer wants the from Target Amount to be reached on the account that was debited
`fromTargetMetDate`	string	First date the available Amount reached or exceeded the from Target Amount on the account that was debited
`toAccountId`	int32	Unique identifier for the customer account that was credited
`toAccountNumberMasked`	string	Masked version of the customer account number that was credited
`toAvailableAmount`	decimal	Balance available for immediate withdrawal to the customer account that was credited after the credit was applied
`toCategory`	string	Caller-specified category to which the customer account that was credited belongs
`toCreatedDate`	datetimeoffset	Date the customer account was created
`toCustomField1`	string	CustomField1 property of the account object that was credited
`toCustomField2`	string	CustomField2 property of the account object that was credited
`toCustomField3`	string	CustomField3 property of the account object that was credited
`toCustomField4`	string	CustomField4 property of the account object that was credited
`toCustomField5`	string	CustomField5 property of the account object that was credited
`toLegalName1`	string	First legal name used to identify the customer account that was credited
`toLegalName2`	string	Secondary legal name used to identify the customer account that was credited
`toName`	string	Caller-specified, user-friendly name for the customer account that was credited
`toPrimaryCustomerId`	int32	Denotes the customer considered the primary owner for the account that was credited
`toSubCategory`	string	Caller-specified subcategory to which the customer account that was credited belongs
`toTag`	string	Unique, caller-specified, identifier for the customer account that was credited
`toTargetAmount`	decimal	Amount the customer wants the To Available Amount to reach on the account that was credited
`toTargetDate`	datetimeoffset	Date the customer wants the To Target Amount to be reached on the account that was credited
`toTargetMetDate`	string	The first date the available Amount reached or exceeded the To Target Amount on the account that was credited.
`messageTypeIndicator`	string	Incoming message type	`0100` - Authorization Request `0101` - Repeat Authorization Request `0200` - Financial Transaction Request `0201` - Repeat Financial Request
`merchantCategoryCode`	string	Two-character country abbreviation of the merchant at which the transaction originated	https://docs.helix.q2.com/docs/merchant-category-codes
`merchantCity`	string	City of the merchant at which the transaction originated
`merchantCountryCode`	string	Two-character country abbreviation of the merchant at which the transaction originated
`merchantId`	string	Identification code of the merchant that accepted the card information
`merchantLocation`	string	Location of the merchant at which the transaction originated
`merchantStateCode`	string	Two-character state abbreviation of the merchant at which the transaction originated	https://docs.helix.q2.com/docs/statecountry-codes
`merchantZipCode`	string	Postal code of the merchant at which the transaction originated
`nationalPointOfServiceConditionCardPresence`	string	Card Presence	`0` - Card present `1` - Card not present `8` - Pre-authorized purchase
`nationalPointOfServiceConditionCardPresentation`	string	Presentation Type	`0` - Customer present `1` - Customer not present `2` - Mail/Telephone Order (unknown classification) `4` - Recurring transaction `5` - Installment Payment `6` - Account top up `8` - Pre-authorized purchase `9` - Single transaction for Mail/Telephone Order
`nationalPointOfServiceConditionCardRetention`	string	Card Retention	`0` - Device does not have card retention capability `1` - Device has card retention capability
`nationalPointOfServiceConditionCardTransaction`	string	Card Transaction	`1` - Incremental authorization `2` - Delayed charges `3` - No show `4` - Merchant authorized transaction `5` - Resubmission `6` - Reauthorization
`nationalPointOfServiceConditionSecurityCondition`	string	Security Condition	`1` - Incremental authorization `2` - Delayed charges `3` - No show `4` - Merchant authorized transaction `5` - Resubmission `6` - Reauthorization
`nationalPointOfServiceConditionTerminalEntryCapability`	string	Terminal Entry Capability Mode	`0` - Unknown `1` - Manual/no terminal `2` - Magnetic stripe read `3` - QR code `4` - OCR `5` - ICC `6` - Key entered `9` - File `S` - MICR reader `T` - Contactless `U` - Contactless via Mag Stripe Rules
`nationalPointOfServiceConditionTerminalOperator`	string	Terminal Operator	`0` - Customer operated `1` - Card acceptor-operated `2` - Administrative
`nationalPointOfServiceConditionTerminalPremises`	string	Terminal Premise	`0` - On premise `1` - Off premise `3` - Electronic commerce
`nationalPointOfServiceConditionTerminalType`	string	Terminal Type	`00` - Administrative terminal `01` - POS terminal `02` - ATM `03` - Home terminal `04` - ECR `05` - Dial terminal `06` - Travelers check machine `07` - Fuel machine `08` - Scrip machine `09` - Coupon machine `10` - Ticket machine `11` - Point-of-banking terminal `12` - Teller `13` - Franchise teller
`nationalPointOfServiceConditionTerminalUnattended`	String	Terminal Unattended	`0` - Attended `1` - Unattended
`networkProviderTypeId`	string	Card's network provider ID
`paymentAccountReferenceNumber`	string	Payment Account Reference Number
`pointOfServicePanEntryMode`	string	Point of Service PAN Entry Mode	`Unspecified` `01` - Manual `02` - MagneticStripe `03` - OpticalCode `04` - OCR `05` - IntegratedCircuitCard `06` - Manual_KeyEntered `07` - ContactlessChipTransactionUsingChipDataRules `90` - FullMagneticStripeRead `81` - Stored `82` - DigitallyStoredMobileBrowser `84` - MICRread `91` - ContactlessChipTransactionUsingMagneticStripeDataRules `95` - IntegratedCircuitCard_CVVMayBeUnreliable
`pointOfServicePinEntryMode`	string	Point of Service PIN Entry Mode	`0` - Unspecified `1` - PINEntryCapability `2` - NoPINEntryCapability `6` - PINPadInoperative
`pinValidationCode`	string	Indicates whether the entered PIN was Valid
`privatelyDefinedDataAdditionalTransactionElementFallbackIndicator`	string	Fallback Indicator	`blank` or `0` - Not Fallback `1` - Fallback
`privatelyDefinedDataAcquirerNetworkIdCode`	string	Network from which DPS acquired the transaction
`privatelyDefinedDataRiskDataFalconReason1`	string	Falcon Reason 1	`00` - No Code `01` - Unusual Time `02` - Unusual MCC `03` - High Risk MCC `04` - Suspicious High Dollar `05` - Suspicious Dollar Amounts `06` - Suspicious Geographic `07` - Suspicious Apprv Decln `08` - Suspicious Auth Velocity `09` - Suspicious Post Velocity `10` - Suspicious Transaction Type `11` - Suspicious Account Info `12` - Suspicious Keyed Activity `13` - Hi Risk Keyed Activity `14` - Suspicious ATM Cash `15` - Suspicious non-ATM Cash `16` - Suspicious Cash `17` - Suspicious Phone `18` - Suspicious Unattended Gas `19` - Suspicious CAT Activity `20` - High Risk MCC Amount `21` - Suspicious Foreign Activity `22` - CVV Expiration Date Mismatch `51` - Suspicious Payment Activity `52` - Suspicious Payment Amount `53` - Suspicious Payment Amount Nums
`privatelyDefinedDataRiskDataFalconReason2`	string	Falcon Reason 2	`00` - No Code `01` - Unusual Time `02` - Unusual MCC `03` - High Risk MCC `04` - Suspicious High Dollar `05` - Suspicious Dollar Amounts `06` - Suspicious Geographic `07` - Suspicious Apprv Decln `08` - Suspicious Auth Velocity `09` - Suspicious Post Velocity `10` - Suspicious Transaction Type `11` - Suspicious Account Info `12` - Suspicious Keyed Activity `13` - Hi Risk Keyed Activity `14` - Suspicious ATM Cash `15` - Suspicious non-ATM Cash `16` - Suspicious Cash `17` - Suspicious Phone `18` - Suspicious Unattended Gas `19` - Suspicious CAT Activity `20` - High Risk MCC Amount `21` - Suspicious Foreign Activity `22` - CVV Expiration Date Mismatch `51` - Suspicious Payment Activity `52` - Suspicious Payment Amount `53` - Suspicious Payment Amount Nums
`privatelyDefinedDataRiskDataFalconReason3`	string	Falcon Reason 3	`00` - No Code `01` - Unusual Time `02` - Unusual MCC `03` - High Risk MCC `04` - Suspicious High Dollar `05` - Suspicious Dollar Amounts `06` - Suspicious Geographic `07` - Suspicious Apprv Decln `08` - Suspicious Auth Velocity `09` - Suspicious Post Velocity `10` - Suspicious Transaction Type `11` - Suspicious Account Info `12` - Suspicious Keyed Activity `13` - Hi Risk Keyed Activity `14` - Suspicious ATM Cash `15` - Suspicious non-ATM Cash `16` - Suspicious Cash `17` - Suspicious Phone `18` - Suspicious Unattended Gas `19` - Suspicious CAT Activity `20` - High Risk MCC Amount `21` - Suspicious Foreign Activity `22` - CVV Expiration Date Mismatch `51` - Suspicious Payment Activity `52` - Suspicious Payment Amount `53` - Suspicious Payment Amount Nums
`privatelyDefinedDataProcessingFlagIsAIndicator`	string	Visa International Service Assessment (ISA) Indicator, used to indicate whether a transaction is single- or multi-currency.	`C` - Single Currency ISA (0.8%) `S` - Multi-Currency ISA (1.0%) `R` - ISA assessed and rebated `blank` - Transaction does not qualify for fee assessment
`privatelyDefinedDataProcessingFlagPartialAuthIndicator`	string	Transaction eligibility for Partial Authorization Indicator	`Y` - Acquirer supports a partial authorization for transaction. `blank` - Acquirer does not support a partial authorization for transaction
`privatelyDefinedDataProcessingFlagSpecialTransactionIndicator`	string	Special transaction indicator	`A` - Payment Account Status Inquiry (ASI) Transaction `B` - Token account verification `C` - Cloud based payment/HCE `D` - Device Binding `T` - Tokenized Message `V` - Verified by Visa enrollment authorization request `blank` - no special transaction considerations
`privatelyDefinedDataRiskDataResponseCode`	string	Response code generated by Falcon Expert	`0` - No response code generated `1` - Approve `2` - Decline `3` - Refer `4` - Approve with identification `5` - Pick up card
`privatelyDefinedDataRiskDataScoreSource`	string	Defines the Falcon processing option used.	`0` - No Falcon processing `1` - Online `2` - Online Plus `3` - Real-Time
`privatelyDefinedDataRiskDataScoreValue`	string	Numeric score generated by Falcon. This field is populated for Falcon Real-Time transactions only.	Ranging from `0000` to `0999` Higher score indicates a greater likelihood of fraud. If the card is currently in fraud monitoring suppression, the Score Value is `9998` or `9999`
`privatelyDefinedDataRiskDataVAAConditionCode1Rank`	string	Grouping value assigned to VAA Risk Condition Code 1	`2` - High Risk for Fraud `1` - Medium Risk for Fraud `0` - Low Risk for Fraud
`privatelyDefinedDataRiskDataVisaRiskConditionCode1`	string	Contains a value relative to a high-risk Compromised Account Management System (CAMS) event	Score of `01` – `09` where a score of `09` indicates the highest risk and `01` indicates the lowest risk.
`privatelyDefinedDataRiskDataVisaRiskConditionCode2`	string	Contains the Compromised Event Reference (CER) ID assigned to a significant CAMS event
`privatelyDefinedDataRiskDataVisaRiskConditionCode3`	string	Reserved for future release
`privatelyDefinedDataRiskDataVisaRiskReason`	string	Code that represents logic behind the VisaRiskScore
`privatelyDefinedDataRiskDataVisaRiskScore`	string	Value that indicates the degree of risk associated with the transaction. Higher values indicate higher authorization risk	Valid values - `01`-`99` `blank` if card is in fraud monitoring or data is not present
`privatelyDefinedDataRiskDataRTDResultCode`	string	Real Time Decisioning result code	`D` - Transaction declined by RTD `R` - Transaction referred by RTD `blank` - No RTD result code provided.
`privatelyDefinedDataRiskDataTravelStatusIndicator`	string	Indicates the cardholder's travel status	VIP Indicator - Not currently used `A` - Cardholder may be traveling, destination matches `B` - Cardholder may be traveling, destination unknown
`privatelyDefinedDataTransactionLevelCredentialOnFileIndicator`	string	Credential On File IndicatorIndicates whether a Credential on File is present	`Y` - Credential on File `N` - Not a Credential on File
`privatelyDefinedDataTransactionLevelCryptocurrencyPurchaseIndicator`	string	Cryptocurrency Purchase IndicatorIdentifies Visa transactions used to purchase cryptocurrency	`Y` - Purchase of Cryptocurrency `N` - Not a Purchase of Cryptocurrency
`requestTypeCode`	string	Method of request from the debit rails	`REQ`-Request
`retrievalReferenceNumber`	string	Retrieval Reference Number Defined by the network provider, useful when interfacing with the network provider's support tools or staff
`settlementAmount`	decimal	Amount to be transferred between the acquirer and the issuer.
`settlementConversionRate`	decimal	The factor used in the conversion from the transaction amount to settlement amount set by the acquirer.
`settlementFeeAmount`	decimal	Settlement Fee Amount Contains the surcharge amount (in the issuer's currency)	Format: x + n8 x - fee sign `D` or `0` - Debit `C` - Credit
`systemTraceAuditNumber`	string	System Trace Audit Number Defined by the network provider, useful when interfacing with the network provider's support tools or staff
`subType`	string	The description of the SubTypeCode for this transaction.
`subTypeCode`	string	The Merchant Category Code of the merchant where the transaction originated. Categorizes merchants with similar lines of business together.	https://docs.helix.q2.com/docs/merchant-category-codes
`surchargeAmount`	decimal	Surcharge amount applied when the transaction occurred
`token`	string	Payment Account Reference number (PAR) with a maximum length of 29
`terminalId`	string	Identification code of the device at the merchant that accepted the card information
`tokenAssuranceLevel`	string	Cardholder Verification Method (CVM)
`tokenExpirationDate`	string	Year and month when the token expires (YYMM)
`track2DataServiceCode`	string	Service code encoded on track 2 of the card's magnetic stripe
`transactionAmount`	decimal	Funds requested by the cardholder in the local currency of the acquirer or source location of the transaction, not including transaction fee amounts.
`transactionCurrencyCode`	string	The currency used in transaction amount and transaction fee amount and contains a code defining the local currency of the acquirer or source location of the transaction.
`transactionFeeAmount`	decimal	Total Transaction Fee Amount(Contains the surcharge amount)	Format: x + n8 x - fee sign `D` or `0` - Debit `C` - Credit
`type`	string	A human-readable representation of the type of transaction that caused this event.
`typeCode`	string	Type of transaction for request	https://docs.helix.q2.com/docs/transaction-types
`version`	int32	Version of the payload in the data node
`visaTransactionId`	string	Visa supplied Transaction identifier

Example Payload

{
  'correlationId': '83ffcb19-12cb-4476-8d4b-f47cfe1a3ba9',
  'event': {
    'acquirerInstitutionCountryCode': None,
    'additionalAmountsGratuity': None,
    'additionalAmountsPurchase': None,
    'additionalFeesCCA': 0,
    'additionalFeesICA': 0,
    'amount': 20.15,
    'cardAcceptorCountryCode': 'US',
    'cardId': 10904422,
    'cashbackAmount': None,
    'cashDepositAmount': 0,
    'customerId': 44879935,
    'cvv2PresenceIndicator': None,
    'cvv2Result': 'N',
    'fromAccountAmount': 2000.0,
    'fromAccountId': 44879939,
    'fromAccountNumberMasked': '*************4633',
    'fromAvailableAmount': 2000.0,
    'fromCategory': '',
    'fromCreatedDate': '2024-11-05T10:26:25.727616-06:00',
    'fromCustomField1': '',
    'fromCustomField2': '',
    'fromCustomField3': '',
    'fromCustomField4': '',
    'fromCustomField5': '',
    'fromLegalName1': '',
    'fromLegalName2': '',
    'fromName': 'My Checking',
    'fromPrimaryCustomerId': 44879935,
    'fromSubCategory': '',
    'fromTag': '',
    'fromTargetAmount': 0,
    'fromTargetDate': '9999-12-31T23:59:59.9999999+00:00',
    'fromTargetMetDate': '9999-12-31T23:59:59.9999999+00:00',
    'toAccountId': None,
    'toAccountNumberMasked': None,
    'toAvailableAmount': None,
    'toCategory': None,
    'toCreatedDate': None,
    'toCustomField1': None,
    'toCustomField2': None,
    'toCustomField3': None,
    'toCustomField4': None,
    'toCustomField5': None,
    'toLegalName1': None,
    'toLegalName2': None,
    'toName': None,
    'toPrimaryCustomerId': None,
    'toSubCategory': None,
    'toTag': None,
    'toTargetAmount': None,
    'toTargetDate': None,
    'toTargetMetDate': None,
    'messageTypeIndicator': '0100',
    'merchantCategoryCode': '6010',
    'merchantCity': 'DENVER',
    'merchantCountryCode': 'US',
    'merchantId': None,
    'merchantLocation': 'TEST API TRANSACTION',
    'merchantStateCode': 'CO',
    'merchantZipCode': None,
    'nationalPointOfServiceConditionCardPresence': '0',
    'nationalPointOfServiceConditionCardPresentation': '0',
    'nationalPointOfServiceConditionCardRetention': '0',
    'nationalPointOfServiceConditionCardTransaction': '0',
    'nationalPointOfServiceConditionSecurityCondition': '0',
    'nationalPointOfServiceConditionTerminalEntryCapability': '2',
    'nationalPointOfServiceConditionTerminalOperator': '0',
    'nationalPointOfServiceConditionTerminalPremises': '0',
    'nationalPointOfServiceConditionTerminalType': '01',
    'nationalPointOfServiceConditionTerminalUnattended': '0',
    'networkProviderTypeId': 'VisaDps',
    'paymentAccountReferenceNumber': '10010014621056636090615846428',
    'pointOfServicePanEntryMode': 'FullMagneticStripeRead',
    'pointOfServicePinEntryMode': 'Unspecified',
    'pinValidationCode': None,
    'privatelyDefinedDataAdditionalTransactionElementFallbackIndicator': None,
    'privatelyDefinedDataAcquirerNetworkIdCode': 'VSN',
    'privatelyDefinedDataRiskDataFalconReason1': '  ',
    'privatelyDefinedDataRiskDataFalconReason2': '  ',
    'privatelyDefinedDataRiskDataFalconReason3': '  ',
    'privatelyDefinedDataProcessingFlagIsAIndicator': None,
    'privatelyDefinedDataProcessingFlagPartialAuthIndicator': None,
    'privatelyDefinedDataProcessingFlagSpecialTransactionIndicator': None,
    'privatelyDefinedDataRiskDataResponseCode': ' ',
    'privatelyDefinedDataRiskDataScoreSource': ' ',
    'privatelyDefinedDataRiskDataScoreValue': '    ',
    'privatelyDefinedDataRiskDataVAAConditionCode1Rank': '2',
    'privatelyDefinedDataRiskDataVisaRiskConditionCode1': '15',
    'privatelyDefinedDataRiskDataVisaRiskConditionCode2': 'C2',
    'privatelyDefinedDataRiskDataVisaRiskConditionCode3': 'BT',
    'privatelyDefinedDataRiskDataVisaRiskReason': '5A',
    'privatelyDefinedDataRiskDataVisaRiskScore': '87',
    'privatelyDefinedDataRiskDataRTDResultCode': '',
    'privatelyDefinedDataRiskDataTravelStatusIndicator': '',
    'privatelyDefinedDataTransactionLevelCredentialOnFileIndicator': '',
    'privatelyDefinedDataTransactionLevelCryptocurrencyPurchaseIndicator': '',
    'requestTypeCode': 'REQ',
    'retrievalReferenceNumber': '212830000092',
    'settlementFeeAmount': None,
    'systemTraceAuditNumber': '000009',
    'surchargeAmount': None,
    'token': None,
    'terminalId': '12345678',
    'tokenAssuranceLevel': None,
    'tokenExpirationDate': None,
    'track2DataServiceCode': None,
    'transactionFeeAmount': None,
    'version': 1,
    'typeCode': 'ATHPCH',
    'subTypeCode': '6010',
    'subType': 'FinancialInstitutionsManualCashDisbursements',
    'type': 'Card Purchase Authorization',
    'visaTransactionId': '000009202128310',
    'transactionCurrencyCode': '840',
    'transactionAmount': 20.15,
    'settlementAmount': 0,
    'settlementConversionRate': 0
  },
  'ts': '0001-01-01T00:00:00+00:00',
  'idToken': ''
}
}