configuration
object. The object contains both required and optional values.sessionId
checkout
flowmanagePaymentMethods
flowsessionId
is required if you are using Drop-in Payments within a cart flow. If you are using Drop-in Paymentsn to capture payment details on a customer portal, then the sessionId
is not required.billingAddress
billingAddress.firstName
billingAddress.lastName
billingAddress.email
billingAddress.organization
billingAddress.phoneNumber
billingAddress.address.line1
billingAddress.address.line2
billingAddress.address.city
billingAddress.address.state
billingAddress.address.postalCode
billingAddress.address.country
billingAddress.address.additional AddressInfo
paymentMethodConfiguration
Source
object.createDropin()
function.showSavePaymentAgreement
option when configuring Drop-in Payments.onSuccess
event returns the readyForStorage
value.readyForStorage
identifier signifies the creation of the source with the intention of storage, and any necessary authentications have occurred. To reuse the source, attach it to a Shopper by calling the appropriate API with your secret key.sessionId
in your configuration object. Instead, you should provide a flow variable that tells Drop-in Payments you are collecting details for future use.onSuccess
event will return this information with a "readyForStorage": true
parameter.readyForStorage
identifier signifies the creation of the source with the intention of storage, and any necessary authentications have occurred. To reuse the source, attach it to a Shopper by calling the appropriate API with your secret key.flow
managePaymentMethods
flow
checkout
showSavePaymentAgreement
true
showSavePaymentAgreement
false
showComplianceSection
true
showComplianceSection
false
button
type
as well as a custom buttonText
attribute.showTermsOfSaleDisclosure
true
showTermsOfSaleDisclosure
false
redirect
disableAutomaticRedirects
attribute if you do not want Drop-in Payments to redirect your customer to the payment provider. Use this setting in your checkout flow if you do not want to create the order from Drop-in Payments. In this scenario, you can allow your customer to choose their payment method, review and then authorize it later by redirecting the customer to the redirect.returnUrl
when the customer has reviewed the order totals and is ready to create their order.disableAutomaticRedirects
returnUrl
cancelUrl
locale
you used when initializing DigitalRiver.js.continue
(default)"options": {
"button": {
"type": "continue"
}
}
payNow
"options": {
"button": {
"type": "payNow"
}
}
buyNow
"options": {
"button": {
"type": "buyNow"
}
}
completeOrder
"options": {
"button": {
"type": "completeOrder"
}
}
submitOrder
"options": {
"button": {
"type": "submitOrder"
}
}
custom
buttonText
to create a button with customized text:"options": {
"button": {
type": "custom".
"buttonText": "Custom Text For Button"
}
}
usage
value you select should be the one that most closely corresponds to your business model. The available options are subscription, convenience, and unscheduled.usage
to subscription
when you create sources that are used primarily for recurring transactions, made at regular intervals for a product or a service.convenience
setting applies mainly to saved payment sources that are used for one-off transactions. These are sources where customers are typically present during the checkout flow and want to quickly access their payment information. Select this option if you don't offer subscriptions or don't have unscheduled merchant initiated transactionsusage
to unscheduled
when you create sources for unscheduled merchant initiated transactions. These are contracts that occur on a non-fixed schedule using saved card information. Automatic top-ups are an example of one such transaction. They occur whenever a customer's balance drops below a pre-defined amount.cardNumberPlaceholderText
cardNumberPlaceholderText
, localization will not be applied.cardExpirationPlaceholderText
cardExpirationPlaceholderText
, localization will not be applied.cardCvvPlacholderText
cardCvvPlacholderText
, localization will not be applied.mask
placeholderText
style
source
readyForStorage
"paymentMethodTypes"
array of the available payment methods.