Expo 模板

GitHub Repository

完整的 Expo + React Native + Dodo Payments 样板

概述

一个适用于将 Dodo Payments 集成到 Expo/React Native 应用程序的生产就绪模板。该模板包括结账会话创建、支付处理和适当的 TypeScript 配置，帮助您快速开始在移动应用中接受支付。

该样板使用 Expo SDK 和 TypeScript，并包含用于结账会话和支付处理的示例实现。

先决条件

Node.js 18+
Expo CLI 或 EAS CLI
Dodo Payments 账户（来自仪表板的 API 密钥）
iOS 模拟器或 Android 模拟器（或物理设备）

快速开始

Clone the Repository

克隆样板仓库并进入项目目录：

git clone https://github.com/dodopayments/expo-boilerplate.git
cd expo-boilerplate

Get Your API Credentials

在测试模式下从 Dodo Payments 仪表板获取凭证：

API 密钥：在您的仪表板中导航到 开发者 → API 密钥

从测试模式开始，安全地测试集成而无需处理真实支付。

Configure Environment Variables

在根目录下创建 .env 文件：

touch .env

添加您的 Dodo Payments 凭据：

.env

EXPO_PUBLIC_DODO_API_KEY=your_test_api_key_here

切勿将 .env 文件提交到版本控制中。它已经包含在 .gitignore 中。

EXPO_PUBLIC_* 变量会嵌入已发布的 JavaScript bundle 中，任何下载你应用的人都可以读取这些变量。Dodo Payments API keys 属于 bearer secrets，因此开发时只能使用 Test Mode key。在生产环境中，请在后端创建 checkout sessions，然后仅将生成的 checkout_url 传递给应用 — 参见 Mobile Integration。

Install Dependencies

安装所需的 npm packages：

npm install

Start the Development Server

启动 Expo development server：

npx expo start

使用设备上的 Expo Go app 扫描 QR code，或按 i 启动 iOS simulator，按 a 启动 Android emulator。

现在可以开始构建了！boilerplate 包含示例 screens 和 components，可帮助你了解集成方式。

包含的内容

boilerplate 已预先配置好以下必备内容：

Checkout Integration

用于创建和处理 checkout sessions 的示例实现

Payment Handling

包含成功和错误处理的完整 payment flow

TypeScript Support

包含适当 type definitions 的完整 TypeScript configuration

Expo Router

使用 Expo Router 的 navigation setup，实现无缝 routing

项目结构

expo-boilerplate/
├── app/
│   ├── (tabs)/
│   │   └── index.tsx          # Home screen with examples
│   └── checkout.tsx           # Checkout screen
├── components/
│   └── PaymentButton.tsx      # Payment button component
├── lib/
│   └── dodo.ts                # Dodo Payments client setup
├── .env.example               # Environment variables template
└── package.json

后续步骤

运行 boilerplate 后：

Create Your Products

在你的 Dodo Payments dashboard 中添加 products，以启用 checkout 功能。

Customize the Integration

根据应用的需求和设计调整示例代码。

Test on Real Devices

在实体设备上测试 payment flow，确保一切正常运行。

Go Live

准备就绪后，切换到 Live Mode API keys 并构建用于生产环境的应用。

构建生产版本

Install EAS CLI

npm install -g eas-cli

Configure EAS

eas build:configure

Build Your App

iOS：

eas build --platform ios

Android：

eas build --platform android

其他资源

Mobile Integration Guide

在移动应用中实现 payments 的详细指南

Integration Guide

实现 one-time payments 的详细指南

API Reference

探索完整的 Dodo Payments API documentation

支持

需要有关 boilerplate 的帮助？

加入我们的 Discord community，参与提问和讨论
查看 GitHub repository，了解问题和更新
联系我们的 support team 获取帮助

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

GitHub Repository

概述

先决条件

快速开始

包含的内容

Checkout Integration

Payment Handling

TypeScript Support

Expo Router

项目结构

后续步骤

构建生产版本

其他资源

Mobile Integration Guide

Integration Guide

API Reference

支持

GitHub Repository

​概述

​先决条件

​快速开始

​包含的内容

Checkout Integration

Payment Handling

TypeScript Support

Expo Router

​项目结构

​后续步骤

​构建生产版本

​其他资源

Mobile Integration Guide

Integration Guide

API Reference

​支持

概述

先决条件

快速开始

包含的内容

项目结构

后续步骤

构建生产版本

其他资源

支持