<aside> 💡 To collect what3words addresses from your customers, you’ll first need to add a what3words address field to your checkout page or CRM. To do so you can use one of our existing plugins or the what3words API. You can take a look at these options and find out more information here. To get started with Carriyo, you can contact them here.

</aside>

Here is a step-by-step guide for passing through a what3words address to Carriyo in the different available formats:

1. Passing through a w3w address directly from a checkout page into Carriyo:

When creating a shipment in CARRIYO, via the Create Shipment API, you can pass the what3words Address in the dropoff array as follows:

"dropoff": {},

"contact_name": "Jo Bloggs",

"contact_phone": "0561111234",

"contact_email": "[email protected]",

"address1": "1, 10th Floor, Tower One",

"address2": "Dubai Marina",

"city": "DUBAI",

"what3words": "///tourist.them.bonkers",

"postcode": "",

"country": "AE"

"order_date": "2021-01-01T10:00:00.999Z"

}

The shipment will be created in CARRIYO and the what3words address will be converted to actual coordinates, as displayed below.

**

What3Words address saved in CARRIYO and translated to actual coordinates in the dashboard.

What3Words address saved in CARRIYO and translated to actual coordinates in the dashboard.

These coordinates will then be passed to delivery partners, when booking shipments.

Drop-off address coordinates being passed to a delivery partner as part of the booking request.

Drop-off address coordinates being passed to a delivery partner as part of the booking request.


  1. Manually creating orders within Carriyo with a what3words address

You can manually add the what3words address when creating shipments directly in the CARRIYO dashboard.