--- title: Buy Now Checkout url: ja/amazon-pay-api-v2/ja-buy-now-checkout.html --- Amazon PayにOneTime決済における全チェックアウトフローを処理させ、Buy Now経由の購入者のリダイレクトを削減ことができます。OneTimeのインテグレーションとは異なり、購入者はチェックアウトを完了する前に注文を確認するために事業者サイトに戻る必要はありません。全てはAmazon PayのBuy Nowがホストするチェックアウトページで処理され、提供されます。チェックアウト中にAmazon Payは事業者のイベントハンドラを呼び出し、チェックアウト関連情報を交換します。これには配送を伴う商品のAmazonホスティングチェックアウトページで顧客が選択した住所、顧客が提供したクーポンコード（該当する場合）などが含まれます。事業者はこれらの操作に対して `cartDetails` で応答します。これらには、例えば利用可能な配送オプション、購入者に表示するオプションの商品情報、注文金額などが含まれます。 --- * TOC {:toc} {::options toc_levels="3,4" /} ### 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ページに送り主の住所を表示する必要があるかどうかを示します。ギフト以外のユースケースでは、注文元の住所を示します。