Installment payment methods
Amazon Pay offers multiple installment payment options. Some installment payment methods require activation in Seller Central while others are available as soon as you make the required integration update. Follow these steps to enable installment payment methods for your buyers:
- Review payment method requirements to determine which installment payment methods are available in your region and whether they need to be activated. If the payment method requires activation, make sure your integration pattern is supported before visiting Seller Central to sign up with the installment payment provider.
- Follow the instructions below to send Amazon Pay the estimated order amount for the transaction. You can either set the value when the Amazon Pay button is rendered and any time that estimate changes after the button render or you can set it at time of button click. Amazon Pay will use the estimated order amount to determine whether the order meets the installment provider’s minimum order price threshold. If the order does not meet the minimum amount, the buyer will not see the installment payment method in their Amazon wallet.
- 1. Payment method requirements
- 2. Setting the estimated order amount on button render
- 3. Updating the estimated order amount
- 4. Setting the estimated order amount on button click (alternative option)
- 5. UX best practices
1. Payment method requirements
Make sure your integration pattern is supported before you enable Affirm or Barclays.
|
|
Affirm
|
Barclays
|
Cofidis
|
Pay by Invoice
|
| Amazon Pay region
|
US only
|
DE only
|
FR/ES only
|
DE only
|
| Requires payment method activation
|
Yes
|
Yes
|
No
|
No
|
| Supports one-time checkout
|
Yes
|
Yes
|
Yes
|
Yes
|
| Supports recurring checkout
|
No
|
No
|
No
|
No
|
| Supports one-time checkout additional button integration
|
No
|
No
|
Yes
|
Yes
|
| Supports multi-ship (multiple authorizations and captures per order)
|
No
|
Yes
|
No
|
Yes
|
| Supports digital orders (productType = payOnly)
|
No
|
Yes
|
Yes
|
No
|
| Order minimum
|
$50 USD
|
€100
|
€60 (4xCB, Paga en 4), €45 (Option Credit, Credit Line)
|
€1
|
2. Setting the estimated order amount on button render
Use the estimatedOrderAmount button parameter to set the estimated order amount for the transaction. You must create a local reference of the button to update the estimatedOrderAmount in the next step. The amount value should not contain commas or spaces. You should use decimals to indicate a fractional amount if applicable (for example, “3.99” USD to represent 3 dollars and 99 cents). Amazon Pay will still render the button while throwing a non-blocking console error if the amount value provided is invalid.
3. Updating the estimated order amount
Use updateButtonInfo() to update the estimatedOrderAmount if the estimated order amount changes; for example, if the buyer removes or adds something to their cart. This function may update the button UI and the new estimatedOrderAmount will be used to determine whether the order meets the installment provider’s minimum order price threshold.
<script type="text/javascript" charset="utf-8">
amazonPayButton.updateButtonInfo({"amount":"120.99","currencyCode":"USD"});
</script>
4. Setting the estimated order amount on button click (alternative option)
If you decoupled button render and checkout initialization, you can set estimatedOrderAmount at time of button click instead of setting it on button render using the following code:
5. UX best practices
Display the paymentDescriptor value returned in the Get Checkout Session response if you’ve implemented the standard 2-step checkout flow to inform the buyer that they will be redirected to the installment provider to complete their transaction.
For Affirm-enabled merchants - Use the checkoutButtonText value returned in the Get Checkout Session response as the text on the "Place order" button to inform the buyer that they will be redirected to the Affirm page to complete their transaction. With this change, the button will say- "Continue to Affirm" instead of "Place order"