Tổng quan về tính năng hỗ trợ MIT
Giao dịch do người bán khởi tạo (MIT) là các giao dịch được xử lý mà không cần người dùng đang hoạt động trong phiên. Bản cập nhật này cho Google Pay Online API giúp tăng khả năng hiển thị cho các loại giao dịch này, cải thiện trải nghiệm người dùng thông qua giao diện người dùng chi tiết thanh toán riêng biệt và cải thiện tính liên tục của việc thanh toán.
Các trường hợp sử dụng chính
- Thanh toán định kỳ: Dịch vụ phát trực tuyến kỹ thuật số, gói thành viên hoặc dịch vụ tiện ích.
- Thanh toán trả chậm: Đặt phòng khách sạn, đặt hàng trước hoặc phí vắng mặt.
- Tự động nạp lại: Nạp tiền vào thẻ quà tặng hoặc thẻ đi lại.
Triển khai MIT API
MIT API là một phần mở rộng của API
loadPaymentData
hiện có. Trình tích hợp phải thêm đúng một đối tượng *TransactionInfo để chỉ định ý định thanh toán.
Google cung cấp 3 lựa chọn tuỳ thuộc vào loại Giao dịch do người bán khởi tạo:
| Loại giao dịch | Tên đối tượng | Mô tả |
|---|---|---|
| Định kỳ | RecurringTransactionInfo |
Dùng cho các khoản phí có tần suất cố định. Hỗ trợ bản dùng thử, thanh toán trả trước và thanh toán trả sau. |
| Trả chậm | DeferredTransactionInfo |
Dùng cho một khoản phí duy nhất vào một thời điểm xác định trước trong tương lai. |
| Tự động nạp lại | AutomaticReloadTransactionInfo |
Dùng để nạp lại tài khoản có giá trị lưu trữ khi số dư giảm xuống dưới ngưỡng tối thiểu. |
Các bước tích hợp
- Tài liệu: Truy cập vào DevSite trong chương trình tiếp cận sớm. Ba định nghĩa đối tượng mới nằm trong phần Tài liệu tham khảo về đối tượng và được liên kết trực tiếp trong danh sách trước đó.
- Triển khai: Sử dụng(các) đối tượng
*TransactionInfocó liên quan cho hệ thống của bạn trong yêu cầu API.- Xin lưu ý rằng bạn chỉ có thể truyền một đối tượng cho mỗi yêu cầu đến API. Việc xác định đối tượng cần sử dụng và điền các trường là tuỳ thuộc vào từng người bán.
- Kiểm thử: Sử dụng môi trường KIỂM THỬ để xác thực rằng thông tin thanh toán hiển thị chính xác trong bảng thanh toán.
- Ra mắt: Phát hành khi các tham số được xác minh.
Quản lý vòng đời mã thông báo (TLM)
Quản lý vòng đời mã thông báo đảm bảo tính liên tục của việc thanh toán bằng cách cung cấp thông báo theo thời gian thực khi mã thông báo thanh toán an toàn được cập nhật hoặc huỷ kích hoạt. Để biết thông tin đầy đủ, hãy xem tài liệu về Quản lý vòng đời mã thông báo .
Các sự kiện chính về mã thông báo
- Huỷ kích hoạt/Xoá: Thông báo khi không thể sử dụng mã thông báo nữa.
- Cập nhật hậu tố FPAN: Xảy ra khi Số tài khoản chính của nguồn tài trợ cơ bản được cập nhật.
Yêu cầu thiết lập máy chủ
Người bán trực tiếp và Nhà cung cấp dịch vụ thanh toán (PSP) phải thiết lập một hệ thống để nhận, giải mã và xử lý các thông báo này.
| Yêu cầu | Mô tả |
|---|---|
| Điểm cuối | Điểm cuối HTTPS an toàn để nhận các lệnh gọi POST. |
| Xác thực | Phải xử lý việc xác thực chữ ký và giải mã thông báo. |
| Đáp | Trả về SUCCESS để tiếp tục nhận thông báo hoặc TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE để dừng nhận thông báo. |
| Thông báo của người bán | PSP sẽ cần thông báo trạng thái mã thông báo cho người bán. |
Lưu ý khi triển khai
Bạn phải chuyển điểm cuối tokenUpdateUrl cùng với giao dịch để nhận thông tin cập nhật cho mã thông báo. Đối với PSP, việc xác định cách người bán sẽ nhận và điền URL này vào đối tượng *TransactionInfo có liên quan là trách nhiệm của PSP.
Xin lưu ý rằng tải trọng được mã hoá sẽ trả về một trường bổ sung không bắt buộc là merchantTokenId cho MIT. Để biết thông tin cụ thể, hãy xem tài liệu về
Mã hoá dữ liệu thanh toán
(dành cho Người bán) hoặc tài liệu về
Cấu trúc tải trọng (dành cho nhà cung cấp dịch vụ thanh toán).