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
`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
`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

Example Payload

{
  "correlationId": "7fad3341-c2fd-4cfb-afcf-131ab6f4c4f5",
  "event": {
    "AcquirerInstitutionCountryCode": null,
    "AdditionalAmountsGratuity": null,
    "AdditionalAmountsPurchase": null,
    "AdditionalFeesCCA": 0,
    "AdditionalFeesICA": 0,
    "Amount": 16,
    "CardAcceptorCountryCode": "US",
    "CardId": 10238971,
    "CashbackAmount": null,
    "CashDepositAmount": 0,
    "CustomerId": 33974626,
    "Cvv2PresenceIndicator": null,
    "Cvv2Result": "M",
    "FromAccountAmount": 0,
    "FromAccountId": 33974629,
    "FromAccountNumberMasked": "*************9516",
    "FromAvailableAmount": 0,
    "FromCategory": "",
    "FromCreatedDate": "2023-07-26T16:41:32.2912715-05:00",
    "FromCustomField1": "",
    "FromCustomField2": "",
    "FromCustomField3": "",
    "FromCustomField4": "",
    "FromCustomField5": "",
    "FromLegalName1": "",
    "FromLegalName2": "",
    "FromName": "Faker-XAPQKSLCRD",
    "FromPrimaryCustomerId": 33974626,
    "FromSubCategory": "",
    "FromTag": "",
    "FromTargetAmount": 0,
    "FromTargetDate": "9999-12-31T23:59:59.9999999+00:00",
    "FromTargetMetDate": "9999-12-31T23:59:59.9999999+00:00",
    "ToAccountId": null,
    "ToAccountNumberMasked": null,
    "ToAvailableAmount": null,
    "ToCategory": null,
    "ToCreatedDate": null,
    "ToCustomField1": null,
    "ToCustomField2": null,
    "ToCustomField3": null,
    "ToCustomField4": null,
    "ToCustomField5": null,
    "ToLegalName1": null,
    "ToLegalName2": null,
    "ToName": null,
    "ToPrimaryCustomerId": null,
    "ToSubCategory": null,
    "ToTag": null,
    "ToTargetAmount": null,
    "ToTargetDate": null,
    "ToTargetMetDate": null,
    "MessageTypeIndicator": "0200",
    "MerchantCategoryCode": "6010",
    "MerchantCity": "CITY NAME",
    "MerchantCountryCode": "US",
    "MerchantId": "CARD ACCEPTOR  ",
    "MerchantLocation": "123 FIRST ST.",
    "MerchantStateCode": "CA",
    "MerchantZipCode": "",
    "NationalPointOfServiceConditionCardPresence": "0",
    "NationalPointOfServiceConditionCardPresentation": "0",
    "NationalPointOfServiceConditionCardRetention": "0",
    "NationalPointOfServiceConditionCardTransaction": "0",
    "NationalPointOfServiceConditionSecurityCondition": "8",
    "NationalPointOfServiceConditionTerminalEntryCapability": "5",
    "NationalPointOfServiceConditionTerminalOperator": "0",
    "NationalPointOfServiceConditionTerminalPremises": "1",
    "NationalPointOfServiceConditionTerminalType": "02",
    "NationalPointOfServiceConditionTerminalUnattended": "1",
    "NetworkProviderTypeId": "VisaDps",
    "PaymentAccountReferenceNumber": "10010014621056636090615846428",
    "PointOfServicePanEntryMode": "IntegratedCircuitCard",
    "PointOfServicePinEntryMode": "PinEntryCapability",
    "PinValidationCode": "1111111111111111",
    "PrivatelyDefinedDataAdditionalTransactionElementFallbackIndicator": " ",
    "PrivatelyDefinedDataAcquirerNetworkIdCode": "NYC",
    "PrivatelyDefinedDataRiskDataFalconReason1": "00",
    "PrivatelyDefinedDataRiskDataFalconReason2": "00",
    "PrivatelyDefinedDataRiskDataFalconReason3": "00",
    "PrivatelyDefinedDataProcessingFlagIsAIndicator": " ",
    "PrivatelyDefinedDataProcessingFlagPartialAuthIndicator": " ",
    "PrivatelyDefinedDataProcessingFlagSpecialTransactionIndicator": " ",
    "PrivatelyDefinedDataRiskDataResponseCode": "0",
    "PrivatelyDefinedDataRiskDataScoreSource": "1",
    "PrivatelyDefinedDataRiskDataScoreValue": "0000",
    "PrivatelyDefinedDataRiskDataVAAConditionCode1Rank": "",
    "PrivatelyDefinedDataRiskDataVisaRiskConditionCode1": "",
    "PrivatelyDefinedDataRiskDataVisaRiskConditionCode2": "",
    "PrivatelyDefinedDataRiskDataVisaRiskConditionCode3": "",
    "PrivatelyDefinedDataRiskDataVisaRiskReason": "",
    "PrivatelyDefinedDataRiskDataVisaRiskScore": "",
    "PrivatelyDefinedDataRiskDataRTDResultCode": "",
    "PrivatelyDefinedDataRiskDataTravelStatusIndicator": "",
    "PrivatelyDefinedDataTransactionLevelCredentialOnFileIndicator": "N",
    "PrivatelyDefinedDataTransactionLevelCryptocurrencyPurchaseIndicator": "N",
    "RequestTypeCode": "REQ",
    "RetrievalReferenceNumber": "113823013152",
    "SettlementFeeAmount": null,
    "SystemTraceAuditNumber": "013152",
    "SurchargeAmount": null,
    "Token": null,
    "TerminalId": "12345678",
    "TokenAssuranceLevel": null,
    "TokenExpirationDate": null,
    "Track2DataServiceCode": "201",
    "TransactionFeeAmount": null,
    "Version": 1,
    "TypeCode": "CRDXFR",
    "SubTypeCode": "6010",
    "SubType": "FinancialInstitutionsManualCashDisbursements",
    "Type": "Card Transfer Funds"
  },
  "ts": "2023-07-26T22:02:36.2000088+00:00",
  "idToken": null
}