Tổng quan về dịch vụ hỗ trợ của MIT
Giao dịch do người bán bắt đầu (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 UX 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ụ truyền phát trực tiếp 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.
- 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
API MIT 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 xác định 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: 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 Tham chiếu đố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 sẵn các trường là tuỳ thuộc vào từng người bán.
- Thử nghiệm: 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: Bắt đầu hoạt động 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 sử 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.
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ý những thông báo này.
| Yêu cầu | Mô tả |
|---|---|
| Điểm cuối | Bảo mật điểm cuối HTTPS để 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 để ngừ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 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 đã 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ã 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).