Ramps
Sign in

Quickstart

Quickstart · React Native non-custodial

WebView widget, native SPL signing bridge, and a sandbox reference number in about 20 minutes.

~20 minReact NativeUSDC

Quickstart · React Native non-custodial (Solana / USDC)

Time: about 20 minutes · Success: WebView loads the widget; native code signs an SPL transfer and posts success back; sandbox returns a reference number.

Before you start

  • Request access for sandbox API keys or Sign in if you already have a partner account
  • Sandbox keys from the partner portal after onboarding
  • React Native app with a WebView
  • Ability to sign Solana SPL transfers in native/JS (wallet adapter or your signer)

Wrong track? Custodial RN → RN custodial Quickstart. Web → Web Quickstart.

1. Server session endpoint

Same rule as Web: secret key stays on the server. Your app calls your backend; the backend calls MoneyGram POST /v1/sessions.

2. Load the widget in a WebView

Pass the session / config into the WebView (see full guide for the RAMPS_CONFIG / postMessage contract). Handle:

  • Sign request from the widget → sign SPL USDC in the app → post signature / success back
  • Complete / error events → update your UI
TypeScript
// Sketch: see full guide for message typeswebviewRef.current?.postMessage(  JSON.stringify({ type: 'RAMPS_SIGN_SUCCESS', payload: { signature } }),)

3. What success looks like

  • WebView opens MoneyGram UI without blank-screen / cookie issues
  • Sign request reaches native code with deposit address + amount
  • App returns success; widget shows sandbox reference number

4. Go deeper