- HTTP リクエスト
- リクエストの本文
- レスポンスの本文
- DisburseFundsResult
- DisburseFundsResultCode
- RawResult
- DisburseFundsResultNotificationResultCode
disburseFunds
メソッドの呼び出しが行われた後で、支払いの結果を Google に通知します。
disburseFundsResult
値はこの disburseFundsRequestId
のべき等であるため、その値は disburseFunds
呼び出しで返される値と同じでなければならず、このメソッドの後続の呼び出しでは変更できません。
エンドポイントでリクエストの処理中にエラーが発生した場合、このエンドポイントからのレスポンスは
型になります。ErrorResponse
このメソッドが HTTP 200 を返さない場合、このクエリへのレスポンスは空になる可能性があります。攻撃者が他のインテグレータの支払いインテグレータのアカウント識別子を理解できるように、明確な説明がある
を使用できる場合は、レスポンス本文が空になります。署名鍵が一致しない場合、支払いインテグレータ識別子が見つからなかった場合、または暗号鍵が不明な場合、このメソッドは空の本文を含む HTTP 404 を返します。リクエスト署名が確認されると、レスポンス本文にエラーに関する追加情報が返されます。ErrorResponse
リクエストの例を次に示します。
{
"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 |
必須: 支払いが発生したインテグレーターのアカウント ID。 |
disburseFundsRequestId |
必須: この取引の一意の識別子。これは、このリクエストが関連付けられている 最大 100 文字までの文字列で、「a-z」、「A-Z」、「0-9」、「:」、「-」、「_」の文字のみが含まれます。 |
disburseFundsResult |
必須: この支払いファンドのコールの結果。 |
レスポンスの本文
disburseFundsResultNotification
メソッドのレスポンス オブジェクト。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "responseHeader": { object ( |
フィールド | |
---|---|
responseHeader |
必須: すべてのレスポンスに共通するヘッダーです。 |
result |
必須: この呼び出しの結果。 |
DisburseFundsResult
お支払いの最終結果に関する情報。
JSON 表現 |
---|
{ "disburseFundsResultCode": enum ( |
フィールド | |
---|---|
disburseFundsResultCode |
必須: この支払いの結果コード。 |
rawResult |
省略可: この支払いの未加工の結果。Google のリスクエンジンと分析に通知するために使用されます。不承認のコードのマッピングが行われた場合、データが失われることがあります。インテグレータは、Google に未加工のコードを与えることもできます。たとえば、クレジット カード ゲートウェイ(インテグレータ)は、このフィールドを使用して、VISA ネットワークから受け取った正確な不承認コードを Google に通知できます。この場合、
|
共用体フィールド
|
|
transactionMaxLimit |
省略可: この金額は、元の |
transactionMinLimit |
省略可: この金額は、元の |
DisburseFundsResultCode
支払いファンド呼び出しの結果コード。
列挙型 | |
---|---|
UNKNOWN_RESULT |
このデフォルト値を設定しないでください。 |
SUCCESS |
お支払いが完了しました。 |
DISBURSEMENT_UNDER_TRANSACTION_LIMIT |
リクエストされた支払い額がインテグレーターの最小取引額に達していません。このコードを使用する場合は、transactionMinLimit フィールドに、ユーザー メッセージングのための最小取引金額を入力します。 |
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT |
リクエストされた支払い額がインテグレーターの取引あたりの上限を超えています。このコードを使用する場合は、transactionMaxLimit フィールドに、ユーザー メッセージ用の取引上限を入力します。 |
ACCOUNT_CLOSED |
インテグレーターが保有するユーザーのアカウントが閉鎖されています。この戻り値により、ユーザーの支払い方法が Google で閉じられます。ユーザーは新しい支払い方法を追加するよう求められます。 |
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER |
インテグレーターのアカウントは閉鎖されています。アカウントが引き継がれたようです。この戻り値により、ユーザーの支払い方法が Google で閉じられます。ユーザーは新しい支払い方法を追加するよう求められます。 |
ACCOUNT_CLOSED_FRAUD |
インテグレーターが保有するユーザーのアカウントは、不正行為により閉鎖されました。この戻り値により、ユーザーの支払い方法が Google で閉じられます。ユーザーは新しい支払い方法を追加するよう求められます。 |
ACCOUNT_ON_HOLD |
お客様のアカウントは保留中です。 |
未加工の結果
未加工の結果オブジェクト。
JSON 表現 |
---|
{ "scope": string, "rawCode": string } |
フィールド | |
---|---|
scope |
省略可: rawCode のスコープは空にできます。 |
rawCode |
必須: インテグレータまたはそれ内のサブシステムからの未加工コード。 |
DisburseFundsResultNotificationResultCode
disburseFundsResultNotification
メソッドの結果コード。
列挙型 | |
---|---|
UNKNOWN_RESULT |
このデフォルト値を設定しないでください。 |
SUCCESS |
通知が正常に処理されました。 |