Method: remittanceStatementNotification

새 송금 명세서의 통합자에게 알립니다.

명세서 알림은 Google이 통합업체에 지불할 금액 또는 통합업체가 Google에 진 금이 있음을 나타내는 새로운 명세서가 발생할 때마다 발생합니다.

통합업체가 성공을 반환하면 이 명세서는 수락된 상태이고 수익금이 제공된다고 가정합니다.

또한 requestId는 다른 곳에서 사용되는 문 ID입니다. 헤더와 paymentIntegratorAccountId 내의 requestId 조합은 멱등성 키이며 이 문을 고유하게 식별합니다.

요청을 처리하는 중에 엔드포인트에서 오류가 발생하면 이 엔드포인트의 응답 본문은 ErrorResponse 유형이어야 합니다.

요청의 예는 다음과 같습니다.


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-statement-abc",
    "requestTimestamp": "1502632800000"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "remittanceStatementSummary": {
    "statementDate": "1502607600000",
    "billingPeriod": {
      "startDate": "1502434800000",
      "endDate": "1502521199000"
    },
    "dateDue": "1503212400000",
    "currencyCode": "INR",
    "totalDueByIntegrator": "1076000000",
    "remittanceInstructions": {
      "memoLineId": "stmt-1AB-pp0-invisi"
    }
  }
}

응답 예시는 다음과 같습니다.


{
  "responseHeader": {
    "responseTimestamp": "1502632802000"
  },
  "paymentIntegratorStatementId": "334a",
  "result": "ACCEPTED"
}

HTTP 요청

POST https://www.integratorhost.example.com/v1/remittanceStatementNotification

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "remittanceStatementSummary": {
    object (RemittanceStatementSummary)
  }
}
필드
requestHeader

object (RequestHeader)

필수: 모든 요청의 공통 헤더입니다.
paymentIntegratorAccountId

string

필수: 이 명세서와의 계약상 제약을 식별하는 결제 통합업체 계정 식별자입니다.
remittanceStatementSummary

object (RemittanceStatementSummary)

필수: 송금 명세서 요약

응답 본문

송금 명세서 알림 메서드의 응답 객체입니다.

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

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

object (ResponseHeader)

필수: 모든 응답의 공통 헤더입니다.
paymentIntegratorStatementId

string

필수: 통합자가 이 문을 알고 있는 식별자입니다. 통합업체가 생성됩니다.
result

enum (StatementNotificationResultCode)

필수: 이 문 알림의 결과입니다.

RemittanceStatementSummary 클래스의 생성자

송금 명세서의 요약 객체입니다.

JSON 표현 
{
  "statementDate": string,
  "billingPeriod": {
    object (BillingPeriod)
  },
  "dateDue": string,
  "currencyCode": string,
  "totalDueByIntegrator": string,
  "remittanceInstructions": {
    object (RemittanceInstructions)
  }
}
필드
statementDate

string (int64 format)

필수: 이 명세서가 작성된 날짜입니다 (미국/로스앤젤레스).
billingPeriod

object (BillingPeriod)

필수: 이 명세서에 포함된 결제 기간입니다.
dateDue

string (int64 format)

선택사항: 송금 기한입니다. 에포크로부터 밀리초로 표시됩니다. 날짜입니다 (따라서 항상 결제 시간대에서 하루의 처음 밀리초로 시작함).

totalDueByIntegrator이 0보다 큰 경우 설정됩니다.
currencyCode

string

필수: 3자리 ISO 4217 통화 코드입니다.
totalDueByIntegrator

string (Int64Value format)

필수: 이 값은 마이크로 통화이며 currencyCode 통화로 표시됩니다. 이 값은 항상 양수입니다.
remittanceInstructions

object (RemittanceInstructions)

필수: 결제 방법 세부정보

결제 기간

이 명세서의 결제 기간입니다.

JSON 표현 
{
  "startDate": string,
  "endDate": string
}
필드
startDate

string (int64 format)

필수: 결제 기간의 시작일입니다. 에포크로부터 밀리초로 표시됩니다. 날짜입니다 (따라서 항상 결제 시간대에서 하루의 처음 밀리초로 시작함).

결제 기간의 첫 밀리초인 00:00:00.000입니다.
endDate

string (int64 format)

필수: 결제 기간의 종료일입니다. 에포크로부터 밀리초로 표시됩니다.

결제 기간의 마지막 날인 23:59:59.999의 마지막 밀리초입니다.

송금 안내

송금 알림 결제 방법에 대한 정보가 포함된 구조

JSON 표현 
{
  "memoLineId": string
}
필드
memoLineId

string

필수: 송금 식별을 위해 결제 금액을 메모하기 위해 반드시 입력해야 하는 식별자입니다.

StatementNotificationResultCode

문 알림에 대한 결과 코드입니다.

열거형
UNKNOWN_RESULT 이 기본값을 설정하면 안 됩니다.
ACCEPTED 통합자가 이 진술문을 수락했습니다.