Address Handling
PaymentWorks supports several address types out of the box. This article describes those addresses and how each is handled - not all are handled the same way.
Addresses in New Vendor Registrations
The original supplier profile is created from a new vendor registration, which will always contain at least two addresses, and as many as four.
Corporate (legal) address (required)
Remittance address (required)
Order address (not currently included in standard implementations)
Bank address (provided if registration includes a bank account)
Note: some customers have added custom fields to enable other address types. More on this approach below.
1. Corporate / Primary (required)
In PaymentWorks, the corporate address is assumed to be the legal address. Most ERPs can associate the corporate address, which is referred to as the “Primary Address” in the PaymentWorks registration form, with a single top-level address for a supplier record
There is only one Corporate address in a Supplier’s PaymentWorks profile. The supplier may change this address, and that change would appear in the Vendor Updates view in the “Corporate Address” field group.
2. Remittance Address (required)
While suppliers will have only one primary (legal / corporate) address, they may have multiple Remittance addresses. Only one of these Remittance addresses will be included in the initial registration. However, after their initial registration has been connected, the supplier may submit one or more additional Remittance addresses. These will arrive as separate “Partial” registrations, each of which can be mapped to a subordinate address in the ERP and identified in PaymentWorks by its Site Code.
More information on handling multiple Remittance addresses can be found in the Registration Routing article.
Differentiating between Corporate and Remit Addresses
Many registrations will contain the same address for both the Corporate (Legal) and Remittance Address field values.
Some PaymentWorks Payers have chosen to handle those addresses as two discrete records in the ERP. This helps manage the case when a supplier modifies their Corporate Address without changing their Remittance Address in PaymentWorks, or vice versa. If the two had not been entered as separate records initially, the modified address would require separating the single address into separate records in the ERP.
3. Order Address (Payer-specific)
Some PaymentWorks Payers choose to enable Order Addresses for suppliers. These addresses are not part of the standard initial implementation provided by PaymentWorks.
The Order Address functions very much like the Remittance address. When enabled, it appears as a third kind of address in the registration form, with the checkbox option to use the same values as the Remittance address.
As with Remittance Addresses, while the registration form will include only one set of Order address fields, a supplier may provide additional order addresses
Contact Fields for Remittance and Order Addresses
A payer account may be configured so that the registration form will require three contact fields - name, email and phone number - for both Remittance addresses and, if enabled, Order addresses. This is currently a configuration option enabled only by PaymentWorks personnel.
Regardless of how a payer account is configured, when a supplier adds or modifies a Remittance or Order address, they will be required to provide the three contact fields for each address.
4. Bank Address (if supplier submits a Bank Account)
If the supplier indicates that their desired payment method is ACH, the registration will include both bank account and bank address information. And while a supplier may submit more than one bank account - each tied to a Remittance address - there will always be only one address associated with each supplier bank account.
5. Adding Addresses as Custom Fields
Some customers have configured their registration forms to provide an option for a third address type, such as an Invoice address: the address from which invoices will be submitted. These addresses are enabled by adding custom fields to the form, so there are limitations:
The provided address will not be validated against the USPS directory.
The address will not be adjacent to the standard address types in the form.
There can be only one of these additional address types.
Other Considerations
Number and Length of Address Fields
Each standard address type contains seven fields:
Address Street 1
Address Street 2
Address City
Address State
Address Country
Address Postal code
Address ISO 3166-2 (more on this below)
PaymentWorks includes only two fields for street-level addresses, e.g. Address Street 1 and Address Street 2. Many ERPs have more street addresses than this, so mapping will need to determine if any parsing needs to be done.
Another consideration: The maximum length of these street address fields in PaymentWorks is 100. Some ERP street address fields are shorter so the integration process may need to parse the data from PaymentWorks’s two fields and distribute to the additional address fields in the ERP.
International Addresses
PaymentWorks supports the ISO 3166-2 standard and delivers defined codes for the representation of names of countries and their subdivisions. Therefore each of the four standard address types will contain the six typical fields described above, plus a seventh field that will contain the ISO 3166-2 value, which is in the form of a 2-letter country code followed by a 1-3 character region code, separated by a hyphen: e.g. US-MA, GB-ESS or FR-25.
Next Steps
To learn more about PaymentWorks addresses and other configuration or to discuss your specific area of interest or concern, please reach out to set up a complimentary consultation. We’d be happy to connect!
You can fill out this form including an overview of your interest, or simply email us directly at bestpractices@nvrpartners.com.
