Paddle Billing
Search

Get available payment methods when previewing prices or transactions

See which payment methods are valid for the prices and location passed to a price preview or a transaction preview.

What's new?

We added a new available_payment_methods array to transaction preview and pricing preview responses from the API.

available_payment_methodsarray[string]

List of available payment methods for Paddle Checkout given the price and location information passed.

How it works

Paddle lets you accept cards, digital wallets like Apple Pay and Google Pay, and local payment methods like iDEAL and Alipay out-of-the-box. You can turn on new payment methods in a couple of clicks in the Paddle dashboard, with no need to sign up for multiple merchant accounts or partner with different platforms.

Some payment methods are only available for certain countries or currencies, and for certain kinds of products. Paddle Checkout automatically presents valid payment methods for a transaction at checkout, so you don't need to handle this.

The new available_payment_methods array in transaction preview and pricing preview responses returns available payment methods for a transaction, letting you present this to customers in your frontend before they buy.

Paddle.PricePreview() returns a pricing preview object, so available_payment_methods is available when previewing prices using Paddle.js, too.

Summary of changes

Responses

This is a summary of the changes to fields for responses in the Paddle API:

FieldChange
transaction_preview.available_payment_methodsNew field
pricing_preview.available_payment_methodsNew field

Next steps

This change is available in version 1 of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

Learn more