Address Verification Service (AVS) handling under Payment Rules
This topic explains how AVS is handled in an orders environment.
In an orders environment, the AVS result codes are checked by the Payment Rules subcomponent rather than the Order Management subsystem. The Payment Rules subcomponent has three types of responses to AVS codes: Pass, Reject, and AttentionRequired. Action is taken after a successful Approve or ApproveAndDeposit transaction is returned. A payment plug-in is responsible for mapping AVS scores that are specific to its payment back-end system to the AVS codes predefined by WebSphere Commerce. The AVS acceptable codes are 0 to 4.
The following table describes what the Payment Rules subcomponent does when a successful Approve or ApproveAndDeposit transaction is returned:
Transaction (action triggered by Payment Rules) Pass Reject AttentionRequired Approve Continues normally Reverses the approval and marks the result as failed. Sets the AttentionRequired flag to true in the result and creates a tickler. The transaction proceeds but the order is blocked. ApproveAndDeposit Continues normally Marks the result as failed. Since the deposit cannot be reversed, a tickler is generated. Sets the AttentionRequired flag to true in the result and creates a tickler. The transaction proceeds but the order is blocked. For example, if during an ApproveAndDeposit action, the AVS code returned by a plug-in is mapped to a Rejection response, the Payment Rules subcomponent marks the result of the overall as failed and creates a tickler because the deposit cannot be reversed.
The mapping of AVS scores 0 to 4 to responses Pass, Reject, and AttentionRequired is done through an AVS configuration XML file provided in the configuration for each payment method.
If you are configuring payment processing or writing a payment plug-in, you do not have to modify the AVS configuration XML file. If you are writing a plug-in, ensure that you map the protocol-specific AVS codes into WebSphere Commerce AVS codes 0 to 4. For more information, refer to the API information for the setAvsCode method in the Payment interface described in com.ibm.commerce.payments.plugin.
(C) Copyright IBM Corporation 1996, 2006. All Rights Reserved.