Method: acceptRemittanceStatementWithModifications

Teilt Google mit, dass die in diesem Antrag angegebene Abrechnung bezahlt wird, nachdem Änderungen daran vorgenommen wurden, z. B. Gebühren für die Umklassifizierung der Umsatzsteuer.

Die Antworten auf diese Abfrage können leer sein, wenn diese Methode keinen HTTP 200-Fehler zurückgibt. Sie sind leer, wenn ein ErrorResponse mit einer eindeutigen Beschreibung verwendet werden könnte, um einem Angreifer zu helfen, die Zahlungsintegrator-Konto-ID anderer Integratoren zu verstehen. In Fällen, in denen der Signaturschlüssel nicht übereinstimmt oder der Verschlüsselungsschlüssel unbekannt war, gibt diese Methode einen HTTP 404-Fehler mit leerem Text zurück.

Eine Beispielanfrage sieht so aus:


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

Eine Beispielantwort sieht so aus:


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

HTTP-Anfrage

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "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.
}
Felder
requestHeader

object (RequestHeader)

ERFORDERLICH: Allgemeiner Header für alle Anfragen.
paymentIntegratorAccountId

string

ERFORDERLICH: Dies ist die Zahlungsintegrationskonto-ID, die vertragliche Einschränkungen für diese Abrechnung angibt.
statementId

string

REQUIRED: Anfrage-ID der Kontoauszugsbenachrichtigung, die diese Anfrage ändert.

Union-Feld modification_type.

Für modification_type ist nur einer der folgenden Werte zulässig:
feeToVatModification

object (FeeToVATModification)

ERFORDERLICH: Angeforderte Änderung, um einen Teil der Gebühren der Mehrwertsteuer (MwSt.) zuzuordnen.

Antworttext

Antwortobjekt für die Methode acceptRemittanceStatementWithModifications.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Felder
responseHeader

object (ResponseHeader)

REQUIRED: Allgemeiner Header für alle Antworten.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

REQUIRED: Ergebnis des v1.acceptRemittanceStatement-Aufrufs.

FeeToVATModification

Dieses Objekt enthält Steueränderungen, die auf Kontoauszüge angewendet werden können.

JSON-Darstellung 
{
  "vatToFeeRatioInMicros": string
}
Felder
vatToFeeRatioInMicros

string (Int64Value format)

ERFORDERLICH: Verhältnis von Mehrwertsteuer zu Gebührenbetrag in Mikros. Dies ist der Prozentsatz der Gebühren, der der Mehrwertsteuer zugeordnet werden soll. Er muss größer oder gleich null sein. Die Rundung sollte „halb gerade“ oder „banker“ sein, d.h. auf den geraden Nachbarn gerundet werden, wenn beide Zahlen äquidistant sind (z.B.2,5 -> 2, 5,5 -> 6).

Hier ein Beispiel für die Steuerberechnung:

  • Bearbeitungsgebühr inklusive Steuern, die vom Zahlungsintegrator erhoben wird: 1.000 $
  • Steuersatz: 10%
  • Das heißt, 1.000 $ = (Bearbeitungsgebühr) + (10% * Bearbeitungsgebühr)
  • Bearbeitungsgebühr (ohne Steuern) = 1.000 ÷ 1,1 = 909,090909 $
  • Vom Zahlungsintegrator gezahlte Steuer = 1.000 - 909,090909 = 90,909091 USD
  • vatToFeeRatioInMicros = (90,909091 ÷ 1.000) × 1000000 = 90909,091
  • Halbgerade Rundung auf 90909,091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert niemals fest!
SUCCESS Überweisungsanweisung akzeptiert, Änderungen erfolgreich abgeschlossen.
INVALID_VAT_MODIFICATION Die Änderung der Mehrwertsteuer wurde aufgrund einer ungültigen Anforderung nicht akzeptiert.