Method: disburseFundsResultNotification

disburseFunds 메서드를 호출한 후 지불 결과를 Google에 알립니다.

disburseFundsResult 값은 이 disburseFundsRequestId에 멱등성이므로, 그 값은 disburseFunds 호출 중에 반환된 값과 동일해야 하며 이 메서드에 대한 후속 호출로는 변경할 수 없습니다.

요청을 처리하는 동안 엔드포인트에서 오류가 발생하면 이 엔드포인트의 응답은 ErrorResponse 유형이 됩니다.

이 메서드가 HTTP 200을 반환하지 않는 경우 이 쿼리에 대한 응답이 비어 있을 수 있습니다. 명확한 설명이 포함된 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

필수: 지불이 발생한 결제 통합업체 계정 식별자입니다.
disburseFundsRequestId

string

필수: 이 거래의 고유 식별자입니다. 이 요청과 연결된 disburseFunds 호출 중에 Google이 생성한 requestId입니다.

최대 길이가 100자인 문자열이며 'a~z', 'A~Z', '0-9', ':', '-', '_' 문자만 포함됩니다.
disburseFundsResult

object (DisburseFundsResult)

REQUIRED: 지불 대금 지급 호출의 결과입니다.

응답 본문

disburseFundsResultNotification 메서드의 응답 객체입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (DisburseFundsResultNotificationResultCode)
}
필드
responseHeader

object (ResponseHeader)

REQUIRED: 모든 응답의 공통 헤더입니다.
result

enum (DisburseFundsResultNotificationResultCode)

REQUIRED: 이 호출의 결과입니다.

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)

REQUIRED: 지급의 결과 코드입니다.
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의 마이크로입니다.
transactionMinLimit

string (Int64Value format)

선택사항: disburseFundsResultCode이 DISBURSEMENT_UNDER_TRANSACTION_LIMIT이면 허용되는 최소 거래의 값입니다. 구조화된 사용자 대상 메시지 및 거부율 분석에 사용됩니다.

이 금액은 원래 disburseFunds 메서드 호출과 동일한 currencyCode의 마이크로입니다.

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 사용자의 계정이 보류 중입니다.

RawResult

원시 결과 객체입니다.

JSON 표현 
{
  "scope": string,
  "rawCode": string
}
필드
scope

string

선택사항: rawCode의 범위이며 비워둘 수 있습니다.
rawCode

string

필수: 통합업체 또는 그 내부의 하위 시스템의 원시 코드입니다.

DisburseFundsResultNotificationResultCode

disburseFundsResultNotification 메서드의 결과 코드

열거형
UNKNOWN_RESULT 이 기본값을 설정하면 안 됩니다.
SUCCESS 알림이 성공적으로 처리되었습니다.