Name and address validation

These rules apply to person names and postal addresses on Customers and Crypto Payouts when the fields are sent, or when the customer / payout type requires them. Field length limits are shown on each property in the API reference.

Person names (firstName, lastName)

• Allowed characters: letters, spaces, and ' - . only
• Digits, emoji, and other symbols are not accepted
• Placeholder or test names are rejected
• Latin names that are all-uppercase or all-lowercase may be stored in title case

Postal address

Applies to address1, address2, city, state, zip, and country.

• Allowed characters: letters, digits, spaces, and - . , / ' #
• Placeholder or gibberish values are rejected

When names / address are required

• cryptoPayout customers: first name, last name, and full postal address (address1, city, state, zip, country), plus wallet details
• Crypto payout create without customerCode: same name and address fields on the payout request
• Invoicing customers: email is required; names and address are optional unless you send them (validation still applies when sent)