Tổng quan về Official SDKs - Dodo Payments Documentation

Dodo Payments cung cấp official SDKs cho nhiều ngôn ngữ lập trình, mỗi SDK được thiết kế theo các best practice dành riêng cho ngôn ngữ và các tính năng hiện đại để tích hợp thanh toán liền mạch.

Luôn sử dụng phiên bản SDK mới nhất để có thể truy cập các tính năng và cải tiến mới nhất. Hãy thường xuyên kiểm tra trình quản lý package để tìm các bản cập nhật, nhằm đảm bảo bạn có quyền truy cập vào tất cả khả năng của Dodo Payments.

SDK hiện có

Chọn SDK phù hợp với tech stack của bạn:

TypeScript SDK

Tích hợp type-safe cho TypeScript và Node.js với API dựa trên promise và phân trang tự động

Python SDK

Giao diện theo phong cách Python với hỗ trợ async/await cho các ứng dụng Python 3.7+

PHP SDK

SDK tuân thủ PSR-4 cho các ứng dụng PHP 8.1+ hiện đại

Go SDK

Giao diện Go idiomatic với hỗ trợ context và typing mạnh

Ruby SDK

Giao diện Ruby tinh tế, tuân theo các quy ước và best practice của Ruby

Java SDK

SDK mạnh mẽ và an toàn với thread cho Java 8+, hỗ trợ Maven và Gradle

Kotlin SDK

Kotlin SDK hiện đại với coroutine, null safety và extension function

C# SDK

SDK type-safe cho .NET 8+ với API dựa trên async Task (Beta)

Rust SDK

SDK ưu tiên async, được xây dựng trên Tokio và reqwest, với typing mạnh cho Rust 1.75+

CLI

Giao diện dòng lệnh để tương tác với API từ terminal của bạn

Đang xây dựng ứng dụng di động? Xem Mobile Checkout SDKs bên dưới cho Android, iOS, React Native và Flutter.

Bắt đầu nhanh

Bắt đầu sử dụng bất kỳ SDK nào chỉ trong vài phút:

Install the SDK

Sử dụng trình quản lý package của ngôn ngữ bạn để cài đặt SDK

TypeScript/Node.js
Python
PHP
Go
Rust

npm install dodopayments

pip install dodopayments

composer require dodopayments/client

go get github.com/dodopayments/dodopayments-go

cargo add dodopayments

Initialize the Client

Cấu hình client bằng API key của bạn

TypeScript
Python
PHP
Go
Rust

import DodoPayments from 'dodopayments';
const client = new DodoPayments({ bearerToken: 'your_api_key' });

from dodopayments import DodoPayments
client = DodoPayments(bearer_token="your_api_key")

use Dodopayments\Client;
$client = new Client(bearerToken: 'your_api_key');

import "github.com/dodopayments/dodopayments-go"
client := dodopayments.NewClient(option.WithBearerToken("your_api_key"))

use dodopayments::Client;
let client = Client::from_env()?; // reads DODO_PAYMENTS_API_KEY

Luôn lưu trữ API key an toàn bằng environment variable. Không bao giờ commit chúng vào hệ thống quản lý phiên bản.

Make Your First API Call

Tạo checkout session hoặc khoản thanh toán

Bạn đã sẵn sàng xử lý thanh toán! Truy cập các trang SDK riêng lẻ để xem hướng dẫn và ví dụ chi tiết.

Tính năng chính

Tất cả SDK backend đều có các khả năng cốt lõi này. Các mobile checkout SDK bên dưới được thiết kế với phạm vi hẹp hơn — chúng không chứa API key và không bao giờ gọi API:

Type Safety: Typing mạnh để đả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: Xử lý exception toàn diện với thông báo lỗi chi tiết
Authentication: Xác thực API key đơn giản với hỗ trợ environment variable
Async Support: Các pattern async/await hiện đại khi phù hợp
Auto-Pagination: Phân trang tự động cho các response dạng danh sách
Usage-Based Billing: Hỗ trợ tích hợp sẵn để theo dõi và tiếp nhận usage event
Testing: Hỗ trợ đầy đủ sandbox environment cho phát triển và kiểm thử

Mobile Checkout SDKs

Nếu bạn muốn mở hosted checkout page của Dodo thay vì xây dựng payment sheet native, hãy sử dụng mobile checkout SDK dành cho nền tảng của bạn. Cả bốn SDK đều dùng cùng một contract gọi một lần: start(...) trả về một CheckoutResult có kiểu, không SDK nào chứa API key, và Apple Pay/Google Pay hoạt động giống như trên web mở vì checkout được mở trong browser surface thực của nền tảng (SFSafariViewController / Custom Tabs), không phải một WebView:

Android

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

iOS

Swift SDK 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

Pigeon channel 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ừ backend checkout session đến thiết lập callback scheme

Command-Line Interface

Dành cho các quy trình dựa trên terminal và tự động hóa:

CLI

Command-line interface được tự động tạo với hỗ trợ cho tất cả 78 API endpoint

Tính năng:

Cấu trúc lệnh dựa trên resource để sử dụng trực quan
Nhiều định dạng đầu ra (JSON, YAML, pretty, interactive)
Shell completion cho bash, zsh và fish
Phù hợp cho scripting và tự động hóa CI/CD

# Quick example
dodopayments payments list --format json | jq '.data[] | {id, amount}'

Migration from Node.js SDK

Chúng tôi đã chuyển từ Node.js SDK sang TypeScript SDK mới. Nếu bạn đang sử dụng Node.js SDK cũ, hãy xem migration guide để cập nhật integration của bạn.

Framework Adapters

Tích hợp trong chưa đến 10 dòng code với các framework adapter của chúng tôi. Chọn một trong các framework được đề xuất hoặc khám phá tất cả tùy chọn được hỗ trợ.

Recommended Frameworks

Next.js

Framework full-stack dựa trên React với hỗ trợ App Router

Better Auth

Framework xác thực với các integration tích hợp sẵn

Supabase

Giải pháp thay thế Firebase mã nguồn mở với Postgres và Auth

Convex

Backend-as-a-Service với các khả năng real-time

Show other 8+ supported frameworks

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

Nhận trợ giúp

Bạn cần hỗ trợ với SDK nào không?

Discord: Tham gia community server của chúng tôi để được hỗ trợ 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 tương ứng của SDK
Documentation: Truy cập API reference

Đóng góp

Chúng tôi hoan nghênh đóng góp cho tất cả SDK! Mỗi repository đều có file CONTRIBUTING.md với hướng dẫn về:

Báo cáo lỗi
Đề xuất tính năng
Gửi pull request
Chạy test cục bộ
Quy ước và style của code

Truy cập trang của từng SDK để xem repository GitHub và hướng dẫn đóng góp tương ứng.

​SDK hiện có

TypeScript SDK

Python SDK

PHP SDK

Go SDK

Ruby SDK

Java SDK

Kotlin SDK

C# SDK

Rust SDK

CLI

​Bắt đầu nhanh

​Tính năng chính

​Mobile Checkout SDKs

Android

iOS

React Native

Flutter

Mobile Integration Guide

​Command-Line Interface

CLI

​Migration from Node.js SDK

​Framework Adapters

​Recommended Frameworks

Next.js

Better Auth

Supabase

Convex

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

​Nhận trợ giúp

​Đóng góp

SDK hiện có

Bắt đầu nhanh

Tính năng chính

Mobile Checkout SDKs

Command-Line Interface

Migration from Node.js SDK

Framework Adapters

Recommended Frameworks

Nhận trợ giúp

Đóng góp