Payment Methods

Neon supports a wide variety of payment methods across different countries to provide the best payment experience for your customers.

Available Payment Methods

Global & Regional Methods

Payment Method	Webhook Name [1]	Preselection Name [2]	Available Countries
Credit/Debit Cards	`credit_card`, `debit_card`, `unknown_card` [3]	`debit_or_credit_card`	all countries
Apple Pay	`apple_pay`		AE, AT, AU, BE, BG, CA, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HK, HR, HU, ID, IE, IT, JP, KR, LT, LU, LV, MT, MY, NL, NO, NZ, OM, PH, PL, PT, RO, SE, SG, SI, SK, TH, US
Google Pay	`google_pay`		AE, AT, AU, BE, BG, CA, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HK, HR, HU, ID, IE, IT, JP, KR, LT, LU, LV, MT, MY, NL, NO, NZ, OM, PH, PL, PT, RO, SE, SG, SI, SK, TH, US
PayPal	`paypal`		AT, AU, BH, BE, BG, BR, CA, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GH, GR, HK, HR, HU, IL, IT, JO, JP, KW, LT, LU, LV, MT, MX, MY, NL, NO, NZ, OM, PH, PL, PT, SG, SI, SK, TH, TW, US, ZA
SEPA Direct Debit	`sepa`	`sepa_direct_debit`	AT, BE, BG, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, HU, IE, IT, LT, LU, LV, MT, NL, NO, PL, PT, RO, SE, SI, SK
Paysafecard [4]	`paysafecard`		AT, BE, BG, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, HU, IE, IT, LT, LU, LV, MT, NL, NO, PL, PT, RO, SE, SK

[1] The name of the payment method used in the purchase.completed webhook. Same as the query parameter name if unspecified.

[2] The name of the payment method used when preselecting a payment method (see below).

[3] We return a more specific value to indicate the funding source (credit, debit, prepaid, or unknown) after the purchase completes.

[4] Requires approval; reach out to us to enable.

Country-Specific Methods

Payment Method	Webhook Name	Preselection Field Name	Country
PIX	`pix`		BR
Boleto	`boleto`		BR
MODO*	`modo`		AR
OXXO	`oxxo`		MX
OVO*	`ovo`		ID
DANA*	`dana`		ID
GrabPay	`grabpay`		MY
iDEAL	`ideal`		NL
Bancontact	`bancontact`		BE
EPS	`eps`		AT
WeChat Pay	`wechat_pay`		CN
Alipay**	`alipay`		CN
Naver Pay	`naver_pay`	`naverpay`	KR
Kakao Pay	`kakao_pay`	`kakaopay`	KR
Toss**	`toss`	`toss_pay`	KR
Samsung Pay	`samsung_pay`		KR
Przelewy24	`przelewy24`		PL
BLIK**	`blik`		PL
UPI	`upi`		IN
Cash App Pay	`cash_app_pay`		US
Klarna	`klarna`		US

[*] In beta; reach out to us to test these methods out.

[**] Requires approval; reach out to us to enable.

Payment Method Preselection

When a customer opens your checkout page, Neon automatically selects a default payment method based on several factors to create the best user experience.

Selection Priority

Neon uses the following priority order to preselect a payment method:

URL Query Parameter (highest priority)
- Force a specific payment method by passing in defaultPaymentMethod when calling POST /checkout or POST /client/createCheckout
Last Used Payment Method
- If the customer previously attempted this checkout, their last selected method is remembered
- Only applies if that payment method is still available
Saved Cards: if the customer is logged in and has saved credit/debit cards, the card payment method is preselected
Apple Pay, if available on the customer's device and enabled for the checkout country
Google Pay, if available on the customer's device AND the customer has a saved payment method in Google Pay

If none of the above apply, no payment method is preselected and the customer must choose on

Country-Specific Ordering

The order payment methods appear differs by country to match local preferences:

South Korea: Cards, Samsung Pay, Kakao Pay, Naver Pay, Toss
India: UPI, Cards
Poland: BLIK, Cards, Paysafecard, PayPal, Apple Pay, Google Pay
All other countries: Cards, PayPal, Apple Pay, Google Pay, then regional methods

Redirect-Based Payment Methods

Some payment methods require redirecting the customer to an external payment provider's website to complete authentication and authorization. After the customer completes the payment flow on the provider's site, they are redirected back to your checkout.

The following payment methods are redirect-based:

European Methods:

iDEAL (Netherlands)
Bancontact (Belgium)
Przelewy24 (Poland)
EPS (Austria)
SEPA Direct Debit (Europe)
BLIK (Poland)

Asian Methods:

Alipay (China)
WeChat Pay (China)
Kakao Pay (South Korea)
Naver Pay (South Korea)
Samsung Pay (South Korea)
Toss (South Korea)

Latin American Methods:

PIX (Brazil)
Boleto (Brazil)
OXXO (Mexico)
MODO (Argentina)

Other Methods:

PayPal
Paysafecard (Europe)
Klarna (US)
Cash App Pay (US)
GrabPay (Malaysia)
OVO (Indonesia)
DANA (Indonesia)

How Redirect URLs Work

When a customer submits a redirect-based payment:

Payment initiated: Customer submits payment information on your checkout
Redirect URL returned: Neon's backend receives a redirect URL from the payment provider
Customer redirected: Customer is sent to the payment provider's website
Authentication: Customer authenticates/authorizes the payment on the provider's site
Return to checkout: Provider redirects the customer back to your checkout
Completion: Checkout polls for payment status and shows the final result

Return URLs for Embedded Checkouts

📘
This section only applies to embedded checkouts. If you're not using our iframe checkout, you can skip this section.

If you're using embedded checkout (checkout displayed in an iframe), you can provide a returnUrl when creating the checkout. This URL is used specifically for redirect-based payments.

How it works:

When a redirect payment completes (success or failure), the customer is redirected to your returnUrl
The checkoutId is automatically appended as a query parameter: {returnUrl}?checkoutId={checkoutId}
Your application can use the checkoutId to reload the checkout

For more, see Embedded Checkout.

Note: The returnUrl only applies to embedded checkouts. Hosted checkouts (full-page) handle redirects automatically within the checkout flow.