Skip to main content
SDK máy chủ Dodo Payments chính thức có sẵn cho chín ngôn ngữ. Các SDK checkout riêng biệt mở checkout được host từ ứng dụng Android, iOS, React Native và Flutter.

TypeScript

SDK type-safe cho Node.js với API dựa trên promise và phân trang tự động.

Python

Giao diện theo phong cách Python với hỗ trợ async/await cho Python 3.9+.

Go

Giao diện Go idiomatic với hỗ trợ context và kiểu dữ liệu chặt chẽ.

PHP

SDK tuân thủ PSR-4 cho PHP 8.1+.

Java

SDK an toàn luồng cho Java 8+ với hỗ trợ Maven và Gradle.

Kotlin

SDK Kotlin với coroutines và tính an toàn null.

C#

SDK type-safe cho .NET Standard 2.0+ với API dựa trên async Task.

Ruby

SDK Ruby tuân theo các quy ước của Ruby.

Rust

SDK ưu tiên async, được xây dựng trên Tokio và reqwest cho Rust 1.75+.

Bắt đầu nhanh

1

Install the SDK

Cài đặt SDK cho ngôn ngữ của bạn bằng trình quản lý gói tương ứng.
Để xem tọa độ Maven và các tùy chọn dành riêng cho từng phiên bản, hãy xem trang của từng SDK.
2

Initialize the Client

Đọc API key từ biến môi trường DODO_PAYMENTS_API_KEY. Các ví dụ kết nối với test mode; xem Test Mode và Live Mode.
Đối với Java, Kotlin, C# và Ruby, hãy xem phần thiết lập client trên trang của từng SDK.
Lưu API key trong biến môi trường hoặc trình quản lý secrets. Không bao giờ commit chúng vào hệ thống quản lý phiên bản.
3

Create a Checkout Session

Tạo một checkout session và chuyển hướng khách hàng đến checkout_url được trả về.
Để xem cùng lệnh gọi này trong các ngôn ngữ khác, cũng như payment links và webhooks, hãy xem Integration Guide.

Tính năng chính

Tất cả SDK backend đều bao gồm:
  • Type Safety: Kiểu dữ liệu chặt chẽ để đảm bảo an toàn tại thời điểm biên dịch và hỗ trợ IDE tốt hơn.
  • Error Handling: Các lỗi có kiểu dữ liệu, cung cấp HTTP status và nội dung lỗi mà API trả về.
  • Authentication: Xác thực bằng API key, được đọc từ một biến môi trường.
  • Async Support: Các mẫu async/await hiện đại khi phù hợp.
  • Auto-Pagination: Tự động phân trang cho các phản hồi dạng danh sách.
  • Usage Events: Các phương thức gửi usage events cho việc tính phí dựa trên mức sử dụng.
  • Test Mode: Một thiết lập trỏ client đến test mode, để không có tiền thật được chuyển.

Mobile Checkout SDKs

Đối với các ứng dụng Android native, iOS, React Native và Flutter, hãy sử dụng mobile checkout SDKs. Các SDK này mở trang checkout do Dodo lưu trữ trong trình duyệt thực của nền tảng (không phải WebView), vì vậy Apple Pay và Google Pay hoạt động giống như trên web mở. Cả bốn mobile SDK đều dùng chung một contract: start(...) trả về một CheckoutResult có kiểu dữ liệu, không SDK nào giữ API key và chúng không bao giờ gọi API trực tiếp.

Android

SDK Kotlin mở một Chrome Custom Tab. Yêu cầu minSdk 23.

iOS

SDK Swift mở SFSafariViewController. Yêu cầu iOS 16+.

React Native

Turbo Module trên cả hai native core. Yêu cầu React Native 0.76+.

Flutter

Kênh Pigeon trên cả hai native core. Yêu cầu Flutter 3.44+.

Mobile Integration Guide

Luồng thanh toán mobile end-to-end, từ checkout session ở backend đến thiết lập callback scheme.

Command-Line Interface

Dodo CLI quản lý payments, customers và webhooks từ terminal của bạn. CLI bao gồm TUI tương tác, trợ lý AI và các công cụ kiểm thử webhook.

CLI

Client terminal tương tác với trợ lý AI và tính năng kiểm thử webhook.
Cài đặt trên macOS hoặc Linux bằng:

Framework Adaptors

Adaptors bổ sung checkout, Customer Portal và các trình xử lý webhook vào framework của bạn.

Framework được khuyến nghị

Next.js

Các trình xử lý route cho checkout, Customer Portal và webhooks trong App Router.

Better Auth

Tạo customer khi người dùng đăng ký, rồi thêm checkout và Customer Portal vào luồng xác thực của bạn.

Supabase

Starter Next.js và Supabase với auth, database schema, webhooks và trang pricing.

Convex

Checkout, Customer Portal và các hàm webhook cho backend Convex của bạn.

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

Bun

Chuyển đổi từ Node.js SDK

TypeScript SDK thay thế Node.js SDK cũ. Nếu bạn đang sử dụng Node.js SDK, hãy xem migration guide để cập nhật integration của bạn.

Nhận trợ giúp

  • Discord: Tham gia community server của chúng tôi để nhận trợ giúp theo thời gian thực.
  • Email: Liên hệ với chúng tôi qua support@dodopayments.com.
  • GitHub: Mở issue trên repository của SDK tương ứng.
  • Documentation: Truy cập API reference.

Đóng góp

Mỗi repository của SDK đều chấp nhận đóng góp. Hầu hết có tệp CONTRIBUTING.md chứa hướng dẫn báo cáo bug, yêu cầu feature, gửi pull request, chạy test và các quy ước về code style. Truy cập trang của từng SDK để xem repository GitHub và hướng dẫn đóng góp tương ứng.
Lần sửa đổi cuối 26 tháng 9, 2026