Buy Now Checkout
Amazon PayにOneTime決済における全チェックアウトフローを処理させ、Buy Now経由の購入者のリダイレクトを削減ことができます。OneTimeのインテグレーションとは異なり、購入者はチェックアウトを完了する前に注文を確認するために事業者サイトに戻る必要はありません。全てはAmazon PayのBuy Nowがホストするチェックアウトページで処理され、提供されます。
チェックアウト中にAmazon Payは事業者のイベントハンドラを呼び出し、チェックアウト関連情報を交換します。これには配送を伴う商品のAmazonホスティングチェックアウトページで顧客が選択した住所、顧客が提供したクーポンコード（該当する場合）などが含まれます。事業者はこれらの操作に対して cartDetails で応答します。これらには、例えば利用可能な配送オプション、購入者に表示するオプションの商品情報、注文金額などが含まれます。
- Buy Now Checkout types
- Type: BuyerAdditionalInfo
- Type: CartDetails
- Type: LineItem
- Type: DeliveryOption
- Type: ShippingMethod
- Type: EstimationDetails
- Enum: TimeUnit
- Type: DateTimeWindowDetails
- Enum: DateTimeWindowDetails.Type
- Type: Scopes
- Type: Checkboxes
- Type: Attributes
- Enum: Checkbox
- Type: ItemProperty
- Type: FreeForm
- Type: Price
- Enum: AddOnFeatureType
- Type: deliveryOption (event input)
- Gifting Types (JP Only)
Buy Now Checkout types
Note: BuyerAdditionalInfoはEU/UKリージョン専用の機能です。JPリージョンでは利用できません。
Type: BuyerAdditionalInfo
| パラメータ
|
説明
|
| vatId (リクエストされた場合は必須) Type: string |
B2B請求書用のVAT ID |
| province (リクエストされた場合は必須) Type: string |
購入者の配送先住所の都道府県 |
| dateOfBirth (リクエストされた場合は必須) Type: string |
DD/MM/YYYY |
| prefix (リクエストされた場合は必須) Type: string |
購入者名の敬称。Mr (Herr)、Ms (Frau)、other |
| SIRET (リクエストされた場合は必須) Type: string |
SIRET番号は事業体とその特定の所在地の両方を識別します |
| SIREN (リクエストされた場合は必須) Type: string |
SIREN番号は事業体を識別します |
Type: CartDetails
| パラメータ
|
説明
|
| deliveryOptions (必須 Type: List of DeliveryOption |
指定された住所で利用できる配送オプションonInitCheckoutイベントハンドラで PayAndShipでは必須。
|
| totalShippingAmount (必須) Type: Price |
送料の合計金額
|
| totalBaseAmount (必須) Type: Price |
カート内の商品の合計金額
|
| totalTaxAmount Type: Price |
消費税の合計金額
|
| totalChargeAmount (必須) Type: Price |
この取引の合計金額
|
| totalDiscountAmount Type: Price |
合計割引額
|
| totalOrderAmount Type: Price |
複数オーソリをとる場合に使用するこの取引の合計金額
|
| lineItems Type: List of LineItem |
カート内の商品の合計金額
|
| giftDetails Type: GiftDetails |
[JP Only] ギフトタイプ、メッセージ、ラッピングオプションを含むギフト関連の詳細。詳細はGifting Typesセクションを参照してください。
|
| addressDisplayType Type: AddressDisplayType[Enum] |
[JP Only] ギフトのユースケースでBuy Nowページに送り主の住所を表示する必要があるかどうかを決定します。
|
| addOnFeatures Type: List<AddOnFeatureType[Enum]> |
Amazon Payチェックアウトで有効にするアドオン機能のリスト。POINTS、PROMO_CODE、GIFTなどの関連機能を含めてください。
|
Type: LineItem
| パラメータ
|
説明
|
| id (必須) Type: string |
商品の識別子
|
| title (必須) Type: string |
商品名
|
| quantity (必須) Type: string |
商品の個数 |
| listPrice (必須) Type: Price |
商品の定価
|
| totalListPrice (必須) Type: Price |
商品の定価の合計 (totalListPrice = listPrice * quantity)
|
| variantTitle Type: string |
商品の補足情報 例 'ブルー/Mサイズ'
|
| discountedPrice Type: Price |
割引後の商品合計金額
|
Type: DeliveryOption
| パラメータ
|
説明
|
| id (必須) Type: string |
配送オプション識別子
|
| price (必須) Type: Price |
送料合計
|
| shippingMethod (必須) Type: ShippingMethod |
配送方法詳細
|
| isDefault (必須) Type: boolean |
デフォルトの配送オプションを指定します。１つのみ isDefault=true を指定し、その他は false を指定してください。
|
| shippingEstimate Type: List of EstimationDetails |
配送の見積り (配送サイズでの必要配送時間)
|
| discountedPrice Type: Price |
割引後の送料
|
| dateTimeWindow Type: list<DateTimeWindowDetails> |
配送希望日時
|
Type: ShippingMethod
| パラメータ
|
説明
|
| shippingMethodName (必須) Type: string |
配送方法名
|
| shippingMethodCode Type: string |
配送方法コード
|
Type: EstimationDetails
| パラメータ
|
説明
|
| timeUnit (必須) Type: TimeUnit |
見積り時間の単位
|
| value (必須) Type: number |
見積り時間単位への値
|
Enum: TimeUnit
| 値
|
説明
|
| MINUTE Type: string |
分
|
| HOUR Type: string |
時間
|
Type: DateTimeWindowDetails
| パラメータ |
説明 |
| type (必須) Type: DateTimeWindowDetails.Type |
日または時間のタイプ |
| value (必須) Type: list<string> |
日または時間の可能な値 |
| defaultValue Type: string |
デフォルトの日または時間の可能な値 |
Enum: DateTimeWindowDetails.Type
| 値
|
説明
|
| DATE Type: string |
配送日
|
| TIME Type: string |
配送時間
|
Type: Scopes
| パラメータ |
説明 |
| buyer Type: Buyer |
BuyerId、名前、メールアドレスなど購入者の詳細情報 |
| billingAddress Type: Address |
選択された請求先住所 |
4.2.7.11 Place Order Response
「注文を確定」ボタンクリック時に送信するレスポンスの詳細を定義します。
| パラメータ
|
説明
|
| checkbox Type: list<Checkbox> |
BuyerId、名前、メールアドレスなど購入者の詳細情報
|
| freeForm Type: string |
購入者によって入力されたフリーフォームテキスト
|
| deliveryOptions Type: list<DeliveryOption> |
購入者が希望する配送オプション |
Type: Checkboxes
チェックボックスレスポンスの属性を定義します。
| 属性 | タイプ | 説明 | 必須 | デフォルト |
| type | Checkbox [ENUM] | チェックボックスのEnum | Yes | N/A |
| attributes | Attributes | チェックボックスの属性リスト | Yes | N/A |
Type: Attributes
チェックボックス属性のリスト
| 属性 | タイプ | 説明 | 必須 | デフォルト |
| hyperlinks | List<Strings> | ハイパーリンクのリスト | Yes* | N/A |
| programName | String | MEMBERSHIP_SIGN_UPチェックボックステンプレート用のプログラム名 | Yes | N/A |
| policyNames | List<Strings> | MERCHANT_MULTIPLE_DISCLOSURESチェックボックステンプレート用のポリシー名リスト | Yes** | N/A |
| isPrechecked | Boolean | チェックボックスを事前にチェック済みにするかどうか | No | FALSE |
*MERCHANT_DISCLOSURES、RIGHT_OF_WITHDRAWL、MERCHANT_MULTIPLE_DISCLOSURESで必須
**MERCHANT_MULTIPLE_DISCLOSURESで必須
Enum: Checkbox
CheckoutSessionConfig ペイロードに、チェックアウト時に表示するチェックボックスを定義します (任意機能となり、存在しない場合は表示されません。最大 4 つまでとなります。)。 必要なチェックボックスをCheckoutSessionConfigペイロードに含めます。
| 値
|
説明
|
| MERCHANT_DISCLOSURE Type: string |
個人情報保護方針と利用規約に対する購入者からの明確な同意を収集するためのチェックボックスを追加します。
|
| MEMBERSHIP_SIGN_UP Type: string |
購入者に会員登録を求めるチェックボックスを追加する。
|
| SMS_DELIVERY_NOTIFICATION Type: string |
購入者にAmazonアカウントに関連付けられた電話番号へのSMS配信通知を申し込むよう求めるチェックボックスを追加する。
|
| NEWSLETTER_SIGN_UP Type: string |
購入者に、Amazonアカウントに関連付けられたメールアドレスにニュースレターを受信するようサインアップを求めるチェックボックスを追加する。
|
| RIGHT_OF_WITHDRAWL Type: string |
撤回権ポリシーに対する購入者からの明確な同意を収集するためのチェックボックスを追加する。
|
| MERCHANT_MULTIPLE_DISCLOSURES Type: string |
最大3つのポリシーに対する購入者からの明確な同意を収集するためのチェックボックスを追加する。
|
Type: ItemProperty
商品の追加属性を定義する
| 属性 | タイプ | 説明 | 必須 | デフォルト |
| name | string | 商品プロパティの名前 | No | N/A |
| value | string | 商品プロパティの値 | No | N/A |
Type: FreeForm
| 属性 | タイプ | 説明 | 必須 | デフォルト |
| placeholderText | string | プレイスホルダーに表示するテキスト | Yes | N/A |
| limit | string | フリーフォームの最大文字長 | No | 250 |
| isMandatory | boolean | フリーフォームフィールドの入力が必須かどうかを示すインジケーター | No | false |
Type: Price
| パラメータ
|
説明
|
| amount Type: string |
取引額
|
| currencyCode Type: string |
ISO 4217フォーマットでの通貨コード 例: JPY |
Enum: AddOnFeatureType
| 値
|
説明
|
| POINTS Type: string |
事業者ポイント機能を表します
|
| PROMO_CODE Type: string |
プロモコード機能を表します
|
| GIFT Type: string |
ギフト機能を表します
|
Type: deliveryOption (event input)
| パラメータ
|
説明
|
| id Type: string |
配送オプション識別子
|
| amount Type: string |
送料の合計
|
| displayName Type: string |
配送方法表示名
|
Gifting Types (JP Only)
以下のタイプはギフト機能をサポートしており、現在は日本リージョンでのみ利用可能です。
Type: GiftDetails
| パラメータ
|
説明
|
| giftType Type: GiftType[Enum] |
サポートされるギフトの種類を定義します。現在はSTANDARDのみサポート。将来的にGROUP_GIFTING、CORPORATE_GIFTING、DIGITAL_GIFTINGなどの拡張が予定されています。
|
| giftMessage Type: GiftMessage |
ギフトトランザクションに関連するギフトメッセージ
|
| giftWrapDetails Type: GiftWrapDetails |
ギフトに選択されたギフトラッピングオプション
|
Enum: GiftType
| 値
|
説明
|
| STANDARD Type: string |
標準ギフトタイプ
|
Type: GiftMessage
| パラメータ
|
説明
|
| text (必須) Type: string |
購入者にギフトメッセージとして表示するテキストメッセージ。Buy Nowページで編集可能。事業者がBuy Nowページ上で入力させたい場合は空にすることも可能。
|
| limit Type: integer |
ギフトメッセージフィールドの最大文字数。最大許容値は200文字。デフォルト: 200。 注意: 文字数はUTF-16エンコーディングに基づいて計算されます。標準テキストは1文字、単一Unicodeコードポイントの絵文字は2文字、複雑な絵文字（スキントーン修飾子等）は3文字以上としてカウントされます。 |
Type: GiftWrapDetails
| パラメータ
|
説明
|
| availableGiftWrapOptions (必須) Type: List<GiftWrapOption> |
事業者が提供するギフトラッピングオプションのリスト。最大10個。
|
| selectedGiftWrapId Type: string |
購入者が選択したギフトラッピングID
|
Type: GiftWrapOption
| パラメータ
|
説明
|
| id (必須) Type: string |
このギフトラッピングの識別子
|
| name (必須) Type: string |
Amazon Payチェックアウトページに表示されるギフトラッピングの名前
|
| imageUrl (必須) Type: string |
Amazon Payチェックアウトページに表示されるギフトラッピング画像のURL
|
| giftWrapAmount (必須) Type: Price |
ギフトラッピングの合計金額
|
Type: GiftWrapOption (Event input)
| 属性 | タイプ | 説明 | 必須 | デフォルト |
| id | String | 選択されたギフトラッピングの識別子 | Yes | N/A |
| displayName | String | 選択されたギフトラッピングの名前 | Yes | N/A |
| amount | String | 選択されたギフトラッピングの金額 | Yes | N/A |
Type: GiftWrapSelection
onCompleteCheckoutイベントで購入者が選択したギフトラッピングの選択を返すために使用されます。
| パラメータ
|
説明
|
| selectedGiftWrapId Type: string |
購入者が選択したギフトラッピングID
|
| selectedGiftWrapAmount Type: Price |
選択されたギフトラッピングの金額
|
Enum: AddressDisplayType
| 値
|
説明
|
| SENDER_ADDRESS Type: string |
ギフトのユースケースでBuy Nowページに送り主の住所を表示する必要があるかどうかを示します。ギフト以外のユースケースでは、注文元の住所を示します。
|
