Reference - Grand Central Documentation

The Smarty integration validates and autocompletes postal addresses for US and international customers during onboarding and payment flows. For setup steps, see Get started.

Supported operations

The Smarty connector supports the following operations.

Address autocomplete

Retrieve an address list based on the end-user’s initial input.
- The Smarty Connector triggers the US address autocomplete endpoint when country = “US”.
- The Smarty Connector triggers the international address autocomplete endpoint when country != “US”.

Address validation

Retrieve complementary address information, such as type of address (commercial, residential) or whether the address is suitable for mailing.

Events

This connector is synchronous and doesn’t publish or consume events.

Error mapping

The following table maps each Smarty Connector error code to its Grand Central counterpart:

Smarty Connector code	Grand Central code
`Unauthorized/authentication required`	`GC002`
`Method not allowed`	`GC023`
`Bad request`	`GC025`
`international-autocomplete-api`	`GC025`
`us-autocomplete-api`	`GC025`
`us-street-api`	`GC025`
`Internal server error`	`GC025`
`Payment required error`	`GC025`
`Rate limit imposed`	`GC031`
`Not found`	`GC054`

For a complete list of Grand Central error codes and their descriptions, see Status codes, errors, and responses.