Configuring payment methods on Breeze from client

Payment methods supported by Breeze

We support four payment methods for payments:

  • Apple Pay
  • Google Pay
  • Manual Card Payment
  • Crypto

Specifying a preferred payment method on Breeze

By default we will show all the possible payment methods as long as the browser support it.

You can control which payment methods are shown by adding the URL parameter preferred_payment_methods to the Breeze checkout link.

For example, after creating a payment page, the returned URL is: pay.breeze.cash/page_xxx/pcs_xxx/web

If you want to allow Apple Pay only, append: ?preferred_payment_methods=apple_pay

Final redirection URL: pay.breeze.cash/page_xxx/pcs_xxx/web?preferred_payment_methods=apple_pay

Enum values for specifying payment methods

  • Apple Pay: apple_pay
  • Google Pay: google_pay
  • Card (Manual Card Payment): card
  • Crypto : crypto

You can also specify multiple payment methods by joining values with commas:

?preferred_payment_methods=apple_pay,card (This will show Manual Card Payment and Apple Pay)

Note: If the specified payment method is unavailable in the user's environment, the payment page will silently fall back to showing all available methods. No error is returned.

Payment methods requiring account enablement

Some payment methods are not available by default and must be enabled on your Breeze account before they appear on the payment page.

MethodAvailable by defaultHow to enable
Card (manual card payment)Yes
Google PayYes
Apple PayNoEmail [email protected] — requires domain certification for each domain where the iframe is embedded
CryptoNoContact [email protected] to enable for your account

Note: Even after account-level enablement, Apple Pay and Google Pay only appear when the customer's browser and device support them (see Scenarios where Apple Pay is supported).

Scenarios where Apple Pay is supported

Apple Pay is supported in the following scenarios:

  • Any browser on iPhone
  • Safari on macOS