authorization
The authorization element is the parent element for all Authorization transactions. You can use this element in either Online or Batch transactions.
Parent Elements:
cnpOnlineRequest, batchRequest
Attributes:
Attribute Name |
Type |
Required? |
Description |
---|---|---|---|
id |
String |
Yes |
A unique identifier assigned by the presenter and mirrored back in the response. minLength = 1 maxLength = 36 |
customerId |
String |
No |
A value assigned by the merchant to identify the consumer. minLength = N/A maxLength = 50 |
reportGroup |
String |
Yes |
Required attribute that defines the merchant sub-group in the user interface where this transaction will be displayed. For additional information, see Coding for Report Groups. minLength = 1 maxLength = 25 |
Child Elements:
Required (all except incremental auth): orderId, amount, orderSource, (choice of) card, paypal, paypage, mpos, token, or applepay, cardholderAuthentication, authIndicator
Required (for incremental auth): cnpTxnId, amount, authIndicator
The cardholderAuthentication
child element is required only for 3-D Secure transactions. The authIndicator
child element is required only for Visa transaction where you estimate the auth amount and later submit an incremental auth.
Optional (not present for incremental auths): customerInfo, sellerInfo, billToAddress, shipToAddress, retailerAddress, additionalCOFData, processingInstructions, pos, customBilling, taxType, enhancedData, allowPartialAuth, healthcareIIAS, merchantCategoryCode, merchantData, recyclingRequest, fraudFilterOverride, surchargeAmount, debtRepayment, recurringRequest , advancedFraudChecks, secondaryAmount, wallet, processingType, filtering, originalNetworkTransactionId, originalTransactionAmount, lodgingInfo, pinlessDebitRequest, skipRealtimeAU, businessIndicator, orderChannel , crypto, fraudCheckStatus, passengerTransportData, accountFundingTransactionData, fraudCheckAction
The following child elements are for internal use only: overridePolicy, fsErrorCode, merchantAccountStatus, productEnrolled, decisionPurpose, fraudSwitchIndicator.