Method: acceptRemittanceStatementWithModifications

Thông báo cho Google biết bảng sao kê trong yêu cầu này sẽ được thanh toán sau khi sửa đổi, chẳng hạn như phí phân loại lại VAT.

Nếu điểm cuối gặp lỗi trong khi xử lý yêu cầu, thì phản hồi từ điểm cuối này sẽ thuộc loại ErrorResponse.

Các phản hồi cho truy vấn này có thể trống nếu phương thức này không trả về HTTP 200. Nội dung phản hồi bị trống trong các tình huống mà ErrorResponse có nội dung mô tả rõ ràng có thể được sử dụng để giúp kẻ tấn công hiểu giá trị nhận dạng tài khoản của nhà tích hợp thanh toán của các nhà tích hợp khác. Trong các trường hợp này, khi khoá ký không khớp, không tìm thấy giá trị nhận dạng nhà tích hợp thanh toán hoặc khoá mã hoá, phương thức này sẽ trả về HTTP 404 không có mã. Nếu có thể xác minh chữ ký yêu cầu, thông tin bổ sung về lỗi sẽ được trả về nội dung phản hồi.

Một yêu cầu mẫu có dạng như sau:


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

Một phản hồi mẫu sẽ có dạng như sau:


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

Yêu cầu HTTP

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc như sau:

Biểu diễn dưới dạng 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.
}
Các trường
requestHeader

object (RequestHeader)

BẮT BUỘC: Tiêu đề chung cho tất cả các yêu cầu.
paymentIntegratorAccountId

string

BẮT BUỘC: Đây là mã định danh tài khoản tích hợp thanh toán xác định ràng buộc hợp đồng xung quanh bảng sao kê này.
statementId

string

BẮT BUỘC: ID yêu cầu của thông báo tuyên bố mà yêu cầu này sửa đổi.

Trường nhóm modification_type.

modification_type chỉ có thể là một trong những loại sau đây:
feeToVatModification

object (FeeToVATModification)

BẮT BUỘC: Yêu cầu sửa đổi để phân bổ lại một phần phí cho thuế giá trị gia tăng (VAT).

Nội dung phản hồi

Đối tượng phản hồi cho phương thức acceptRemittanceStatementWithModifications.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Các trường
responseHeader

object (ResponseHeader)

BẮT BUỘC: Tiêu đề chung cho tất cả các phản hồi.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

BẮT BUỘC: Kết quả của lệnh gọi v1.AcceptRemittanceStatement.

Sửa đổi phí VAT

Đối tượng này cung cấp các nội dung sửa đổi về thuế sẽ áp dụng cho bảng sao kê chuyển tiền.

Biểu diễn dưới dạng JSON 
{
  "vatToFeeRatioInMicros": string
}
Các trường
vatToFeeRatioInMicros

string (Int64Value format)

BẮT BUỘC: Tỷ lệ VAT với số tiền Phí theo micro. Đây là tỷ lệ phần trăm phí để quy lại thuế VAT và phải lớn hơn hoặc bằng 0. Làm tròn phải là "một nửa chẵn" hoặc "ngân hàng" làm tròn, nghĩa là làm tròn đến hàng xóm đồng đều trong trường hợp cả hai số đều bằng nhau (ví dụ: 2,5 -> 2, 5,5 -> 6).

Dưới đây là ví dụ về cách tính thuế:

  • Phí xử lý bao gồm thuế do nhà tích hợp thanh toán thu: 1000 USD
  • Thuế suất: 10%
  • Như vậy, 1000 USD = (phí xử lý) + (10% * phí xử lý)
  • Phí xử lý (thuế sans) = 1000 / 1.1 = 909.090909 USD
  • Thuế trả bằng nhà tích hợp thanh toán = 1000 - 909.090909 = 90,909091 USD
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • Làm tròn một nửa chẵn trên 90909.091 = 90909

AcceptRemittanceStatementWithModifyResultCode

Enum
UNKNOWN_RESULT Không bao giờ đặt giá trị mặc định này!
SUCCESS Đã chấp nhận bản sao kê chuyển tiền có nội dung sửa đổi.
INVALID_VAT_MODIFICATION Sửa đổi VAT không được chấp nhận do yêu cầu không hợp lệ.