React Native Payments

Version: 0.1.9 | Platform: iOS 13.0+ | React Native: >= 0.71

A drop-in payment SDK for React Native that provides a native SwiftUI checkout experience with card payments, 3-D Secure support, and theming.

Quick Start

1. Install

2. Create Session (Backend)

3. Integrate in React Native

Prerequisites

Requirement	Version
Node.js	>= 16.x
React Native	>= 0.71
iOS Deployment Target	13.0+
Xcode	14.0+
CocoaPods	Latest
Swift	5.7+

Required Credentials

Credential	Description
`api_key`	Server-side API key (contact Datman support)
`merchant_id`	Your merchant identifier (provided during onboarding)

⚠️ The api_key is server-side only. Never expose it in client-side code.

Installation

Step 1: Install Package

Step 2: Install iOS Dependencies

Step 3: Configure Podfile (if needed)

If autolinking is restricted, manually add the pod:

Step 4: Xcode Configuration

Open the .xcworkspace file and verify:

Other Linker Flags contains $(inherited) and -ObjC

Step 5: Verify

Client SDK API

`setup(options?)`

Optional one-time configuration on app boot.

Parameter	Type	Required	Description
`options.baseUrl`	`string`	No	Override default API base URL
`options.apiKey`	`string`	No	Public API key
`options.brandColorHex`	`string`	No	Brand color hex (e.g., `#0A84FF`)
`options.logoUrl`	`string`	No	URL to your brand logo

`configure(sessionId)`

Configure SDK with a session ID from /create-session.

Throws if sessionId is empty or invalid.

`open()`

Open the native checkout sheet. Must call configure() first.

OpenResult:

Payment Flow

Theming

Logo recommendations: Square format, ~28px display height, PNG/JPEG/WebP, hosted on a CDN.

Dark mode: Automatically adapts to host app's appearance settings — no configuration needed.

Security

Aspect	Implementation
PAN/CVV Processing	Handled exclusively in native code
Data Storage	No sensitive data in JavaScript layer
Network	Direct to gateway, SSL/TLS encrypted
Logging	No sensitive fields logged

Best Practices

Never log card details in your application

Use HTTPS for all webhook endpoints

Validate webhook signatures on your backend

Sessions are single-use and expire after a set time

Implement proper error handling for failed payments

Troubleshooting

"Native module not found"

Run npx pod-install

Open .xcworkspace (not .xcodeproj)

Verify with grep RNDatman ios/Podfile.lock

Ensure -ObjC is in Other Linker Flags

"Calling into SwiftUI on a non-main thread" (Simulator)

Update to latest SDK version

Clean build: Xcode → Product → Clean Build Folder

Session Invalid or Expired

Create sessions fresh before each payment

Sessions are single-use — create a new one for retries

Support

Email: ios@datmanpay.com

Include: SDK version, RN version, iOS version, error messages, and reproduction steps

Quick Start#

1. Install#

2. Create Session (Backend)#

3. Integrate in React Native#

Prerequisites#

Required Credentials#

Installation#

Step 1: Install Package#

Step 2: Install iOS Dependencies#

Step 3: Configure Podfile (if needed)#

Step 4: Xcode Configuration#

Step 5: Verify#

Client SDK API#

setup(options?)#

configure(sessionId)#

open()#

Payment Flow#

Theming#

Security#

Best Practices#

Troubleshooting#

"Native module not found"#

"Calling into SwiftUI on a non-main thread" (Simulator)#

Session Invalid or Expired#

Support#