Method: disburseFundsResultNotification

Thông báo cho Google về kết quả giải ngân sau khi gọi phương thức disburseFunds.

Giá trị disburseFundsResult là không thay đổi cho disburseFundsRequestId này, vì vậy giá trị của nó phải giống với giá trị được trả về trong lệnh gọi disburseFunds và không thể thay đổi trong lệnh gọi tiếp theo đến phương thức này.

Nếu điểm cuối gặp lỗi trong khi xử lý yêu cầu, thì phản hồi từ điểm cuối này sẽ thuộc loại ErrorResponse.

Các phản hồi cho truy vấn này có thể trống nếu phương thức này không trả về HTTP 200. Nội dung phản hồi bị trống trong các tình huống mà ErrorResponse có nội dung mô tả rõ ràng có thể được sử dụng để giúp kẻ tấn công hiểu giá trị nhận dạng tài khoản của nhà tích hợp thanh toán của các nhà tích hợp khác. Trong các trường hợp này, khi khoá ký không khớp, không tìm thấy giá trị nhận dạng nhà tích hợp thanh toán hoặc khoá mã hoá, phương thức này sẽ trả về HTTP 404 không có mã. Nếu có thể xác minh chữ ký yêu cầu, thông tin bổ sung về lỗi sẽ được trả về nội dung phản hồi.

Một yêu cầu mẫu có dạng như sau:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

Một phản hồi mẫu sẽ có dạng như sau:


{
  "responseHeader": {
    "responseTimestamp": "1481852928324"
  },
  "result": "SUCCESS"
}

Yêu cầu HTTP

POST https://vgw.googleapis.com/secure-serving/gsp/v1/disburseFundsResultNotification/:PIAID

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc như sau:

Biểu diễn dưới dạng JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
Các trường
requestHeader

object (RequestHeader)

BẮT BUỘC: Tiêu đề chung cho tất cả các yêu cầu.
paymentIntegratorAccountId

string

BẮT BUỘC: Giá trị nhận dạng tài khoản nhà tích hợp thanh toán xảy ra khoản giải ngân.
disburseFundsRequestId

string

BẮT BUỘC: Giá trị nhận dạng duy nhất của giao dịch này. Đây là requestId do Google tạo trong lệnh gọi disburseFunds liên kết với yêu cầu này.

Đây là một chuỗi có độ dài tối đa là 100 ký tự và chỉ chứa các ký tự "a-z", "A-Z", "0-9", ":", "-" và "_".
disburseFundsResult

object (DisburseFundsResult)

BẮT BUỘC: Kết quả của cuộc gọi khoản tiền giải ngân này.

Nội dung phản hồi

Đối tượng phản hồi cho phương thức disburseFundsResultNotification.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (DisburseFundsResultNotificationResultCode)
}
Các trường
responseHeader

object (ResponseHeader)

BẮT BUỘC: Tiêu đề chung cho tất cả các phản hồi.
result

enum (DisburseFundsResultNotificationResultCode)

BẮT BUỘC: Kết quả của cuộc gọi này.

Giải ngân quỹ kết quả

Thông tin về kết quả giải ngân cuối cùng.

Biểu diễn dưới dạng JSON 
{
  "disburseFundsResultCode": enum (DisburseFundsResultCode),
  "rawResult": {
    object (RawResult)
  },

  // Union field FailureDetail can be only one of the following:
  "transactionMaxLimit": string,
  "transactionMinLimit": string
  // End of list of possible types for union field FailureDetail.
}
Các trường
disburseFundsResultCode

enum (DisburseFundsResultCode)

BẮT BUỘC: Mã kết quả của giao dịch giải ngân này.
rawResult

object (RawResult)

KHÔNG BẮT BUỘC: Kết quả thô của khoản giải ngân này. Dùng để cung cấp thông tin về công cụ rủi ro và số liệu phân tích của Google. Trong các trường hợp lập bản đồ bằng mã từ chối, đôi khi dữ liệu bị mất. Nhà tích hợp có thể chọn cung cấp cho Google một mã thô. Ví dụ: cổng thẻ tín dụng (nhà tích hợp) có thể sử dụng trường này để thông báo cho Google mã từ chối chính xác đã nhận được từ mạng VISA. Trong trường hợp đó, scope sẽ là "visa" và rawCode sẽ là bất kỳ giá trị nào mà mạng VISA trả về.

Giá trị này là bắt buộc nếu result không phải là SUCCESS.

Trường nhóm FailureDetail.

FailureDetail chỉ có thể là một trong những loại sau đây:
transactionMaxLimit

string (Int64Value format)

KHÔNG BẮT BUỘC: Nếu disburseFundsResultCode là DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT thì đây là giá trị của giao dịch tối đa được phép. Tính năng này được dùng cho các thông báo có cấu trúc, giao diện người dùng và phân tích tỷ lệ từ chối.

Số tiền này là micros của currencyCode giống với lệnh gọi phương thức disburseFunds ban đầu.
transactionMinLimit

string (Int64Value format)

KHÔNG BẮT BUỘC: Nếu disburseFundsResultCode là DISBURSEMENT_UNDER_TRANSACTION_LIMIT thì đây là giá trị của giao dịch tối thiểu được phép. Tính năng này được dùng cho các thông báo có cấu trúc, giao diện người dùng và phân tích tỷ lệ từ chối.

Số tiền này là micros của currencyCode giống với lệnh gọi phương thức disburseFunds ban đầu.

Mã kết quả giải ngân

Mã kết quả cho lệnh gọi khoản thanh toán.

Enum
UNKNOWN_RESULT Không bao giờ đặt giá trị mặc định này!
SUCCESS Thanh toán thành công.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT Số tiền giải ngân được yêu cầu không đáp ứng số tiền tối thiểu cho mỗi giao dịch của nhà tích hợp. Nếu bạn sử dụng mã này, hãy điền số tiền giao dịch tối thiểu vào trường transactionMinLimit cho mục đích nhắn tin cho người dùng.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT Số tiền giải ngân được yêu cầu vượt quá giới hạn tối đa mỗi giao dịch của nhà tích hợp. Nếu bạn sử dụng mã này, hãy điền giới hạn giao dịch vào trường transactionMaxLimit cho mục đích nhắn tin cho người dùng.
ACCOUNT_CLOSED Tài khoản của người dùng được tích hợp với nhà tích hợp đã bị đóng. Giá trị trả về này sẽ khiến công cụ của người dùng bị đóng với Google. Người dùng sẽ buộc phải thêm một công cụ mới.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER Tài khoản của người dùng với nhà tích hợp đã bị đóng, tài khoản bị nghi ngờ chiếm đoạt. Giá trị trả về này sẽ khiến công cụ của người dùng bị đóng với Google. Người dùng sẽ buộc phải thêm một công cụ mới.
ACCOUNT_CLOSED_FRAUD Tài khoản của người dùng do nhà tích hợp giữ đã bị đóng do gian lận. Giá trị trả về này sẽ khiến công cụ của người dùng bị đóng với Google. Người dùng sẽ buộc phải thêm một công cụ mới.
ACCOUNT_ON_HOLD Tài khoản của người dùng đang ở trạng thái treo.

Kết quả thô

Đối tượng kết quả thô.

Biểu diễn dưới dạng JSON 
{
  "scope": string,
  "rawCode": string
}
Các trường
scope

string

TÙY CHỌN: Có thể để trống phạm vi của RawCode.
rawCode

string

BẮT BUỘC: Mã thô từ trình tích hợp hoặc các hệ thống con trong đó.

Mã kết quả giải ngân

Mã kết quả cho phương thức disburseFundsResultNotification.

Enum
UNKNOWN_RESULT Không bao giờ đặt giá trị mặc định này!
SUCCESS Thông báo đã được xử lý thành công.