Skip to main content
India có cơ sở hạ tầng thanh toán đặc thù, chủ yếu là UPI (hơn 60% giao dịch kỹ thuật số) và các thẻ do India phát hành (Visa, Mastercard, Rupay, v.v.). Dodo Payments hỗ trợ tất cả các phương thức này và tuân thủ đầy đủ RBI đối với các ủy quyền subscription.

Tại sao phương thức thanh toán tại India quan trọng

UPI Dominance

UPI xử lý hơn 10 tỷ giao dịch mỗi tháng. Nhiều khách hàng tại India không có thẻ quốc tế.

Low Transaction Costs

UPI có phí giao dịch gần như bằng không. Đây là lựa chọn lý tưởng cho các giao dịch khối lượng lớn, giá trị thấp.

Subscription Support

Không giống hầu hết các phương thức thanh toán thay thế, UPI và tất cả thẻ do India phát hành (Visa, Mastercard, Rupay, v.v.) đều hỗ trợ thanh toán định kỳ thông qua các ủy quyền RBI.

Phương thức được hỗ trợ

*Subscription yêu cầu các ủy quyền tuân thủ RBI với quy tắc xử lý đặc biệt. Độ trễ xử lý 48 giờ áp dụng cho tất cả thẻ do India phát hành và UPI.

Cấu hình

Loại phương thức API

Ví dụ: Checkout tập trung vào India

Yêu cầu đối với UPI

Để UPI xuất hiện tại checkout:
  1. Quốc gia thanh toán phải là India (IN)
  2. Currency phải là INR
  3. Đối với merchant không ở India: phải bật Adaptive Currency
Nếu bạn là merchant không ở India và Adaptive Currency chưa được bật, UPI sẽ không khả dụng cho khách hàng của bạn.

Subscription với ủy quyền RBI

Subscription thông qua các phương thức thanh toán tại India hoạt động theo quy định của RBI (Reserve Bank of India) với các yêu cầu riêng.

Cách thức hoạt động của ủy quyền RBI

Loại ủy quyền

Số tiền được đăng ký với ngân hàng của khách hàng là max(mandate_floor, billing_amount). Vì vậy, ngưỡng này thực chất là hạn mức ủy quyền mà khách hàng nhìn thấy mỗi khi số tiền thanh toán thấp hơn ngưỡng. Quan trọng đối với thay đổi gói: Nếu việc nâng cấp dẫn đến khoản phí vượt quá giới hạn ủy quyền hiện tại, khoản phí sẽ thất bại và khách hàng phải ủy quyền lại.

Ngưỡng ủy quyền có thể cấu hình

Ngưỡng ủy quyền cho e-mandate INR có thể cấu hình thông qua trường mandate_min_amount_inr_paise (bằng INR paise — 1 INR = 100 paise). Bạn có thể ghi đè giá trị mặc định của hệ thống là ₹15,000 ở ba cấp độ: Thứ tự ưu tiên: ghi đè theo request → cài đặt merchant → giá trị mặc định của hệ thống.
Thiết lập ngưỡng cao hơn cho phép bạn hỗ trợ các khoản phí một lần lớn hơn trong tương lai (chẳng hạn như nâng cấp gói hoặc khoản vượt mức dựa trên mức sử dụng) mà không buộc khách hàng phải ủy quyền lại. Thiết lập ngưỡng thấp hơn đưa hạn mức ủy quyền của khách hàng gần hơn với số tiền thanh toán thực tế, nhưng làm giảm khoảng trống cho các khoản phí biến đổi trong tương lai.
Cài đặt này chỉ ảnh hưởng đến các e-mandate được đăng ký cho thẻ do India phát hành (Visa, Mastercard, RuPay) trên subscription INR. Subscription UPI tuân theo AutoPay flow riêng và không bị ảnh hưởng.

Độ trễ xử lý 48 giờ

Đây là khác biệt quan trọng nhất so với thanh toán bằng thẻ quốc tế:
1

Charge Initiated (Day 0)

Vào ngày gia hạn theo lịch, Dodo bắt đầu khoản phí với ngân hàng.
2

Pre-Debit Notification

Khách hàng nhận được thông báo từ ngân hàng về khoản ghi nợ sắp tới.
3

48-Hour Window

Khách hàng có thể hủy ủy quyền trong thời gian này thông qua ứng dụng ngân hàng.
4

Debit Completed (~48-51 hours)

Sau 48 giờ (cộng thêm tối đa 3 giờ để ngân hàng xử lý), tiền sẽ được ghi nợ.
5

Webhook Sent

Webhook payment.succeeded được gửi sau khi ghi nợ thực tế, không phải khi bắt đầu.
Không cấp quyền lợi khi bắt đầu tính phí. Hãy chờ webhook payment.succeeded, được gửi khoảng 48–51 giờ sau ngày tính phí theo lịch.

Xử lý khoảng thời gian 48 giờ

Sự kiện webhook cho subscription tại India

Kiểm thử

UPI Test ID

Số thẻ India dùng để kiểm thử

Best practice

Xây dựng ứng dụng để xử lý khoảng thời gian giữa lúc bắt đầu tính phí và lúc payment thực tế hoàn tất. Hãy cân nhắc:
  • Thời gian gia hạn cho quyền truy cập subscription
  • Truyền đạt rõ ràng cho khách hàng về thời gian xử lý
  • Fulfillment dựa trên webhook, không dựa trên ngày tháng
Khách hàng có thể hủy mandate thông qua ứng dụng ngân hàng bất cứ lúc nào. Theo dõi webhook subscription.on_hold và yêu cầu khách hàng đăng ký lại subscription hoặc cập nhật payment method.
Đối với pricing biến đổi (ví dụ: dựa trên mức sử dụng), hãy cân nhắc liệu ủy quyền theo nhu cầu trị giá Rs 15,000 có đủ hay không. Nếu các khoản phí có thể vượt quá mức này, khách hàng sẽ cần ủy quyền lại.
Đối với khách hàng tại India, UPI nên là phương thức thanh toán chính. Nhiều người dùng ưa chuộng UPI hơn thẻ vì quen thuộc và ít trở ngại hơn.

Khắc phục sự cố

Kiểm tra:
  1. Quốc gia thanh toán đã được đặt thành IN chưa?
  2. Currency đã được đặt thành INR chưa?
  3. Nếu là merchant không ở India: Adaptive Currency đã được bật chưa?
  4. upi_collect đã được включ trong allowed_payment_method_types chưa?
Giải pháp: Xác minh địa chỉ thanh toán có country: "IN"billing_currency: "INR".
Nguyên nhân: Số tiền của khoản phí mới vượt quá giới hạn ủy quyền hiện tại (ngưỡng Rs 15,000).Giải pháp: Khách hàng phải cập nhật payment method để thiết lập mandate mới với giới hạn chính xác.
Nguyên nhân: Khách hàng có thể đã hủy mandate trong khoảng thời gian 48 giờ hoặc ngân hàng đã từ chối khoản ghi nợ.Giải pháp: Khách hàng cần ủy quyền lại mandate hoặc cập nhật payment method.
Nguyên nhân: Độ trễ của Bank API có thể kéo dài thời gian xử lý thêm 2–3 giờ.Giải pháp: Đây là hành vi dự kiến. Hãy xây dựng hệ thống để xử lý độ trễ biến đổi lên đến tổng cộng khoảng 51 giờ.
Nguyên nhân: Trường hợp đặc biệt trong quy định RBI — việc hủy mandate trong khoảng thời gian xử lý không ngay lập tức hủy subscription.Giải pháp: Khoản phí tiếp theo sẽ thất bại và subscription sẽ chuyển sang on_hold. Theo dõi webhook cho payment.failed.

Trang liên quan

Payment Methods Overview

Xem tất cả phương thức thanh toán được hỗ trợ.

Subscriptions

Xem tài liệu đầy đủ về subscription, bao gồm các ủy quyền RBI.

Webhooks

Cách xử lý webhook cho các sự kiện payment.

Testing Process

Tất cả dữ liệu kiểm thử, bao gồm UPI ID và thẻ India.
Lần sửa đổi cuối 6 tháng 8, 2026