Chuyển hướng FOP
Tổng quan
Google Payments (Thanh toán thông thường) hỗ trợ Phương thức thanh toán (FOP) dựa trên lệnh chuyển hướng. Phương thức FOP chuyển hướng cho phép người dùng các sản phẩm hoặc dịch vụ của Google thanh toán cho những nội dung này trên giao diện web của pháp nhân bên ngoài. Nhìn chung, người dùng muốn thanh toán cho hàng hoá ban đầu sẽ được chuyển hướng đến đơn vị tích hợp thanh toán hoặc đến một công ty phát hành mà họ có thể dùng thông qua công ty tích hợp thanh toán. Nếu người dùng được chuyển hướng đến đơn vị tích hợp, đơn vị tích hợp phải chuyển tiếp người dùng đến giao diện web của nhà phát hành để hoàn tất giao dịch mua. Sau khi thanh toán xong, người dùng sẽ được chuyển hướng trở lại Google thông qua công cụ tích hợp.
Google sử dụng hai quy trình chính để hoàn tất giao dịch thanh toán bằng phương thức FOP chuyển hướng:
- Bắt đầu chuyển hướng: Có hai quy trình khác nhau có thể bắt đầu thanh toán chuyển hướng. Bên tích hợp thanh toán chỉ nên triển khai một trong những tuỳ chọn sau:
- Bắt đầu quy trình chuyển hướng: Bắt đầu thanh toán bằng cách chuyển hướng người dùng đến bên tích hợp thanh toán.
- Tạo quy trình URL thanh toán chuyển hướng: Google thực hiện khoản thanh toán bằng cách gửi yêu cầu từ máy chủ đến máy chủ đến bên tích hợp thanh toán để tạo URL thanh toán chuyển hướng. Dựa trên phản hồi, Google sẽ chuyển hướng người dùng thẳng đến công ty phát hành.
- Hoàn tất quy trình chuyển hướng: Sau khi người dùng hoàn tất giao dịch mua, nhà tích hợp sẽ sử dụng quy trình này để xác nhận khoản thanh toán với Google.
Cuối cùng, toàn bộ hoạt động chuyển tiền giữa ngân hàng của nhà tích hợp và ngân hàng của Google đều được thực hiện trong quy trình chuyển tiền.
Tổng quan về phương thức thanh toán chuyển hướng
Hình sau đây minh hoạ thông tin tổng quan chung về các luồng:
Nhìn chung, việc thêm dịch vụ của bạn vào các sản phẩm của Google làm phương thức thanh toán sẽ bao gồm những quy trình sau:
- Bắt đầu chuyển hướng:
- Hoàn tất quy trình chuyển hướng
- Quy trình hoàn tiền
- Quy trình chuyển tiền
Khái niệm và thuật ngữ
Biểu tượng và quy ước
Các từ khoá "PHẢI", "KHÔNG ĐƯỢC", "BẮT BUỘC", "SÁCH", "KHÔNG NÊN", "NÊN", "KHÔNG NÊN", "ĐƯỢC ĐỀ XUẤT", "CÓ THỂ" và "KHÔNG BẮT BUỘC" trong những tài liệu này sẽ được hiểu như mô tả trong RFC 2119.
Dấu thời gian
Tất cả dấu thời gian được biểu thị dưới dạng mili giây kể từ thời gian bắt đầu của hệ thống Unix (ngày 1 tháng 1 năm 1970) theo giờ UTC.
Ví dụ:
- Ngày 23 tháng 4 năm 2019 8:23:25 CH GMT = 1556051005000 mili giây
- Ngày 16 tháng 8 năm 2018 12:28:35 CH GMT = 1534422515000 mili giây
Số Lượng
Giá trị tiền tệ trong API này có định dạng được gọi là "phần triệu", một tiêu chuẩn tại Google. Micros là một định dạng dựa trên số nguyên, chính xác cố định. Để biểu thị giá trị tiền tệ bằng phần triệu, hãy nhân giá trị tiền tệ tiêu chuẩn với 1.000.000.
Ví dụ:
- 1,23 USD = 1230000 micro USD
- 0,01 USD = 10.000 micro USD
Tính không xác định
Tất cả lệnh gọi phương thức trong API này phải có hành vi giống nhau. Google sẽ ngẫu nhiên thử lại yêu cầu để đảm bảo rằng các giao dịch đều ở cùng trạng thái ở cả hai bên. Trình tích hợp không được cố gắng xử lý lại bất kỳ yêu cầu nào đã được xử lý thành công. Phản hồi cho quá trình xử lý thành công sẽ được báo cáo thay thế. Tất cả các phương thức đều có một RequestHeader chung chứa requestId. requestId này là khoá không thay đổi giá trị cho tất cả lệnh gọi.
Mọi phản hồi không phải thiết bị đầu cuối (không phải là phản hồi HTTP 200 thành công) đều không được xử lý một cách tự nhiên. Vì vậy, một yêu cầu trước đó đã nhận được 400 (yêu cầu không tốt/điều kiện tiên quyết không thành công), khi được gọi lần thứ hai, không được trả về 400 không đáng kể, nó phải được đánh giá lại. Khi đánh giá lại, bài đánh giá có thể trả về 400 hoặc được xử lý thành công.
Để biết thêm thông tin về trường hợp không xác định được, hãy xem hướng dẫn chi tiết này.
Nhà tích hợp
Công ty sử dụng Nền tảng thanh toán của Google cho doanh nghiệp của họ. Đó có thể là doanh nghiệp nội bộ (bên thứ nhất), chẳng hạn như YouTube hoặc AdWords. Đó cũng có thể là doanh nghiệp bên ngoài (bên thứ ba) muốn tích hợp dịch vụ của họ để phù hợp với hệ sinh thái của Google.
Phương thức thanh toán
Phương thức thanh toán. Đây là phương pháp chung chung hơn một công cụ. Thẻ Visa, MasterCard và PayPal đều là phương thức thanh toán.
Công cụ
Một trường hợp cụ thể của phương thức thanh toán của một khách hàng cụ thể. Ví dụ: thẻ tín dụng hoặc tài khoản PayPal của người dùng. Phương thức thanh toán được mã hoá cho một khách hàng cụ thể cũng là một phương thức thanh toán, vì đó là một phương thức thanh toán của khách hàng đó và được lưu trữ an toàn trên hệ thống của chúng tôi.
Mã thông báo
Nội dung trình bày phương thức thanh toán của một người dùng cụ thể trên hệ thống của Google. Vì mã này chứa tất cả thông tin cần thiết để thực hiện giao dịch mua, nên mã thông báo cũng là một công cụ. Thông tin này có thể bao gồm những thông tin như số tài khoản mà người dùng có với đơn vị tích hợp của họ.
Luồng chính
Bắt đầu quy trình chuyển hướng
Bước đầu tiên trong quy trình Thanh toán chuyển hướng là quy trình Bắt đầu chuyển hướng. Mục đích của quy trình Bắt đầu chuyển hướng là chuyển hướng người dùng đến giao diện web của nhà phát hành mà họ đã chọn đến giao diện web của nhà phát hành mà họ đã chọn để họ có thể uỷ quyền thanh toán. Sau khi chuyển hướng, Google sẽ cung cấp thông tin giao dịch cơ bản cho đơn vị tích hợp. Sau đó, thông tin này sẽ được chuyển tiếp đến công ty phát hành.
Để biết thêm thông tin, hãy xem phần Bắt đầu quy trình chuyển hướng.
Hoàn tất quy trình Chuyển hướng
Sau khi truy cập vào giao diện web của công ty phát hành, người dùng cần thực hiện tất cả các bước cần thiết để hoàn tất khoản thanh toán (những bước này có thể thay đổi tuỳ thuộc vào công ty phát hành). Trong quy trình Chuyển hướng hoàn chỉnh, tổ chức phát hành nên chuyển hướng người dùng quay lại trình tích hợp kèm theo thông tin về khoản thanh toán thành công. Nhà tích hợp sẽ chuyển hướng người dùng quay lại Google, bao gồm cả thông tin thanh toán trong phản hồi chuyển hướng. Sau khi khoản thanh toán được xác nhận, Google sẽ cung cấp hàng hoá hoặc dịch vụ đã mua cho người dùng.
Để biết thêm thông tin, hãy xem mục Hoàn tất quy trình chuyển hướng.