Method: disburseFundsResultNotification

disburseFunds メソッドが呼び出された後、支払いの結果を Google に通知します。

disburseFundsResult 値はこの disburseFundsRequestId のべき等であるため、その値は disburseFunds 呼び出しで返された値と同じである必要があり、このメソッドの後続の呼び出しで変更することはできません。

リクエストの処理中にエンドポイントでエラーが発生した場合、このエンドポイントからのレスポンスは ErrorResponse 型になります。

このメソッドが HTTP 200 を返さない場合、このクエリに対するレスポンスは空になる可能性があります。攻撃者が他のインテグレーターの決済インテグレーターのアカウント ID を攻撃者が理解できるように、明確な説明付きの ErrorResponse を使用できる場合は、レスポンスの本文は空になります。署名鍵が一致しない、決済インテグレータの識別子が見つからない、暗号鍵が不明ななどの状況では、このメソッドは本文が空の HTTP 404 を返します。リクエストの署名が検証できた場合は、エラーに関する追加情報がレスポンスの本文で返されます。

リクエストの例を次に示します。


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

レスポンスの例を次に示します。


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

HTTP リクエスト

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

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
フィールド
requestHeader

object (RequestHeader)

必須: すべてのリクエストに共通のヘッダー。
paymentIntegratorAccountId

string

必須: 支払いが発生した決済インテグレータのアカウント ID。
disburseFundsRequestId

string

必須: この取引の一意の識別子。これは、このリクエストが関連付けられている disburseFunds 呼び出し中に Google が生成した requestId です。

これは最大 100 文字の文字列で、文字「a ～ z」、「A ～ Z」、「0 ～ 9」、「:」、「-」、「_」のみが含まれます。
disburseFundsResult

object (DisburseFundsResult)

必須: この支払いファンドの呼び出しの結果。

レスポンスの本文

disburseFundsResultNotification メソッドのレスポンス オブジェクト。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (DisburseFundsResultNotificationResultCode)
}
フィールド
responseHeader

object (ResponseHeader)

必須: すべてのレスポンスに共通のヘッダー。
result

enum (DisburseFundsResultNotificationResultCode)

必須: この呼び出しの結果。

DisburseFundsResult

支払いの最終結果に関する情報。

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.
}
フィールド
disburseFundsResultCode

enum (DisburseFundsResultCode)

必須: この支払いの結果コード。
rawResult

object (RawResult)

省略可: この支払いの未加工の結果。Google のリスクエンジンと分析への情報提供に使用されます。不承認コードがマッピングされている場合、データが失われることがあります。インテグレータは、Google に未加工のコードを渡すこともできます。たとえば、クレジット カード ゲートウェイ（インテグレータ）は、このフィールドを使用して、VISA ネットワークから受け取った正確な不承認コードを Google に伝えることができます。その場合、scope は「visa」になります。rawCode は、VISA ネットワークから返されたものになります。

result が SUCCESS でない場合、この値は必須です。

共用体フィールド FailureDetail。

FailureDetail は次のいずれかになります。
transactionMaxLimit

string (Int64Value format)

省略可: disburseFundsResultCode が DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT の場合、これは最大許容トランザクションの値です。これは、構造化されたユーザー向けのメッセージや不承認率の分析に使用されます。

この数値は、元の disburseFunds メソッド呼び出しと同じ currencyCode の micros です。
transactionMinLimit

string (Int64Value format)

省略可: disburseFundsResultCode が DISBURSEMENT_UNDER_TRANSACTION_LIMIT の場合、これは最小許容トランザクションの値です。これは、構造化されたユーザー向けのメッセージや不承認率の分析に使用されます。

この数値は、元の disburseFunds メソッド呼び出しと同じ currencyCode の micros です。

DisburseFundsResultCode

支払いファンドの呼び出しの結果コード。

列挙型
UNKNOWN_RESULT このデフォルト値は設定しないでください。
SUCCESS 支払いが正常に完了しました。
DISBURSEMENT_UNDER_TRANSACTION_LIMIT リクエストされた支払い額が、インテグレーターの 1 回の取引あたりの最小金額を満たしていません。このコードを使用する場合は、ユーザーにメッセージが表示されるように、transactionMinLimit フィールドに最小取引額を入力します。
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT リクエストされた支払い額が、インテグレータの 1 回の取引あたりの上限を超えています。このコードを使用する場合は、ユーザーにメッセージが表示されるように、transactionMaxLimit フィールドにトランザクションの上限を入力します。
ACCOUNT_CLOSED インテグレータが保持していたユーザーのアカウントが閉鎖されました。この戻り値により、ユーザーの支払い方法が Google でクローズされます。ユーザーは新しい支払い方法を追加せざるを得なくなります。
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER インテグレーターとやり取りしていたユーザーのアカウントは閉鎖されました。アカウントが乗っ取られた疑いがあります。この戻り値により、ユーザーの支払い方法が Google でクローズされます。ユーザーは新しい支払い方法を追加せざるを得なくなります。
ACCOUNT_CLOSED_FRAUD インテグレータが保持しているユーザーのアカウントは、不正行為により閉鎖されました。この戻り値により、ユーザーの支払い方法が Google でクローズされます。ユーザーは新しい支払い方法を追加せざるを得なくなります。
ACCOUNT_ON_HOLD お客様のアカウントは保留中です。

RawResult

未加工の結果オブジェクト。

JSON 表現 
{
  "scope": string,
  "rawCode": string
}
フィールド
scope

string

省略可: rawCode のスコープ。空にすることもできます。
rawCode

string

必須: インテグレータまたは内部のサブシステムからの未加工のコード。

DisburseFundsResultNotificationResultCode

disburseFundsResultNotification メソッドの結果コード。

列挙型
UNKNOWN_RESULT このデフォルト値は設定しないでください。
SUCCESS 通知は正常に処理されました。