IBM Support

Supporting VISA mandate for refund authorization

Education


Abstract

Read about the VISA mandate here:
https://usa.visa.com/dam/VCOM/global/support-legal/documents/new-purchase-return-vbs-10-apr-17.pdf

To support the new VISA mandate for refund authorization, the executeCollection API's user exits are enhanced to accept the authorization ID for refund CHARGEs. Changes are made to the user exit output (YFSExtnPaymentCollectionOutputStruct) to accept authorization information that is acquired for refund CHARGE settlement. This additional information is persisted in the YFS_CHARGE_TRANSACTION table as an information-only record.

Content

Implementing a solution by using the enhancement

When the YFSCollectionCreditCardUE is called to process a negative CHARGE that corresponds to a VISA card type, implement the following logic:

  1. Acquire return authorization and use the authorization to settle the negative CHARGE. Then, stamp the authorization ID against the refund CHARGE by passing the authorization id in the YFSCollectionCreditCardUE output (YFSExtnPaymentCollectionOutputStruct.authorizationId).
  2. Record the return AUTHORIZATION information in the YFS_CHARGE_TRANSACTION table, if needed, as an informational record. To record this information, pass the input to the recordExternalCharges API as part of the YFSExtnPaymentCollectionOutputStruct.recordAdditionalTransactions document with the following predefined constraints.
  • The RequestAmount attribute should be negative.
  • The ProcessedAmount attribute should be 0.
  • The RequestProcessed attribute should be Y with the matching authorization id passed as part of YFSExtnPaymentCollectionOutputStruct.authorizationId.
Sample XML for the recordExternalCharges API:
 

<RecordExternalCharges DocumentType="0001" EnterpriseCode="DEFAULT" OrderNo="q1">
   <PaymentMethod PaymentKey="2019080815675914180289">
       <PaymentDetailsList>
           <PaymentDetails
               ChargeType="AUTHORIZATION" AuthorizationExpirationDate="2020-07-01"
               ProcessedAmount="0"
               RequestAmount="-50" RequestProcessed="Y" AuthorizationID="44" />
       </PaymentDetailsList>
   </PaymentMethod>
</RecordExternalCharges>

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS6PEW","label":"Sterling Order Management"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"19.3","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
01 November 2021

UID

ibm11032918