AdditionalPaymentButton(今すぐ支払う) - 住所のフォーマットと検証
checkoutMode
にProcessOrderおよびproductType
にPayAndShipを設定した場合、addressDetails
に購入者から提供されるお届け先住所を設定しなければなりません。以下は、 Amazon Payが提供された住所を検証し、入力を標準化し、ラテン文字と特殊文字またはマルチバイト文字を処理する方法の詳細です。
アドレス検証
必要なaddressDetailsパラメータはリージョンによって異なります。
パラメータ | コメント |
name
|
必須パラメータ
|
addressLine1
|
必須パラメータ
|
addressLine2
|
オプションのパラメータ
|
addressLine3
|
オプションのパラメータ
|
city
|
必須パラメータ
|
districtOrCounty
|
オプションのパラメータ
|
stateOrRegion
|
必須パラメータ
|
postalCode
|
必須パラメータ
|
countryCode
|
必須パラメータ
|
phoneNumber
|
必須パラメータ
|
EUアドレス検証は、
countryCode
が次のいずれかの値である場合に適用されます: ' UK'、 'GB'、 'DE'、 'FR'、 'IT'、 'ES'、 'AT'、 'BE'、 'BG'、 ' HR '、' CY '、' CZ '、' DK '、' EE '、' FI '、' GR '、' HU '、' IE '、' LV '、' LT '、' LU '、' MT ' 、 'NL'、 'PL'、 'PT'、 'RO'、 'SK'、 'SI'、 'SE'
パラメータ | コメント |
name
|
必須パラメータ
|
addressLine1
|
必須パラメータ
|
addressLine2
|
オプションのパラメータ
|
addressLine3
|
オプションのパラメータ
|
city
|
必須パラメータ
|
districtOrCounty
|
オプションのパラメータ
|
stateOrRegion
|
countryCode が次の場合はサポートされません: ' UK'、 'GB'、 'SG'、 'AE'、 'MX'
|
postalCode
|
必須パラメータ
|
countryCode
|
必須パラメータ
|
phoneNumber
|
必須パラメータ
|
パラメータ | コメント |
name
|
必須パラメータ
|
addressLine1
|
必須パラメータ
|
addressLine2
|
オプションのパラメータ
|
addressLine3
|
オプションのパラメータ
|
city
|
オプションのパラメータ
|
districtOrCounty
|
オプションのパラメータ
|
stateOrRegion
|
必須パラメータ
|
postalCode
|
必須パラメータ
|
countryCode
|
必須パラメータ
|
phoneNumber
|
必須パラメータ
|
入力の標準化
Amazon Payは、次の変換を使用してaddressDetails
を標準化します。
- 先頭と末尾の空白はすべての入力から削除されます。
postalCode
とcountryCode
は大文字にします。name
とaddressLine1
は、最大長(それぞれ50文字と60文字)を超えると切り捨てられます。
さらに、次の変換がリージョンレベルで適用されます。
- US
- ダッシュが9桁のUSの
postalCode
に挿入されます (例 98104 - 3442)
- ダッシュが9桁のUSの
- JP
postalCode
のマルチバイト入力が6文字を超える場合、シングルバイト形式に変換されます。addressLine1
、addressLine2
、addressLine3
のマルチバイト入力が20文字を超える場合、シングルバイト形式に変換されます。name
のマルチバイト入力が16文字を超える場合、シングルバイト形式に変換されます。phoneNumber
はマルチバイト入力の場合、常にシングルバイト形式に変換されます。
ラテン文字と特殊文字またはマルチバイト文字
ラテン文字と特殊文字:
ラテン文字と特殊文字は、countryCode
を除くすべてのaddressDetails
フィールドでURLエンコード(UTF-8)する必要があります。
たとえば、City
を「東京」にするには、「%E6%9D%B1%E4%BA%AC」を使用する必要があります。
マルチバイト文字:
マルチバイト文字は、すべてのaddressDetails
フィールドでURLエンコード(UTF-8)する必要があります。
たとえば、名前を「01234自分」に設定するには、「%EF%BC%90%EF%BC%91%EF%BC%92%EF%BC%93%EF%BC%94%EF%BC%95」を使用する必要があります。
Note:JPでは、指定された値が6文字を超えると、 postalCode
は自動的に1バイト形式に変換されます。