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を標準化します。

  • 先頭と末尾の空白はすべての入力から削除されます。
  • postalCodecountryCodeは大文字にします。
  • nameaddressLine1は、最大長(それぞれ50文字と60文字)を超えると切り捨てられます。

さらに、次の変換がリージョンレベルで適用されます。

  • US
    • ダッシュが9桁のUSのpostalCodeに挿入されます (例 98104 - 3442)
  • JP
    • postalCodeのマルチバイト入力が6文字を超える場合、シングルバイト形式に変換されます。
    • addressLine1addressLine2addressLine3のマルチバイト入力が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バイト形式に変換されます。