Skip to main content
This integration is currently in preview and subject to change.
To integrate the headless ramp, you will need:
  • A partner account and API credentials
  • A frontend (web or mobile) app
  • If you’re using the SDK, ensure it’s installed
  • A server for sending requests to MoonPay and receiving webhooks
During the preview, we will work with you directly to set up your account and credentials.

Integrating on the web

Content Security Policy

If you embed MoonPay frames on the web, your Content Security Policy (CSP) must allow MoonPay’s iframes and network calls. Your CSP should include at least the following rules:
Content-Security-Policy: frame-src https://*.moonpay.com/; connect-src https://*.moonpay.com/;

Configuration

Domain settings

When integrating MoonPay on the web, provide your app’s origin per environment. This allows MoonPay to embed frames securely.

Apple Pay

To use Apple Pay on the web, you must complete Apple’s domain verification to prove ownership of your site. This is currently a manual process.

Integrating in mobile apps

WebViews

This integration supports using WKWebView on iOS and WebView on Android. When using WKWebview on iOS you will need to set allowsInlineMediaPlayback to true for the Connect frame.