Method: disburseFundsResultNotification

Thông báo cho Google về kết quả thanh toán sau khi thực hiện lệnh gọi phương thức disburseFunds.

Giá trị disburseFundsResult không thay đổi giá trị của disburseFundsRequestId này, vì vậy, giá trị của giá trị này phải giống với giá trị được trả về trong lệnh gọi disburseFunds và không thể thay đổi bằng lệnh gọi tiếp theo tới 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.

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

Yêu cầu mẫu sẽ 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"
  }
}

Câu trả lờ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 có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
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 của đối tác tích hợp thanh toán nơi diễn 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 lệnh gọi 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)
}
Trường
responseHeader

object (ResponseHeader)

BẮT BUỘC: Tiêu đề chung cho tất cả câu trả lời.
result

enum (DisburseFundsResultNotificationResultCode)

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

DisburseFundsResult

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

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.
}
Trường
disburseFundsResultCode

enum (DisburseFundsResultCode)

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

object (RawResult)

KHÔNG BẮT BUỘC: Kết quả thô của việc giải ngân này. Dùng để cung cấp thông tin cho công cụ phân tích và công cụ đánh giá rủi ro của Google. Trong các tình huống liên kết mã từ chối, đôi khi dữ liệu sẽ bị mất. Đơn vị tích hợp có thể chọn cung cấp cho Google một mã thô. Ví dụ: cổng vào thẻ tín dụng (nhà tích hợp) có thể sử dụng trường này để cung cấp 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ỳ thẻ 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 kết hợp FailureDetail.

FailureDetail chỉ có thể là một trong những trạng thá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. Số liệu này được sử dụng cho thông báo có cấu trúc dành cho người dùng và phân tích tỷ lệ từ chối.

Số tiền này là micrô của cùng một currencyCode 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. Số liệu này được sử dụng cho thông báo có cấu trúc dành cho người dùng và phân tích tỷ lệ từ chối.

Số tiền này là micrô của cùng một currencyCode với lệnh gọi phương thức disburseFunds ban đầu.

DisburseFundsResultCode

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

Enum
UNKNOWN_RESULT Đừ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 trên mỗi giao dịch của đơn vị tích hợp. Nếu mã này được dùng, hãy điền số tiền giao dịch tối thiểu vào trường transactionMinLimit cho mục đích thông báo cho người dùng.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT Số tiền giải ngân được yêu cầu vượt quá hạn mức tối đa cho mỗi giao dịch của đơn vị tích hợp. Nếu bạn dùng mã này, hãy điền hạn mức giao dịch vào trường transactionMaxLimit để thông báo cho người dùng.
ACCOUNT_CLOSED Tài khoản của người dùng do đối tác tích hợp giữ lại đã bị đóng. Giá trị trả về này sẽ khiến phương thứ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 người dùng với đơn vị tích hợp đã bị đóng và có thể là tài khoản bị chiếm đoạt. Giá trị trả về này sẽ khiến phương thứ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 được giữ với đối tác tích hợp đã bị đóng do gian lận. Giá trị trả về này sẽ khiến phương thứ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 bị tạm ngưng.

RawResult

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

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

string

KHÔNG BẮT BUỘC: Phạm vi của mã thô, có thể để trống.
rawCode

string

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

DisburseFundsResultNotificationResultCode

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

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