Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dev.moonpay.com/llms.txt

Use this file to discover all available pages before exploring further.

The MoonPay SDK handles frame lifecycle, postMessage communication, and encryption automatically. If you’re building for a platform where the SDK isn’t available or you prefer a direct integration, use the guides in this section. Before you start, familiarize yourself with how frames work in this integration including their lifecycle, messaging patterns, and events.

When to integrate manually

You should integrate manually when:
  • You prefer not to bundle third-party SDKs. If your application has strict requirements around third-party dependencies, you can integrate directly using platform-standard protocols and APIs.
  • You’re building for a platform without SDK support. We currently only provide an SDK for web. For native iOS (Swift), Android (Kotlin), and React Native, you can integrate directly.
Need an SDK for your platform? SDK support is expanding. Contact us if you need an SDK for iOS, Android, React Native, or another platform.

Platform guides

The guides below are reference implementations, not production-ready starter projects. They illustrate the messaging protocol, encryption flow, and frame lifecycle for each platform. Review and adapt the code to fit your app’s architecture, error handling, and security requirements before shipping. For web, the SDK is strongly recommended, but you can follow the guide below for a direct integration. Check out the platform-specific guides:

Web

Use iframes in desktop and mobile browsers

React Native

Use react-native-webview

iOS

Use WKWebView in Swift

Android

Use WebView in Kotlin