Overview
Orgs using Westpac payment gateway may receive the error “customerName A value is required for this field” when updating card details from an external card update link.
This error occurs when Payments2Us is unable to send the customer name to Westpac. In this scenario, the Site Guest User does not have access to the related Contact record, so the customerName value is sent as blank.
Use Case / Scenario
A supporter or donor uses an external card update link to update their card details for a Recurring Payment.When the update is submitted, Westpac returns the error:
customerName: A value is required for this field
How this Works with Payments2Us
Payments2Us uses the Merchant Facility configuration to determine which records should be excluded from site sharing logic.
For external card update scenarios, the Site Guest User needs access to the relevant Contact and related Account information so Payments2Us can send the required customer details to the Payment Gateway.
If Account is not included in the Excluded from Site Sharing field on the Merchant Facility, the Site Guest User may not be able to access the Contact record correctly. As a result, Payments2Us sends an empty customerName value to Westpac, and the gateway rejects the request.
Resolution
To resolve this issue:
- Go to the relevant Merchant Facility record.
- Locate the field Excluded from Site Sharing.
- Add Account to the selected values.
- Save the Merchant Facility.
- Try the external card update again.
More detailed instructions please refer to section 3.1 of article How to set up sites sharing settings
Once Account has been added and selected on the Merchant Facility, the Site Guest User should be able to access the required record information, and Payments2Us should be able to send the customer name to the Payment Gateway correctly.
If you cannot see the field
If the Excluded from Site Sharing field is not visible on the Merchant Facility page, contact your Salesforce administrator.
Your administrator may need to add the field to the Merchant Facility page layout. This field was included as part of the 8.12 post upgrade steps.
If you cannot see the Account option
If Account is not available as an option in the Excluded from Site Sharing picklist, contact your Salesforce administrator. Your administrator will need to add Account as a picklist value for:
- The Excluded from Site Sharing picklist field
- All relevant Merchant Facility record types