Skip to main content
Every payment flow starts from the same two things: an authenticated customer (see Choose an onboarding path) and an executable quote. From there, you choose how much of the payment UI you want to own. Call getPaymentMethods() to see which methods are available for the customer right now, then pick the guide that matches your experience. Guest checkout removes the first requirement: new customers buy with Apple Pay before they have a MoonPay account, and verification steps up only when a purchase requires it.

Compare payment methods

Payment methodUI controlCoverageBest for
Apple PayHeadless frame renders the Apple Pay button; you own the rest of the UIDevices and regions where Apple Pay is availableSingle-tap checkout on Apple devices
Google PayHeadless frame renders the Google Pay button; you own the rest of the UIDevices and regions where Google Pay is availableSingle-tap checkout on devices that support Google Pay
CardYou build the purchase UI; the headless buy frame runs the pipeline and hosted frames handle card entryStored credit and debit cards; requires card payments enabled on your accountFull control over the purchase UI
Buy buttonYou supply a container; MoonPay renders the button, the payment-method picker, and the confirmation sheetApple Pay, Google Pay, or card, depending on what’s available to the customerFast, low-effort express checkout from a single button
WidgetMoonPay renders the entire buy flow inside an iframeAll payment methods and regions in the standard MoonPay integrationBroad payment coverage without building purchase UI
Every method can require a challenge when a transaction needs extra verification. You handle it the same way in each flow: render the Challenge frame at the URL you receive. See Handle challenges.

Payment guides

Guest checkout

Let new customers buy with Apple Pay before they have a MoonPay account.

Pay with Apple Pay

Let customers buy crypto headlessly with Apple Pay.

Pay with Google Pay

Let customers buy crypto headlessly with Google Pay.

Pay with card

Let customers buy crypto using stored credit and debit cards.

Pay with the buy button

Add a single express checkout button that handles payment-method selection and confirmation.

Pay with widget

Render the MoonPay-hosted buy widget for all payment methods and regions.

Handle challenges

Render the Challenge frame when a transaction needs extra verification.