SDKs & Libraries
SDK backend chính thức cho TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby và Rust. Các thư viện này đơn giản hóa các yêu cầu API, xác thực và xử lý lỗi, giúp bạn tập trung vào việc xây dựng trải nghiệm thanh toán tuyệt vời.
Mobile Checkout SDKs
Bạn đang xây dựng ứng dụng native? Mở hosted checkout của Dodo và nhận kết quả đã được định kiểu trong một lệnh gọi duy nhất trên Android, iOS, React Native và Flutter. Các ứng dụng này không chứa API key.
URL môi trường
- Test Mode:
https://test.dodopayments.com - Live Mode:
https://live.dodopayments.com
Tìm hiểu thêm về Test Mode vs Live Mode.
Quản lý API Key và xác thực
1
Access API Keys
Đi tới Developer → API Keys trong dashboard để quản lý các key của bạn.
2
Generate a New Key
Chọn Add API Key, nhập tên mô tả và cấu hình quyền ghi:
- Enable write access (đã chọn): Toàn quyền đọc và ghi cho tất cả thao tác API
- Enable write access (chưa chọn): Quyền chỉ đọc - chỉ có thể truy xuất dữ liệu (payments, subscriptions, customers, products). Không thể tạo hoặc sửa đổi tài nguyên.
3
Store Your Key Securely
Sao chép key đã tạo ngay lập tức và đảm bảo key được lưu trữ an toàn.
4
Authenticate Your API Requests
Sử dụng API key để xác thực tất cả yêu cầu. Áp dụng định dạng authorization sau:
Định dạng response
Giới hạn tốc độ
API của chúng tôi sử dụng hệ thống giới hạn tốc độ hai cửa sổ kèm cơ chế bảo vệ burst. Các giới hạn được áp dụng dựa trên phương thức xác thực và cấp độ doanh nghiệp của bạn.Giới hạn mặc định (Tier 0)
Cấp độ doanh nghiệp
Các giới hạn tốc độ cao hơn dành cho những doanh nghiệp có nhu cầu API tăng cao:Requests không xác thực
Các request không có header xác thực hợp lệ sẽ bị giới hạn theo địa chỉ IP:Header giới hạn tốc độ
Theo dõi mức sử dụng của bạn bằng các response header sau:X-RateLimit-Limit- Số request tối đa được phépX-RateLimit-Remaining- Số request còn lại trong cửa sổ hiện tạiX-RateLimit-Reset- Thời điểm giới hạn tốc độ được đặt lại
Khi vượt quá giới hạn tốc độ, API sẽ trả về response
429 Too Many Requests. Hãy triển khai exponential backoff trong logic retry.Xử lý lỗi
Để quản lý lỗi hiệu quả, hãy tham khảo các phần Mã lỗi và Lỗi giao dịch để biết hướng dẫn chi tiết.Error Codes
Tìm hiểu chi tiết toàn diện về lỗi và cách giải quyết.
Transaction Failures
Nắm được thông tin về các sự cố giao dịch phổ biến và giải pháp xử lý.
Webhook
Nhận thông báo theo thời gian thực về các sự kiện thanh toán. Xem Hướng dẫn Webhook để biết hướng dẫn thiết lập.Webhook Guide
Thiết lập webhook để nhận thông báo theo thời gian thực và xử lý sự kiện.
Hướng dẫn dành cho Developer liên quan
Khám phá các hướng dẫn toàn diện của chúng tôi để hiểu cách triển khai các tính năng chính bằng API:One-time Payments Integration
Tìm hiểu cách tích hợp thanh toán một lần, checkout session và payment link vào ứng dụng của bạn
Subscription Integration
Hướng dẫn đầy đủ về cách triển khai subscription, quản lý plan và xử lý các sự kiện trong vòng đời subscription
Usage-Based Billing
Thiết lập meter và usage event cho mô hình tính phí theo mức sử dụng và định giá dựa trên mức tiêu thụ
Webhooks
Nhận thông báo theo thời gian thực và tự động hóa workflow bằng các sự kiện webhook
Checkout Sessions
Tạo trải nghiệm checkout hosted an toàn với khả năng tùy chỉnh toàn diện và các tính năng nâng cao