This guide will review how to set up Linked Refunds for Square in Aspenware Commerce, Unity, and RTP.
...
Once a customer is created, Square can create a payment ID (in the form of an alphanumeric value) that safely links the customer with their card on file. You can learn more about this process here: https://developer.squareup.com/docs/cards-api/walkthrough/card-from-payment-id .
Feature Detail
RTP
With this update, Aspenware Commerce can:
put the payment ID on the order deposit transaction (via a token)
put the card_on_file_ID on the alternate CC profile
for additional charges (payment plan future charges, gift card transactions, voucher transactions)
unlinked refunds
Feature Detail Header 1
ParagraphBelow is an example of an order that shows Visa instead of Aspenware Clearing for the initial deposit transaction.
...
Feature Detail Header 2
Paragraph
Configuration Guide
(This includes the step-by-step instructions for installing, enabling, and/or configuring the enhancement or feature.)
Prerequisite Steps
POS Tasks
| Note |
|---|
Due to recent development by Active Network to accommodate the payment ID, your resort’s RTP POS resort must be using RTP which must be on version 2022.4.2.144 or later. |
Infrastructure Tasks
...
RTP
Aspenware will lookup which credit payment method to use based on the setup in RTP’s Credit Card Validation table. Some customers have unique credit card payment methods defined in this area of admin while others have a generic ‘credit card’ payment method. Regardless of which is used, Aspenware will select the first entry for each card type based on the Aspenware credit providers card brand mapping to this area of RTP administration. For example if a Mastercard is used in Aspenware, the Payment Method assigned to the first entry below for Mastercard will be used.
Credit Card Validation Administration
Additional entries may need to be added to RTP’s Credit Card Validation if all card types accepted on Aspenware are not accounted for in the admin table below.
...
Each credit card payment method will need to be setup for the Aspenware Audit location in RTP’s Location and Audit Location Credit Card Authorization area of admin.
Location Administration / Location Management / Payment
Ensure the Aspenware audit location is added on the Locations tab and on the Payment Authorization Profiles tab.
...
Location Administration / Location Management / Audit Location Credit Card Authorization
Ensure the Aspenware audit location is added for all card types including the <None> type.
...
Unity
Linked refunds is enabled in the Unity rtp-config.json file by adding the following setting. Once this setting is added, Unity will no longer use the ‘Aspenware clearing’ payment method for orders. Orders will fail if the setting below is enabled but the RTP admin setup above is not setup properly. Please ask your services representative if you need help with this setting.
| Code Block |
|---|
"LinkedRefundsEnabled": true, |
Commerce Tasks
The only requirement of Commerce is that you are using the Square Payment Gateway.
...
There are no Commerce settings, language strings, html widgets that apply to enabling Linked Refunds unless you would like to introduce a “save credit card” warning or checkbox.
Detailed Setup Guide
Step 1
sub-bullet
...
Common Troubleshooting guide
...
Linking cards on file without obtaining customer permission can result in your application being disabled without notice.
...
DELETE CONTENT AFTER THIS LINE
How-to Guide of this page can be found here: [Internal] Release Guide
...