Billing Address

Revolv3 allows flexible billing address formats for PaymentMethod, depending on processor requirements and merchant agreements. This guide outlines the accepted validation rules, API request formats, and best practices for handling billing addresses in Revolv3.

1. Accepted Billing Address Formats

To pass validation, a billing address must include at least one of the following combinations:

✔ AddressLine1, City, and State

✔ AddressLine1 and Postal Code

✔ State and Postal Code

✔ AddressID

📌 One of these formats is required; otherwise, the API will return an error.

1. Sample API Request with a Billing Address

The following JSON request demonstrates a valid billing address structure:

{
  "PaymentMethod": {
    "BillingAddress": {
      "AddressLine1": "381 Forest Ave",
      "City": "Laguna Beach",
      "State": "CA",
      "PostalCode": "92651",
      "Country": "USA"
    },
    "BillingFirstName": "Robert",
    "BillingLastName": "Podlesni",
    "CreditCard": {
      "PaymentAccountNumber": "4111111111111111",
      "ExpirationDate": "0330",
      "SecurityCode": "737"
    }
  }
}

1. Handling Validation Errors

If the provided address does not meet the minimum required fields, the API will return an error message like the following:

{
  "errorMessage": "Neither an Address ID nor a required set of address fields were provided."
}

📌 Ensure that one of the accepted address formats is included in the request to prevent errors.

1. Additional Notes on Address Formatting

✔ Country codes should follow ISO Alpha-2 or Alpha-3 abbreviations.

✔ For U.S. addresses, the postal code must be exactly 5 characters.

✔ For international addresses, postal codes can be up to 10 characters.

✔ For many countries, the State field is not required.

🔗 Reference: Country Codes for IBAN

1. Sample Billing Address for the United Kingdom

For countries where the State field is not required, a valid billing address can be structured as follows (UK in this example):

{
  "BillingAddress": {
    "AddressLine1": "49 Featherstone Street",
    "City": "London",
    "PostalCode": "EC1Y 8SY",
    "Country": "GB"
  }
}

📌 Ensure that the postal code format follows the country-specific rules to avoid validation errors.

1. Summary of Billing Address Validation in Revolv3