billToAddress

The billToAddress element contains several child elements that define the postal mailing address (and telephone number) used for billing purposes. It also contains several elements used for the eCheck verification process.

Parent Elements:

authorization, BNPLAuthorizationRequest, captureGivenAuth, credit, echeckCredit (required if original transaction was not processed by Worldpay), echeckPreNoteCredit, echeckPreNoteSale, echeckSale, echeckVerification, forceCapture, fraudCheck, sale, updateSubscription

Attributes:

None

Child Elements: (all optional)

name, firstName, middleInitial, lastName, companyName, addressLine1, addressLine2, addressLine3, city, state, zip, country, email, phone

You must submit the name element for echeckSale and echeckCredit transactions. If you do not submit the customer name in these eCheck transactions, we return the response 709 - Invalid Data.

For an eCheckVerification transaction, you must submit the firstName and lastName elements instead of the name element (middleInitial is optional). For a corporate account you must include the companyName element in addition to the firstName and lastName elements. In both cases, you also must include the address, city, state, zip and phone information.

For a corporate account, if you do not have the name of the check issuer, you can use a value of “unavailable” for the firstName and lastName elements.

Example: billToAddress Structure

<name>Customer’s Full Name</name>

<firstName>Customer’s First Name</firstName>

<middleInitial>Customer’s Middle Initial</middleInitial>

<lastName>Customer’s Last Name</lastName>

<companyName>Company’s Name</companyName> (include for echeckVerification of corporate account)

<addressLine1>Address Line 1</addressLine1>

<addressLine2>Address Line 2</addressLine2>

<addressLine3>Address Line 3</addressLine3>

<state>State Abbreviation</state>

<zip>Postal Code</zip>

<country>Country Code</country>

<email>Email Address</email>

<phone>Telephone Number</phone>

</billToAddress>