Method: acceptRemittanceStatementWithModifications

به Google می‌گوید که صورت‌حساب نشان‌داده‌شده در این درخواست پس از انجام تغییراتی در صورت‌حساب، مانند هزینه‌ای برای طبقه‌بندی مجدد VAT، پرداخت می‌شود.

اگر نقطه پایانی هنگام پردازش درخواست با خطا مواجه شود، پاسخ این نقطه پایانی از نوع 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

الزامی است : شناسه درخواست اعلان بیانیه ای که این درخواست تغییر می دهد.

اتحادیه modification_type .

modification_type تنها می تواند یکی از موارد زیر باشد:

feeToVatModification

object ( FeeToVATModification )

الزامی : درخواست اصلاح برای تخصیص مجدد بخشی از هزینه ها به مالیات بر ارزش افزوده (VAT).

بدن پاسخگو

شی پاسخ برای روش acceptRemittanceStatementWithModifications .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
فیلدها
responseHeader

object ( ResponseHeader )

مورد نیاز : هدر مشترک برای همه پاسخ ها.

acceptRemittanceStatementWithModificationsResultCode

enum ( AcceptRemittanceStatementWithModificationsResultCode )

مورد نیاز : نتیجه تماس v1.acceptRemittanceStatement.

اصلاح FeeToVATM

این شی تغییرات مالیاتی را برای اعمال در صورت‌های حواله ارائه می‌کند.

نمایندگی JSON 
{
  "vatToFeeRatioInMicros": string
}
فیلدها
vatToFeeRatioInMicros

string ( Int64Value format)

مورد نیاز : نسبت مالیات بر ارزش افزوده به مبلغ کارمزد در میکرو. این درصد هزینه هایی است که باید دوباره به مالیات بر ارزش افزوده تخصیص داده شود و باید بیشتر یا مساوی صفر باشد. گرد کردن باید "نیمه زوج" یا "بانکدار" باشد، به معنای گرد کردن به همسایه زوج در صورتی که هر دو عدد از هم فاصله دارند (مثلاً 2.5 -> 2، 5.5 -> 6).

نمونه ای برای محاسبه مالیات به شرح زیر است:

  • هزینه پردازش شامل مالیات جمع آوری شده توسط یکپارچه کننده پرداخت: 1000 دلار
  • نرخ مالیات: 10%
  • بنابراین، 1000 دلار = (هزینه پردازش) + (10٪ * هزینه پردازش)
  • هزینه پردازش (بدون مالیات) = 1000 / 1.1 = 909.090909 USD
  • مالیات پرداخت شده توسط یکپارچه کننده پرداخت = 1000 - 909.090909 = 90.909091 USD
  • vatToFeeRatioInMicros = (90.909091 / 1000) * 1000000 = 90909.091
  • گرد کردن نیمه زوج در 90909.091 = 90909

Accept RemittanceStatementWithModificationsResultCode

Enums
UNKNOWN_RESULT هرگز این مقدار پیش فرض را تنظیم نکنید!
SUCCESS بیانیه حواله با تغییرات با موفقیت پذیرفته شد.
INVALID_VAT_MODIFICATION اصلاح VAT به دلیل یک درخواست نامعتبر پذیرفته نشد.