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)
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）する必要があります。

たとえば、名前を「０１２３４自分」に設定するには、「％EF％BC％90％EF％BC％91％EF％BC％92％EF％BC％93％EF％BC％94％EF％BC％95」を使用する必要があります。

Note：JPでは、指定された値が6文字を超えると、 postalCodeは自動的に1バイト形式に変換されます。