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)

필수: 모든 응답의 공통 헤더입니다.
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의 마이크로입니다.
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

string

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

DisburseFundsResultNotificationResultCode

disburseFundsResultNotification 메서드의 결과 코드입니다.

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