Address
Address: Create
See also the Address response object.
The only attribute required to create an address is the CustomerId. Addresses stored in the Vault need to be associated to a customer. You can't specify Address ID. It is always generated by the gateway as two alphanumeric characters. Address IDs are unique to the customer, so multiple customers can have the same address ID.
There is a limit of 50 addresses that can be saved per customer. Addresses can also be created with a payment method or created with a customer and a payment method.
- DOTNET
var request = new AddressRequest
{
FirstName = "Jenna",
LastName = "Smith",
Company = "Braintree",
StreetAddress = "1 E Main St",
ExtendedAddress = "Suite 403",
Locality = "Chicago",
Region = "Illinois",
PostalCode = "60622",
CountryCodeAlpha2 = "US"
};
Result<Address> result = gateway.Address.Create("TheCustomerId", request);
If the address or customer can't be found, it will throw a NotFoundException
.
Arguments
CustomerId
required, stringAdditional Parameters
Company
stringCountryCodeAlpha2
stringThe ISO 3166-1 alpha-2 country code specified in an address. The gateway only accepts specific alpha-2 values.
CountryCodeAlpha3
stringThe ISO 3166-1 alpha-3 country code specified in an address. The gateway only accepts specific alpha-3 values.
CountryCodeNumeric
stringThe ISO 3166-1 numeric country code specified in an address. The gateway only accepts specific numeric values.
CountryName
stringThe country name specified in an address. We only accept specific country names.
ExtendedAddress
stringFirstName
stringCountryCode
stringNationalNumber
stringLastName
stringLocality
stringPhoneNumber
stringDeprecated.
We recommend using international_phone
. This functionality still exists in the gateway but is no longer documented. This parameter will be removed in the future.
PostalCode
stringRegion
stringStreetAddress
string