Thanh toán thông thường của Google: Phương thức thanh toán bằng thẻ

Tổng quan

API Card FOP (Phương thức thanh toán) hỗ trợ các khoản thanh toán được thực hiện bằng thẻ tiêu chuẩn. Đây có thể là thẻ tín dụng và thẻ ghi nợ. Có cả quy trình thanh toán bằng tin nhắn đơn và tin nhắn kép.

Các khái niệm quan trọng

Biểu tượng và quy ước

Các từ khoá "PHẢI", "KHÔNG ĐƯỢC", "BẮT BUỘC", "KHÔNG NÊN", "KHÔNG NÊN", "KHÔNG NÊN", "ĐƯỢC ĐỀ XUẤT", "CÓ THỂ" và "KHÔNG BẮT BUỘC" trong các tài liệu này sẽ được diễn giải như mô tả trong RFC 2119.

Dấu thời gian

Tất cả dấu thời gian đều đượ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 theo múi giờ UTC.

Ví dụ:

  • Ngày 14 tháng 8 năm 2010 16:30:00.00 SA GMT = 1281803400000
  • Ngày 6 tháng 11 năm 2007 9:37:00 CH MST = 1194410220000

Số Lượng

Giá trị tiền tệ trong API này được biểu thị bằng định dạng "micros" (một tiêu chuẩn của 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 một 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. Nói một cách đơn giản, trình tích hợp không nên cố gắng xử lý lại bất kỳ yêu cầu nào đã được xử lý thành công; thay vào đó, phản hồi để xử lý thành công sẽ được báo cáo. 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.

Đối với mọi câu trả lời không phải thiết bị đầu cuối (không phải là HTTP 200), câu trả lời đó không được được xử lý đơn thuần. Vì vậy, một yêu cầu trước đó nhận được 400, khi được gọi lần thứ hai không được trả về 400 một cách đơn giản, mà phải được đánh giá lại. Khi đánh giá lại, phương thức này 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.

Quy trình thu thập khoản đặt trước

Quy trình thu thập khoản tiền đặt trước là hai luồng thông báo, trong đó tiền được đặt trước rồi mới được ghi nhận sau đó. Trong quá trình đặt trước, hoạt động chuyển tiền sẽ không xảy ra. Sau đó, họ có thể huỷ hoặc ghi lại yêu cầu đặt chỗ đó. Kết quả cuối cùng của việc chụp hoặc huỷ được trả về không đồng bộ cho Google thông qua một thông báo.

Bên tích hợp thanh toán triển khai

Triển khai của Google

Để biết thêm thông tin về tính năng chụp trước, hãy xem hướng dẫn chi tiết này.

Luồng chuyển tiền

Quy trình chuyển tiền là một quy trình thông báo duy nhất, trong đó tiền được thu trực tiếp. Luồng bao gồm một phương thức duy nhất do Công cụ tích hợp thanh toán triển khai có tên là Capture. Phương thức này kiểm tra đồng bộ tiền hiện có và ghi lại khoản tiền đó nếu thành công.

Bên tích hợp thanh toán triển khai

Triển khai của Google

Để biết thêm thông tin về việc chuyển tiền, hãy xem hướng dẫn chi tiết này.

Quy trình hoàn tiền

Quy trình hoàn tiền được dùng để trả lại số tiền đã thu trước đây thông qua quy trình thu thập khoản tiền dự trước hoặc quy trình chuyển tiền.

Bên tích hợp thanh toán triển khai

Triển khai của Google

Để biết thêm thông tin về việc hoàn tiền, hãy xem hướng dẫn chi tiết này.

Quy trình kháng nghị

Quy trình kháng nghị được dùng để thông báo cho Google về các tranh chấp và yêu cầu hoàn tiền mà khách hàng yêu cầu hoàn tiền. Không phải mọi lệnh gọi đều cho phép chuyển tiền, nhưng luồng này có thể được dùng để trả lại tiền cho khách hàng hoặc đảo ngược số tiền đó và trả lại cho Google. Bạn có thể sử dụng quy trình này bổ sung cho quy trình báo cáo gian lận, nhưng không nhất thiết bao gồm hành vi gian lận.

Triển khai của Google

Để biết thêm thông tin về các đơn kháng nghị, hãy xem hướng dẫn chi tiết này.

Quy trình báo cáo gian lận

Quy trình báo cáo hành vi gian lận dùng để thông báo cho Google về khả năng xảy ra hành vi gian lận. Thông tin này không ngụ ý bất kỳ hoạt động chuyển tiền nào mà chỉ đơn giản là dùng để thông báo cho Công cụ rủi ro của Google về sự kiện này để có thể giảm thiểu hành vi gian lận nói chung. Điều này có thể đi kèm với tranh chấp hoặc hoàn tiền thông qua quy trình kháng nghị.

Triển khai của Google

Để biết thêm thông tin về việc báo cáo gian lận, hãy xem hướng dẫn chi tiết này.