感谢您的访问。此页面目前仅提供英语版本。我们正在开发中文版本。谢谢您的理解。

Buy Now Checkout

You can let Amazon Pay handle the full checkout flow for one-time transactions and reduce buyer redirection via Buy Now. Unlike the one-time integration, the buyer will not need to return to your site to review their order before completing checkout. Everything is handled and provided on the Amazon Pay Buy Now hosted checkout page. During a checkout, Amazon Pay will invoke event handlers in your shop to exchange checkout-related information. This includes the address selected by the customer on the Amazon hosted checkout page for physical goods, coupon codes provided by the customer, if applicable. In return, your shop will respond to those operations with cartDetails. These include e.g. available delivery options, optional line item information to display to the buyer and order amounts.


Buy Now Checkout types

Type: BuyerAddtionalInfo

Parameter
Description
vatId
(required, if requested)

Type: string
VAT id for B2B invoice
province
(required, if requested)

Type: string
Buyer shipping address province
dateOfBirth
(required, if requested)

Type: string
DD/MM/YYYY
prefix
(required, if requested)

Type: string
Prefix of buyer name, Mr (Herr), Ms (Frau), other
SIRET
(required, if requested)

Type: string
SIRET number identifies both the business entity and its specific location
SIREN
(required, if requested)

Type: string
SIREN number identifies the business entity

Type: CartDetails

Parameter
Description
deliveryOptions
(required*)

Type: List of DeliveryOption
The delivery options available for the provided address.

*only required for `PayAndShip` in the onInitCheckout event handler.
totalShippingAmount
(required)

Type: Price
The total shipping costs.
totalBaseAmount
(required)

Type: Price
The total amount for items in the cart.
totalTaxAmount
(required)

Type: Price
The total tax amount for the order.
totalChargeAmount
(required)

Type: Price
The total amount for this transaction.
totalDiscountAmount

Type: Price
The total discount amount for the order.
totalOrderAmount
Type: Price
Total order amount for the transaction. Set this field when you plan to perform multiple authorization.
lineItems
Type: List of LineItem
Details of each item in cart.

Type: LineItem

Parameter
Description
id
(required)

Type: string
Item identifier
title
(required)

Type: string
Item title
quantity
(required)

Type: string
Quantity for this line item
listPrice
(required)

Type: Price
Individual original price for this line item
totalListPrice
(required)

Type: Price
Total original price for this line item (listPrice = listPrice * quantity)
variantTitle

Type: string
Title of the item variant. E.g. 'Cushion/Green/M'
discountedPrice

Type: Price
Total price for this line item after discounts

Type: DeliveryOption

Parameter
Description
id
(required)

Type: string
Delivery Option identifier
price
(required)

Type: Price
Total delivery cost
shippingMethod
(required)

Type: ShippingMethod
Shipping method details
isDefault
(required)

Type: boolean
Specifies if this delivery option is the default. Exactly one delivery option must be set as isDefault=true and rest should be set to false.
shippingEstimate

Type: List of EstimationDetails
Estimates for shipping (list of size 2, minimum and maximum time needed)
discountedPrice

Type: Price
Delivery costs after discounts
dateTimeWindow

Type: list<DateTimeWindowDetails>
Delivery costs after discounts

Type: ShippingMethod

Parameter
Description
shippingMethodName
(required)

Type: string
Name of the shipping method
shippingMethodCode
(required)

Type: string
Code of the shipping method

Type: EstimationDetails

Parameter
Description
timeUnit
(required)

Type: TimeUnit
The time unit of the estimation
value
(required)

Type: number
Value for this time unit

Enum: TimeUnit

Value
Description
MINUTE

Type: string
minutes
HOUR

Type: string
hours

Type: DateTimeWindowDetails

Parameter
Description
type
(required)

Type: DateTimeWindowDetails.Type
Date or Time type
value
(required)

Type: list<string>
Value of available date or time
defaultValue

Type: string
Value of default available date or time

Enum: DateTimeWindowDetails.Type

Value
Description
DATE

Type: string
Delivery date
TIME

Type: string
Delivery Time

Type: Scopes

Parameter
Description
buyer

Type: Buyer
Details about the buyer, such as their unique identifier, name, and email
billingAddress

Type: Address
Selected billing address
4.2.7.11 Place Order Response

Defines details for response sent when “Place Order” is clicked.

Parameter
Description
checkbox

Type: list<Checkbox>
Details about the buyer, such as their unique identifier, name, and email
freeForm

Type: string
Free form text entered by buyer
deliveryOptions

Type: list<DeliveryOption>
Delivery option preference from buyer

Enum: Checkbox

Defines checkboxes to be shown during checkout (optional, if not present then will not be shown. Up to 4 checkboxes max) in the CheckoutSessionConfig payload. Include the checkboxes you want in the CheckoutSessionConfig payload.

Value
Description
MERCHANT_DISCLOSURE

Type: string
Add checkbox to collect explicit agreement from buyer to your privacy policy and terms and conditions
MEMBERSHIP_SIGN_UP

Type: string
Add checkbox to ask buyer to sign up for your membership program
SMS_DELIVERY_NOTIFICATION

Type: string
Add checkbox to ask buyer to sign up for SMS delivery notifications to phone number associated to t heir Amazon account
NEWSLETTER_SIGN_UP

Type: string
Add checkbox to ask buyer to sign up to receive newsletter to email address associated to their Amazon account
RIGHT_OF_WITHDRAWL

Type: string
Add checkbox to collect explicit agreement from buyers to 'right of withdrawal' policy

Note: This feature is coming soon.

Type: ItemProperty

Defines additional attributes for item.

Attribute Type Description Required Default
name string Name of this property No N/A
value string Value of this property No N/A

Type: FreeForm

Attribute Type Description Required Default
placeholderText string Text field to show for free form placeholder Yes N/A
limit string Limit for free form field length No TBD

Type: Price

Parameter
Description
amount

Type: string
Transaction amount
currencyCode

Type: string
Transaction currency code in ISO 4217 format

Example: USD

Type: deliveryOption (event input)

Parameter
Description
id

Type: string
Delivery Option identifier
amount

Type: string
Total delivery cost amount
displayName

Type: string
Shipping method display name