Buyers' Details
You need to model information about the buyer such as their name and email address.
You can add the buyer's details at the transaction level. The following table summarizes the available fields:
Field | Description |
---|---|
buyer_name | Buyer's first name and last name. |
buyer_email | Buyer's email address. |
You can also include an address such as Ship To Address. This is explained in the Addresses topic.
You can also capture a Buyer's Tax ID in the buyer_tax_number
field. This is explained in the Vertex Validator topic.
Example
The following example adds the details at the transaction level:
{
"transaction": {
"tax_timestamp": "2025-03-01T12:00:00Z",
"description": "Transaction description",
"currency_code": "EUR",
"buyer_name": "Test buyer",
"ship_to_address": {
"country_code": "GB",
"city": "Big city",
"street_name": "Street name",
"building_number": "100a",
"address_detail": "2nd fl",
"postal_code": "00000"
},
"billing_address": {
"country_code": "GB",
"city": "The big city",
"street_name": "The street name",
"building_number": "100a",
"postal_code": "00000"
},
Updated 6 days ago