currency
you send in the request.items[]
to send:price
or aggregatePrice
.quantity
.taxInclusive
boolean dictates how prices are displayed in the checkout modal (the default value is false
). If you set taxInclusive
to true
, then the UI indicates that the total amount includes VAT.taxInclusive
also determines how we treat product prices when calculating tax.customerId
.taxIdentifiers[]
and payment sources[]
and present them as options in the checkout modal.customerId
you provided.options.addresses[]
to send Digital River this data.addresses[]
, the modal only displays name
and address
.POST/drop-in/checkout-sessions
throws the following error:shipFrom.address.country
at the line item-level and/or order-level.options.shippingMethods[]
. These are methods whose amount
and serviceLevel
are not dependent on where the checkout’s products are being shipped or how much they weigh.options
to send a shippingCalloutEndpoint
.POST/checkout/shipping-quotes
. The shippingCalloutEndpoint
you provide must be able to receive and handle this request and send a reply that adheres to the response contract.POST/drop-in/checkout-sessions
.createModal()
method.createModal()
is invoked, the Drop-in Checkout modal window opens and the onReady
event occurs.customerId
in the create checkout-session request, customers are given the option to save their shipping and billing information for use in future checkouts.options.addresses[]
in the create checkout-session request, then the modal has the capability to present these saved addresses to the customer. If the customer uses the radio button control to select one of them, its values are populated in the address collection form.onAddressComplete
triggers an event that contains the customer-submitted address
.description
and amount
.onDeliveryComplete
triggers an event that contains the customer’s selected shippingMethod
and its calculated taxAmount
.onCheckoutComplete
triggers an event that contains an order
object.id
) and display it to customers on a customized page.checkout_session.order.created
to trigger order fulfillment. Instead, listen for the order.accepted
event and use it to drive downstream fulfillment processes.data.object
, if shipTo.saveForLater
and/or billTo.saveForLater
are true
, then customers opted to save their shipping and/or billing information for use in future transactions. You can use this as a flag to trigger a method that updates the customer’s saved addresses in your system.options
can be used to stylize and localize the modal, as well as customize order confirmation notifications.style.modal
and style.textField
to alter the modal’s default logo, theme, borders, text fields, and fonts.language
to one of the following values:ar
cs
da
de
el
en-gb
en
en-us
es
es-419
fi
fr-ca
fr
hu
it
ja
ko
nl
no
pl
thankYouPage
from the request. To view an example of the modal, go to the Order confirmation stage section.thankYouPage
to none
.onReady
: The modal is loaded and ready for customer interaction.onAddressComplete
: The customer submitted address information. This function returns an address
that contains the customer’s billing
and shipping
data.onDeliveryComplete
: The customer submitted a shipping method choice. This function returns a shippingMethod
that contains the customer’s shipping method selection.onCheckoutComplete
: The customer successfully submitted the order. This function returns an order
.onClose
: The customer closed the modal.onError
: An error occurred during the checkout experience.status
that indicates the state of the modal
and the customer’s currentStep
in the experience:modal
status values:inactive
: The checkout-session identifier is created and the modal is initializedfailed
: The modal cannot be displayed to the customeraborted
: The customer closed the modalfinished
: The customer provided payment and submitted the order (i.e., Digital River associated the source with the checkout and created the order)currentStep
values: