Method: acceptRemittanceStatementWithModifications

Bu talepte belirtilen beyanın, beyanda KDV yeniden sınıflandırma ücreti gibi değişiklikler yapıldıktan sonra ödeneceğini Google'a bildirir.

Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktadan gelen yanıt ErrorResponse türünde olur.

Bu yöntem HTTP 200 döndürmezse bu sorguya verilen yanıtlar boş olabilir. Açık açıklamaya sahip bir ErrorResponse, saldırganların diğer entegratörlerin ödeme entegrasyon hesap tanımlayıcılarını anlamasına yardımcı olmak için kullanılabileceği durumlarda yanıt gövdesi boştur. İmzalama anahtarının eşleşmediği, ödeme entegratörü tanımlayıcısının bulunamadığı veya şifreleme anahtarının bilinmediği durumlarda bu yöntem, gövdesi boş bir HTTP 404 döndürür. İstek imzası doğrulanabilirse yanıt gövdesinde hatayla ilgili ek bilgiler döndürülür.

Örnek istek:


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

Örnek bir yanıt aşağıdaki gibidir:


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

HTTP isteği

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

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "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.
}
Alanlar
requestHeader

object (RequestHeader)

ZORUNLU: Tüm istekler için ortak başlık.
paymentIntegratorAccountId

string

ZORUNLU: Bu ekstreyle ilgili sözleşmeden doğan kısıtlamaları tanımlayan ödeme entegratörü hesap tanımlayıcısıdır.
statementId

string

ZORUNLU: Bu isteğin değiştirdiği ekstre bildiriminin istek kimliği.

Birleştirme alanı modification_type.

modification_type şunlardan yalnızca biri olabilir:
feeToVatModification

object (FeeToVATModification)

ZORUNLU: Ücretlerin bir kısmının katma değer vergisiyle (KDV) yeniden ilişkilendirilmesi için değişiklik istendi.

Yanıt gövdesi

acceptRemittanceStatementWithModifications yöntemi için yanıt nesnesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Alanlar
responseHeader

object (ResponseHeader)

ZORUNLU: Tüm yanıtlar için ortak başlık.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

ZORUNLU: v1.acceptRemittanceStatement çağrısının sonucu.

FeeToVATModification

Bu nesne, havale ekstrelerine uygulanacak vergi değişiklikleri sağlar.

JSON gösterimi 
{
  "vatToFeeRatioInMicros": string
}
Alanlar
vatToFeeRatioInMicros

string (Int64Value format)

ZORUNLU: KDV'nin Ücret tutarına oranı (mikrosaniye cinsinden). Bu, KDV'nin yeniden ilişkilendirilecek ücretlerin yüzdesidir. Sıfırdan büyük veya sıfıra eşit olması gerekir. Yuvarlama "yarım çift" olmalıdır "bankanın" yuvarlama (iki sayının da eşit olması durumunda çift komşuya yuvarlama), yani, yuvarlama (ör. 2,5 -> 2, 5,5 -> 6).

Verginin hesaplanmasına ilişkin bir örnek aşağıda verilmiştir:

  • Ödeme entegratörü tarafından alınan vergi dahil işlem ücreti: 1.000 ABD doları
  • Vergi oranı: %10
  • Bu durumda, 1000 ABD doları = (işlem ücreti) + (%10 * işlem ücreti)
  • İşlem ücreti (sans vergisi) = 1.000 / 1,1 = 909,090909 ABD doları
  • Ödeme entegrasyon uzmanı tarafından ödenen vergi = 1000 - 909,090909 = 90,909091 ABD doları
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • 90909,091'de yarı eşit yuvarlama = 90909

AcceptRemittanceStatementWithModificationsResultCode

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri asla ayarlamayın.
SUCCESS Havale beyanı, değişikliklerle birlikte başarıyla kabul edildi.
INVALID_VAT_MODIFICATION KDV değişikliği, geçersiz bir istek nedeniyle kabul edilmedi.