Billing and shipping address

Japanese phonetics

You can add Japanese phonetics to the billing or shipping address.

For Japanese addresses, the customer may provide their division within their organization (for example, sales department) in the address, and they can enter their name in two scripting styles: Hiragana and Katakana. Hiragana is the traditional script used for a customer's name, while Katakana is the phonetic spelling of a customer's name. Customer services or courier services usually need phonetic spelling to correctly pronounce the customer's name. Foreigners living in Japan who don't have a Japanese name also use Katakana.

Digital River provides the ability to enter a phonetic name for a Japanese customer and a division in the billingAddress and shippingAddress objects.

Phonetic names stored in the required billing address will appear on the Order Summary page.

Add phonetics

To add phonetics to your billing and shipping addresses, add the following attributes:

"phoneticFirstName": "タロ", "phoneticLastName": "ヤマダ", "division": "営業部"

To the following resources:

After you implement phonetic names, you will see the new fields under the billing or shipping address in the response. For example:

Example
Example
{
"cart": {
"billingAddress": {
"nickname": "Home",
"firstName": "太郎",
"lastName":"山田",
"line1":"新宿区新宿1-1-1",
"line2":"新宿ビル203",
"line3":"line3",
"countrySubdivision":"愛知県",
"country":"JP",
"countryName":"Japan",
"phoneNumber":"03-1234-1234",
"city":"田原市",
"postalCode": "123-1234",
"companyName":"Digitalriver",
"emailAddress": "shopxTest@digitalriver.com",
"phoneticFirstName": "タロ",
"phoneticLastName":"ヤマダ",
"division": "営業部"
},
"shippingAddress": {
"nickname": "Home",
"firstName": "太郎",
"lastName":"山田",
"line1":"新宿区新宿1-1-1",
"line2":"新宿ビル203",
"line3":"line3",
"countrySubdivision":"愛知県",
"country":"JP",
"countryName":"Japan",
"phoneNumber":"03-1234-1234",
"city":"田原市",
"postalCode": "123-1234",
"companyName":"Digitalriver",
"emailAddress": "shopxTest@digitalriver.com",
"phoneticFirstName": "タロ",
"phoneticLastName":"ヤマダ",
"division": "営業部"
}
}
}