Skip to main content

GitHub Repository

Boilerplate đầy đủ Expo + React Native + Dodo Payments

Tổng quan

Một mẫu sẵn sàng cho sản xuất để tích hợp Dodo Payments vào các ứng dụng Expo/React Native. Mẫu này bao gồm việc tạo phiên thanh toán, xử lý thanh toán và cấu hình TypeScript phù hợp để giúp bạn bắt đầu chấp nhận thanh toán trong ứng dụng di động của mình một cách nhanh chóng.
Boilerplate này sử dụng Expo SDK cùng TypeScript và bao gồm các ví dụ triển khai cho phiên thanh toán và xử lý thanh toán.

Điều kiện tiên quyết

  • Node.js 18+
  • Expo CLI hoặc EAS CLI
  • Tài khoản Dodo Payments (khóa API từ bảng điều khiển)
  • Trình giả lập iOS hoặc Android (hoặc thiết bị vật lý)

Bắt đầu nhanh

1

Clone the Repository

Sao chép kho boilerplate và chuyển vào thư mục dự án:
2

Get Your API Credentials

Lấy thông tin đăng nhập từ bảng điều khiển Dodo Payments ở Chế độ Kiểm tra:
Bắt đầu với Chế độ Kiểm tra để thử nghiệm tích hợp một cách an toàn mà không xử lý thanh toán thật.
3

Configure Environment Variables

Tạo một tập tin .env trong thư mục gốc:
Thêm thông tin xác thực Dodo Payments của bạn:
.env
Không bao giờ commit tệp .env của bạn vào hệ thống quản lý phiên bản. Tệp này đã được bao gồm trong .gitignore.
Các biến EXPO_PUBLIC_* được nhúng trong JavaScript bundle đã phát hành và bất kỳ ai tải ứng dụng của bạn xuống cũng có thể đọc được. Dodo Payments API keys là các bearer secret, vì vậy chỉ sử dụng khóa này với Test Mode trong quá trình phát triển. Đối với production, hãy tạo checkout sessions trên backend và chỉ truyền checkout_url tương ứng vào ứng dụng — xem Mobile Integration.
4

Install Dependencies

Cài đặt các npm package bắt buộc:
5

Start the Development Server

Khởi động development server của Expo:
Quét mã QR bằng ứng dụng Expo Go trên thiết bị của bạn hoặc nhấn i cho iOS simulator hoặc a cho Android emulator.
Bạn đã sẵn sàng bắt đầu xây dựng! Boilerplate bao gồm các màn hình và component mẫu giúp bạn hiểu cách tích hợp.

Bao gồm những gì

Boilerplate đi kèm các thành phần thiết yếu được cấu hình sẵn:

Checkout Integration

Triển khai mẫu để tạo và xử lý checkout sessions

Payment Handling

Quy trình thanh toán hoàn chỉnh với xử lý thành công và lỗi

TypeScript Support

Cấu hình TypeScript đầy đủ với các định nghĩa kiểu phù hợp

Expo Router

Thiết lập điều hướng với Expo Router để routing liền mạch

Cấu trúc dự án

Các bước tiếp theo

Sau khi boilerplate đã chạy:
1

Create Your Products

Thêm sản phẩm trong Dodo Payments dashboard để bật chức năng checkout.
2

Customize the Integration

Điều chỉnh mã mẫu để phù hợp với nhu cầu và thiết kế của ứng dụng.
3

Test on Real Devices

Kiểm thử quy trình thanh toán trên các thiết bị thực tế để đảm bảo mọi thứ hoạt động chính xác.
4

Go Live

Khi đã sẵn sàng, chuyển sang Live Mode API keys và build ứng dụng cho production.

Build cho production

1

Install EAS CLI

2

Configure EAS

3

Build Your App

Đối với iOS:
Đối với Android:

Tài nguyên bổ sung

Mobile Integration Guide

Hướng dẫn chi tiết về cách triển khai thanh toán trong ứng dụng di động

Integration Guide

Hướng dẫn chi tiết về cách triển khai thanh toán một lần

API Reference

Khám phá tài liệu đầy đủ về Dodo Payments API

Hỗ trợ

Bạn cần trợ giúp với boilerplate?
  • Tham gia Discord community của chúng tôi để đặt câu hỏi và thảo luận
  • Kiểm tra GitHub repository để xem các vấn đề và thông tin cập nhật
  • Liên hệ support team của chúng tôi để được hỗ trợ
Lần sửa đổi cuối 17 tháng 8, 2026