Tổng quan
API Thẻ FOP (Hình thức thanh toán) hỗ trợ các khoản thanh toán được thực hiện bằng các thẻ chuẩn. Đây có thể là thẻ tín dụng và thẻ ghi nợ. Có cả lựa chọn đơn và thông báo kép được cung cấp cho các khoản thanh toán.
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 chụp đặt trước
quy trình chụp đặt trước là một luồng thông báo gồm hai khoản tiền nào được đặt trước trước rồi mới được thu nạp sau đó. Trong khi đặt chỗ không có hoạt động chuyển tiền nào diễn ra. Sau đó, bạn có thể huỷ hoặc ghi lại yêu cầu đặt chỗ. Chiến lược phát hành đĩa đơn kết quả cuối cùng của thao tác chụp hoặc huỷ được trả về không đồng bộ cho Google thông qua một thông báo.
Trình tích hợp thanh toán triển khai
Google triển khai
captureFundsReservationResultNotificationcancelFundsReservationResultNotificationsetAcquirerReferenceNumberForCaptureNotification
Để biết thêm thông tin về chụp dự trữ, hãy xem hướng dẫn chi tiết.
Quy trình chuyển tiền
Quy trình chuyển tiền là một luồng thông báo duy nhất trong
những khoản tiền được thu trực tiếp. Flow bao gồm một phương thức duy nhất
do Nhà tích hợp thanh toán có tên là Capture triển khai. Phương thức này
kiểm tra một cách đồng bộ các khoản tiền hiện có và thu thập tiền nếu thành công.
Trình tích hợp thanh toán triển khai
Google triển khai
Để biết thêm thông tin về chuyển tiền, hãy xem hướng dẫn chi tiết.
Quy trình hoàn tiền
Quy trình hoàn tiền được dùng để trả lại khoản tiền trước đây được thu thập thông qua quy trình chụp dự trữ hoặc quy trình chuyển tiền.
Trình tích hợp thanh toán triển khai
Google triển khai
Để 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 phản đối. được dùng để thông báo cho Google về các tranh chấp và khoản tiền hoàn lại mà khách hàng yêu cầu được hoàn tiền. Không phải mọi cuộc gọi ngụ ý hoạt động chuyển tiền, nhưng luồng này có thể được dùng để hoàn trả tiền cho khách hàng, hoặc để đảo ngược và trả lại chúng cho Google. Quy trình này có thể được dùng trong bổ sung vào quy trình báo cáo hành vi gian lận nhưng không được nhất thiết phải bao gồm cả gian lận.
Google triển khai
Để biết thêm thông tin về tranh chấp, hãy xem hướng dẫn chi tiết này.
Quy trình báo cáo hành vi gian lận
Quy trình báo cáo hành vi gian lận là để thông báo cho Google về tiềm ẩn nguy cơ gian lận. Thông tin này không ngụ ý cho bất kỳ hoạt động chuyển tiền nào và chỉ được 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 được. Điều này có thể đi kèm với tranh chấp hoặc khoản bồi hoàn thông qua quy trình phản đối.
Google triển khai
Để biết thêm thông tin về báo cáo gian lận, hãy xem hướng dẫn chi tiết.