Skip to main content
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 provide SDKs for web and React Native. For native iOS (Swift), Android (Kotlin), and Flutter, you can integrate directly.
Need an SDK for your platform? SDK support is expanding. Contact us if you need an SDK for iOS, Android, Flutter, 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 and React Native, the SDK is strongly recommended, but you can follow the guides 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