Method: acceptRemittanceStatementWithModifications

이 요청에 표시된 명세서는 VAT 재분류 수수료 등 명세서가 수정된 후 지불된다는 사실을 Google에 알립니다.

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

이 메서드가 HTTP 200을 반환하지 않는 경우 이 쿼리에 대한 응답이 비어 있을 수 있습니다. 명확한 설명이 포함된 ErrorResponse를 사용하여 공격자가 다른 통합업체의 결제 통합업체 계정 식별자를 이해할 수 있는 상황에서는 응답 본문이 비어 있습니다. 서명 키가 일치하지 않거나 결제 통합업체 식별자를 찾을 수 없거나 암호화 키를 알 수 없는 경우 이 메서드는 본문이 비어 있는 HTTP 404를 반환합니다. 요청 서명을 확인할 수 있는 경우 오류에 관한 추가 정보가 응답 본문에 반환됩니다.

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-abc",
    "requestTimestamp": "1502545413098"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "statementId": "0123434-statement-abc",
  "feeToVatModification": {
    "vatToFeeRatioInMicros": "150000"
  }
}

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


{
  "responseHeader": {
    "responseTimestamp": "1519996752221"
  },
  "acceptRemittanceStatementWithModificationsResultCode": "SUCCESS"
}

HTTP 요청

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

요청 본문

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

JSON 표현 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "statementId": string,

  // Union field modification_type can be only one of the following:
  "feeToVatModification": {
    object (FeeToVATModification)
  }
  // End of list of possible types for union field modification_type.
}
필드
requestHeader

object (RequestHeader)

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

string

필수: 이 명세서에 관한 계약상의 제약 조건을 나타내는 결제 통합업체 계정 식별자입니다.
statementId

string

필수: 이 요청에서 수정하는 문 알림의 요청 ID입니다.

통합 필드 modification_type.

modification_type는 다음 중 하나여야 합니다.
feeToVatModification

object (FeeToVATModification)

필수: 수수료의 일부를 부가가치세 (VAT)로 재기여하기 위한 수정을 요청했습니다.

응답 본문

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

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

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

object (ResponseHeader)

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

enum (AcceptRemittanceStatementWithModificationsResultCode)

필수: v1.acceptRemittanceStatement 호출의 결과입니다.

FeeToVATModification

이 객체는 송금 명세서에 적용될 세금 수정을 제공합니다.

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

string (Int64Value format)

필수사항: 수수료 금액 대비 VAT의 비율(단위: 마이크로)입니다. VAT로 재기여할 수수료의 비율이며 0 이상이어야 합니다. 반올림은 '반짝 짝수'여야 합니다. 또는 'banker's' 반올림, 즉 두 숫자가 등거리에 있는 경우 짝수 이웃에 반올림합니다 (예: 2.5 -> 2, 5.5 -> 6).

세금 계산을 위한 샘플은 다음과 같습니다.

  • 결제 통합업체가 청구하는 세금 포함 처리 수수료: 1,000달러(USD)
  • 세율: 10%
  • 따라서 1, 000달러(USD) = (처리 수수료) + (10% * 처리 수수료)
  • 처리 수수료 (상세) = 1000 / 1.1 = 909.090909 USD
  • 결제 통합업체가 납부한 세금 = 1000 - 909.090909 = 90.909091 USD
  • vatToFeeRatioInMicros = (90.909091 / 1000) * 1000000 = 90909.091
  • 90909.091의 반만 반올림 = 90909

AcceptRemittanceStatementWithModificationsResultCode

열거형
UNKNOWN_RESULT 이 기본값을 설정하면 안 됩니다.
SUCCESS 수정된 송금 명세서가 수락되었습니다.
INVALID_VAT_MODIFICATION 잘못된 요청으로 인해 VAT 수정이 승인되지 않았습니다.