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:- Quốc gia thanh toán phải là India (
IN) - Currency phải là INR
- Đối với merchant không ở India: phải bật Adaptive Currency
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ườngmandate_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.
Độ 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.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
Plan for the 48-hour delay
Plan for the 48-hour delay
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
Handle mandate cancellations
Handle mandate cancellations
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.Set appropriate mandate amounts
Set appropriate mandate amounts
Đố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.
Offer UPI prominently
Offer UPI prominently
Đố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ố
UPI not appearing at checkout
UPI not appearing at checkout
Kiểm tra:
- Quốc gia thanh toán đã được đặt thành
INchưa? - Currency đã được đặt thành
INRchưa? - Nếu là merchant không ở India: Adaptive Currency đã được bật chưa?
upi_collectđã được включ trongallowed_payment_method_typeschưa?
country: "IN" và billing_currency: "INR".Subscription charge failed after upgrade
Subscription charge failed after upgrade
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.
Subscription on hold but customer claims they didn't cancel
Subscription on hold but customer claims they didn't cancel
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.
Payment deduction delayed beyond 48 hours
Payment deduction delayed beyond 48 hours
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ờ.
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
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.