Addresses
The address resource is your billing address.
An active address is required in order to use a payment card funding source.
To associate an address with a funding source, use the same user_token
or business_token
for both resources.
Note
The/users
and /businesses
resources also have address fields.
Those are used for other purposes, such as KYC identity verification or as shipping addresses for physical cards.
Create address
Copy section link
Action: POST
Endpoint: /fundingsources/addresses
Use this endpoint to create an address resource.
When creating the address, you must pass the token of either an existing user in the user_token
field or an existing business in the business_token
field.
Do not pass both.
Request body
Copy section link
Fields | Description |
---|---|
active
boolean
|
Specifies whether the address is active. Allowable Values:
Default value: |
address_1
string
|
Street address. Allowable Values: 255 char max |
address_2
string
|
Additional address information. Allowable Values: 255 char max |
business_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
city
string
|
City. Allowable Values: 40 char max |
country
string
|
Country. Allowable Values: 1–40 chars |
first_name
string
|
First name. Allowable Values: 40 char max |
is_default_address
boolean
|
A value of Allowable Values:
Default value: |
last_name
string
|
Last name. Allowable Values: 40 char max |
phone
string
|
Telephone number. Allowable Values: 255 char max |
postal_code
string
|
Postal code. Allowable Values: 10 char max |
state
string
|
Two-character state, province, or territorial abbreviation. For a complete list of valid state and province abbreviations, see Valid state, provincial, and territorial abbreviations. Allowable Values: 2 char max |
token
string
|
The unique identifier of the address. If you do not include a token, the system will generate one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated. Allowable Values: 1–36 chars |
user_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
zip
string
|
The United States ZIP code.
This field is required if Allowable Values: 10 char max |
Response body
Copy section link
Fields | Description |
---|---|
active
boolean
|
Specifies whether the address is active. Allowable Values:
|
address_1
string
|
Street address. Allowable Values: 255 char max |
address_2
string
|
Additional address information. Allowable Values: 255 char max |
business_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
city
string
|
City. Allowable Values: 40 char max |
country
string
|
Country. Allowable Values: 1–40 chars |
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddTHH:mm:ssZ |
first_name
string
|
First name Allowable Values: 40 char max |
is_default_address
boolean
|
A value of Allowable Values:
|
last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddTHH:mm:ssZ |
last_name
string
|
Last name. Allowable Values: 40 char max |
phone
string
|
Telephone number. Allowable Values: 255 char max |
postal_code
string
|
Postal code. Allowable Values: 10 char max |
state
string
|
Two-character state, province, or territorial abbreviation. For a complete list, see Valid state, provincial, and territorial abbreviations. Allowable Values: 2 char max |
token
string
|
The unique identifier of the address object. Allowable Values: 1–36 chars |
user_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
zip
string
|
The United States ZIP code.
This field is returned if Allowable Values: 10 char max |
List business addresses
Copy section link
Action: GET
Endpoint: /fundingsources/addresses/business/{business_token}
Use this endpoint to list existing addresses for a business. This endpoint supports field filtering.
URL path parameters
Copy section link
Fields | Description |
---|---|
business_token
string
|
The unique identifier of the Allowable Values: Existing |
URL query parameters
Copy section link
Fields | Description |
---|---|
fields
string
|
Comma-delimited list of fields to return ( Allowable Values: Comma-delimited list of fields, or blank |
Response body
Copy section link
Fields | Description |
---|---|
count
integer
|
The number of resources to retrieve. Allowable Values: 1-10 |
data
array of objects
|
An array of Allowable Values: Valid |
data[].active
boolean
|
Specifies whether the address is active. Allowable Values:
|
data[].address_1
string
|
Street address. Allowable Values: 255 char max |
data[].address_2
string
|
Additional address information. Allowable Values: 255 char max |
data[].business_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
data[].city
string
|
City. Allowable Values: 40 char max |
data[].country
string
|
Country. Allowable Values: 1–40 chars |
data[].created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddTHH:mm:ssZ |
data[].first_name
string
|
First name Allowable Values: 40 char max |
data[].is_default_address
boolean
|
A value of Allowable Values:
|
data[].last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddTHH:mm:ssZ |
data[].last_name
string
|
Last name. Allowable Values: 40 char max |
data[].phone
string
|
Telephone number. Allowable Values: 255 char max |
data[].postal_code
string
|
Postal code. Allowable Values: 10 char max |
data[].state
string
|
Two-character state, province, or territorial abbreviation. For a complete list, see Valid state, provincial, and territorial abbreviations. Allowable Values: 2 char max |
data[].token
string
|
The unique identifier of the address object. Allowable Values: 1–36 chars |
data[].user_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
data[].zip
string
|
The United States ZIP code.
This field is returned if Allowable Values: 10 char max |
end_index
integer
|
The sort order index of the last resource in the returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of Allowable Values:
|
start_index
integer
|
The sort order index of the first resource in the returned array. Allowable Values: Any integer |
List user addresses
Copy section link
Action: GET
Endpoint: /fundingsources/addresses/user/{user_token}
Use this endpoint to list existing addresses for a user. This endpoint supports field filtering.
URL path parameters
Copy section link
Fields | Description |
---|---|
user_token
string
|
The unique identifier of the Allowable Values: Existing |
URL query parameters
Copy section link
Fields | Description |
---|---|
fields
string
|
Comma-delimited list of fields to return ( Allowable Values: Comma-delimited list of fields, or blank |
Response body
Copy section link
Fields | Description |
---|---|
count
integer
|
The number of resources to retrieve. Allowable Values: 1-10 |
data
array of objects
|
An array of Allowable Values: Valid |
data[].active
boolean
|
Specifies whether the address is active. Allowable Values:
|
data[].address_1
string
|
Street address. Allowable Values: 255 char max |
data[].address_2
string
|
Additional address information. Allowable Values: 255 char max |
data[].business_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
data[].city
string
|
City. Allowable Values: 40 char max |
data[].country
string
|
Country. Allowable Values: 1–40 chars |
data[].created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddTHH:mm:ssZ |
data[].first_name
string
|
First name Allowable Values: 40 char max |
data[].is_default_address
boolean
|
A value of Allowable Values:
|
data[].last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddTHH:mm:ssZ |
data[].last_name
string
|
Last name. Allowable Values: 40 char max |
data[].phone
string
|
Telephone number. Allowable Values: 255 char max |
data[].postal_code
string
|
Postal code. Allowable Values: 10 char max |
data[].state
string
|
Two-character state, province, or territorial abbreviation. For a complete list, see Valid state, provincial, and territorial abbreviations. Allowable Values: 2 char max |
data[].token
string
|
The unique identifier of the address object. Allowable Values: 1–36 chars |
data[].user_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
data[].zip
string
|
The United States ZIP code.
This field is returned if Allowable Values: 10 char max |
end_index
integer
|
The sort order index of the last resource in the returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of Allowable Values:
|
start_index
integer
|
The sort order index of the first resource in the returned array. Allowable Values: Any integer |
Retrieve address
Copy section link
Action: GET
Endpoint: /fundingsources/addresses/{funding_source_address_token}
Use this endpoint to retrieve a funding source address.
URL path parameters
Copy section link
Fields | Description |
---|---|
funding_source_address_token
string
|
The unique identifier of the funding source address. Allowable Values: Existing funding source address token |
Response body
Copy section link
Fields | Description |
---|---|
active
boolean
|
Specifies whether the address is active. Allowable Values:
|
address_1
string
|
Street address. Allowable Values: 255 char max |
address_2
string
|
Additional address information. Allowable Values: 255 char max |
business_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
city
string
|
City. Allowable Values: 40 char max |
country
string
|
Country. Allowable Values: 1–40 chars |
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddTHH:mm:ssZ |
first_name
string
|
First name Allowable Values: 40 char max |
is_default_address
boolean
|
A value of Allowable Values:
|
last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddTHH:mm:ssZ |
last_name
string
|
Last name. Allowable Values: 40 char max |
phone
string
|
Telephone number. Allowable Values: 255 char max |
postal_code
string
|
Postal code. Allowable Values: 10 char max |
state
string
|
Two-character state, province, or territorial abbreviation. For a complete list, see Valid state, provincial, and territorial abbreviations. Allowable Values: 2 char max |
token
string
|
The unique identifier of the address object. Allowable Values: 1–36 chars |
user_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
zip
string
|
The United States ZIP code.
This field is returned if Allowable Values: 10 char max |
Update address
Copy section link
Action: PUT
Endpoint: /fundingsources/addresses/{funding_source_address_token}
Use this endpoint to update an address. Only values of parameters in the request are modified; all others are left unchanged.
URL path parameters
Copy section link
Fields | Description |
---|---|
funding_source_address_token
string
|
The unique identifier of the funding source address. Allowable Values: Existing funding source address token |
Request body
Copy section link
Fields | Description |
---|---|
active
boolean
|
Specifies whether the address is active. Allowable Values:
Default value: |
address_1
string
|
Street address. Allowable Values: 255 char max |
address_2
string
|
Additional address information. Allowable Values: 255 char max |
city
string
|
City. Allowable Values: 40 char max |
country
string
|
Country. Allowable Values: 40 char max |
first_name
string
|
First name. Allowable Values: 40 char max |
is_default_address
boolean
|
A value of Allowable Values:
Default value: |
last_name
string
|
Last name. Allowable Values: 40 char max |
phone
string
|
Telephone number. Allowable Values: 255 char max |
postal_code
string
|
Postal code. Allowable Values: 10 char max |
state
string
|
Two-character state, province, or territorial abbreviation. For a complete list, see Valid state, provincial, and territorial abbreviations. Allowable Values: 2 char max |
zip
string
|
United States ZIP code Allowable Values: 10 char max |
Response body
Copy section link
Fields | Description |
---|---|
active
boolean
|
Specifies whether the address is active. Allowable Values:
|
address_1
string
|
Street address. Allowable Values: 255 char max |
address_2
string
|
Additional address information. Allowable Values: 255 char max |
business_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
city
string
|
City. Allowable Values: 40 char max |
country
string
|
Country. Allowable Values: 1–40 chars |
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddTHH:mm:ssZ |
first_name
string
|
First name Allowable Values: 40 char max |
is_default_address
boolean
|
A value of Allowable Values:
|
last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddTHH:mm:ssZ |
last_name
string
|
Last name. Allowable Values: 40 char max |
phone
string
|
Telephone number. Allowable Values: 255 char max |
postal_code
string
|
Postal code. Allowable Values: 10 char max |
state
string
|
Two-character state, province, or territorial abbreviation. For a complete list, see Valid state, provincial, and territorial abbreviations. Allowable Values: 2 char max |
token
string
|
The unique identifier of the address object. Allowable Values: 1–36 chars |
user_token
string
|
The unique identifier of the Allowable Values: 1–36 chars |
zip
string
|
The United States ZIP code.
This field is returned if Allowable Values: 10 char max |