Điều kiện tiên quyết
Để tích hợp API Dodo Payments, bạn cần:- Một tài khoản thương nhân Dodo Payments
- Thông tin xác thực API (khóa API và khóa bí mật webhook) từ bảng điều khiển
Thiết lập bảng điều khiển
- Điều hướng đến Bảng điều khiển Dodo Payments
- Tạo một sản phẩm (thanh toán một lần hoặc đăng ký)
-
Tạo khóa API của bạn:
- Đi tới Developer > API
- Hướng dẫn chi tiết
- Sao chép khóa API trong biến môi trường có tên DODO_PAYMENTS_API_KEY
-
Cấu hình webhooks:
- Đi tới Developer > Webhooks
- Tạo một URL webhook cho thông báo thanh toán
- Sao chép khóa bí mật webhook trong biến môi trường
Tích hợp
Liên kết thanh toán
Chọn con đường tích hợp phù hợp với trường hợp sử dụng của bạn:- Phiên thanh toán (được khuyến nghị): Tốt nhất cho hầu hết các tích hợp. Tạo một phiên trên máy chủ của bạn và chuyển hướng khách hàng đến một trang thanh toán an toàn, được lưu trữ.
- Thanh toán chồng (nhúng): Sử dụng khi bạn cần trải nghiệm trong trang nhúng thanh toán được lưu trữ trên trang web của bạn.
- Liên kết thanh toán tĩnh: URL có thể chia sẻ ngay lập tức không cần mã cho việc thu thập thanh toán nhanh chóng.
- Liên kết thanh toán động: Liên kết được tạo lập trình. Tuy nhiên, các phiên thanh toán được khuyến nghị và cung cấp nhiều tính linh hoạt hơn.
1. Phiên thanh toán
Sử dụng các phiên thanh toán để tạo trải nghiệm thanh toán an toàn, được lưu trữ cho các khoản thanh toán một lần hoặc đăng ký. Bạn tạo một phiên trên máy chủ của mình, sau đó chuyển hướng khách hàng đếncheckout_url.
Các phiên thanh toán có hiệu lực trong 24 giờ theo mặc định. Nếu bạn truyền
confirm=true, các phiên có hiệu lực trong 15 phút và tất cả các trường cần thiết phải được cung cấp.1
Tạo một phiên thanh toán
Chọn SDK ưa thích của bạn hoặc gọi API REST.
- Node.js SDK
- Python SDK
- REST API
2
Chuyển hướng khách hàng đến thanh toán
Sau khi tạo phiên, chuyển hướng đến
checkout_url để bắt đầu quy trình lưu trữ.2. Thanh toán chồng
Để có trải nghiệm thanh toán trong trang liền mạch, hãy khám phá tích hợp Thanh toán chồng của chúng tôi cho phép khách hàng hoàn tất thanh toán mà không rời khỏi trang web của bạn.3. Liên kết thanh toán tĩnh
Liên kết thanh toán tĩnh cho phép bạn nhanh chóng chấp nhận thanh toán bằng cách chia sẻ một URL đơn giản. Bạn có thể tùy chỉnh trải nghiệm thanh toán bằng cách truyền các tham số truy vấn để tự động điền thông tin khách hàng, kiểm soát các trường biểu mẫu và thêm siêu dữ liệu tùy chỉnh.1
Xây dựng liên kết thanh toán của bạn
Bắt đầu với URL cơ bản và thêm ID sản phẩm của bạn:
2
Thêm các tham số chính
Bao gồm các tham số truy vấn thiết yếu:
-
Số lượng hàng hóa để mua.
-
URL để chuyển hướng sau khi hoàn tất thanh toán.
URL chuyển hướng sẽ bao gồm chi tiết thanh toán dưới dạng tham số truy vấn, ví dụ:
https://example.com/?payment_id=pay_ts2ySpzg07phGeBZqePbH&status=succeeded3
Tự động điền thông tin khách hàng (tùy chọn)
Thêm các trường khách hàng hoặc thanh toán dưới dạng tham số truy vấn để đơn giản hóa quy trình thanh toán.
Các trường khách hàng được hỗ trợ
Các trường khách hàng được hỗ trợ
-
Họ và tên của khách hàng (bỏ qua nếu firstName hoặc lastName được cung cấp).
-
Tên của khách hàng.
-
Họ của khách hàng.
-
Địa chỉ email của khách hàng.
-
Quốc gia của khách hàng.
-
Địa chỉ đường phố.
-
Thành phố.
-
Tiểu bang hoặc tỉnh.
-
Mã bưu điện/ZIP.
-
true hoặc false
4
Kiểm soát các trường biểu mẫu (tùy chọn)
Bạn có thể vô hiệu hóa các trường cụ thể để làm cho chúng chỉ đọc cho khách hàng. Điều này hữu ích khi bạn đã có thông tin của khách hàng (ví dụ: người dùng đã đăng nhập).
disable… tương ứng thành true:- Bảng cờ vô hiệu hóa
| Trường | Cờ vô hiệu hóa | Tham số bắt buộc |
|---|---|---|
| Họ và tên | disableFullName | fullName |
| Tên | disableFirstName | firstName |
| Họ | disableLastName | lastName |
disableEmail | email | |
| Quốc gia | disableCountry | country |
| Địa chỉ đường | disableAddressLine | addressLine |
| Thành phố | disableCity | city |
| Tiểu bang | disableState | state |
| Mã bưu điện | disableZipCode | zipCode |
Đặt
showDiscounts=false sẽ vô hiệu hóa và ẩn phần giảm giá trong biểu mẫu thanh toán. Sử dụng điều này nếu bạn muốn ngăn khách hàng nhập mã giảm giá hoặc mã khuyến mãi trong quá trình thanh toán.5
Thêm các điều khiển nâng cao (tùy chọn)
-
Chỉ định loại tiền tệ thanh toán. Mặc định là loại tiền tệ của quốc gia thanh toán.
-
Hiện hoặc ẩn trình chọn tiền tệ.
-
Số tiền tính bằng xu (chỉ cho giá Pay What You Want).
-
Các trường siêu dữ liệu tùy chỉnh (ví dụ:
metadata_orderId=123).
6
Chia sẻ liên kết
Gửi liên kết thanh toán đã hoàn thành đến khách hàng của bạn. Khi họ truy cập, tất cả các tham số truy vấn sẽ được thu thập và lưu trữ với một ID phiên. URL sau đó sẽ được đơn giản hóa để chỉ bao gồm tham số phiên (ví dụ:
?session=sess_1a2b3c4d). Thông tin đã lưu trữ sẽ tồn tại qua các lần làm mới trang và có thể truy cập trong suốt quá trình thanh toán.Trải nghiệm thanh toán của khách hàng giờ đây đã được đơn giản hóa và cá nhân hóa dựa trên các tham số của bạn.
4. Liên kết thanh toán động
Được tạo thông qua cuộc gọi API hoặc SDK của chúng tôi với thông tin khách hàng. Đây là một ví dụ: Có hai API để tạo liên kết thanh toán động:- API Liên kết thanh toán một lần Tài liệu API
- API Liên kết thanh toán đăng ký Tài liệu API
Đảm bảo bạn đang truyền
payment_link = true để nhận liên kết thanh toán - Node.js SDK
- Python SDK
- Go SDK
- Tài liệu API
Sau khi tạo liên kết thanh toán, hãy chuyển hướng khách hàng của bạn để hoàn tất thanh toán.