Tổng quan về dịch vụ hỗ trợ của MIT
Giao dịch do người bán khởi tạo (MIT) là giao dịch được xử lý mà người dùng không chủ động tham gia 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 chuyên dụng 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 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.
- Nạp tiền tự động: Nạp tiền vào thẻ đi phương tiện công cộng hoặc thẻ quà tặng.
Triển khai MIT API
MIT API là một phần mở rộng của API
loadPaymentData
hiện có. Các đơn vị 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 bắt đầu:
| Loại giao dịch | Tên đối tượng | Mô tả |
|---|---|---|
| Định kỳ | RecurringTransactionInfo |
Được dùng cho các khoản phí có tần suất cố định. Hỗ trợ dùng thử, thanh toán trả trước và thanh toán trả sau. |
| Bị hoãn | DeferredTransactionInfo |
Được dùng cho một khoản phí duy nhất tại một thời điểm đã định trước trong tương lai. |
| Tự động nạp tiền | AutomaticReloadTransactionInfo |
Được dùng để nạp lại tiền vào 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: 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 của tài liệu 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 sẵ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 THỬ NGHIỆM để 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 trực tiếp sau khi các tham số được xác minh.
Quản lý vòng đời mã thông báo (TLM)
Tính năng Quản lý vòng đời của 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 .
Sự kiện mã thông báo chính
- Huỷ kích hoạt/Xoá: Thông báo khi mã thông báo không còn dùng được nữa.
- Nội dung cập nhật về hậu tố FPAN: Xảy ra khi Số tài khoản cấp tiền chính cơ bản được cập nhật.
Các yêu cầu về việc 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ả |
|---|---|
| Endpoint | Điểm cuối HTTPS bảo mật để 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 ý về việc triển khai
Bạn phải truyền điểm cuối tokenUpdateUrl cùng với giao dịch để nhận thông tin cập nhật về 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.
Ngoài ra, 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, merchantTokenId, cho MIT. Để biết thông tin cụ thể, hãy xem tài liệu về
Mật mã học 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).