Method: acceptRemittanceStatementWithModifications

Google wird mitgeteilt, dass die in dieser Anfrage angegebene Abrechnung nach einer Änderung der Abrechnung, wie z. B. Gebühr für die Änderung der Umsatzsteuer, bezahlt wird.

Wenn beim Verarbeiten der Anfrage ein Fehler auftritt, hat die Antwort vom Endpunkt ErrorResponse.

Die Antworten auf diese Abfrage können leer sein, wenn die Methode kein HTTP 200 zurückgibt. Der Antworttext ist leer, wenn ein ErrorResponse mit einer klaren Beschreibung verwendet werden könnte, um einem Angreifer die Identifizierung des Zahlungsintegrators mit anderen Integratoren zu erleichtern. Wenn der Signaturschlüssel nicht übereinstimmt, die Zahlungsintegrations-ID nicht gefunden wurde oder der Verschlüsselungsschlüssel unbekannt ist, gibt diese Methode einen HTTP 404-Code mit leerem Text zurück. Wenn die Anfragesignatur verifiziert werden kann, werden zusätzliche Informationen zum Fehler im Antworttext zurückgegeben.

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)

REQUIRED: Allgemeiner Header für alle Anfragen.
paymentIntegratorAccountId

string

ERFORDERLICH: Das ist die Kennung des Zahlungsintegrators, mit der vertragliche Einschränkungen für diese Abrechnung identifiziert werden.
statementId

string

ERFORDERLICH: Die ID der Anfragebenachrichtigung, die durch diese Anfrage geändert wird.

Union-Feld modification_type.

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

object (FeeToVATModification)

ERFORDERLICH: Es wurde eine Änderung angefordert, um einen Teil der Gebühren der Umsatzsteuer 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)

ERFORDERLICH: Ergebnis des Aufrufs v1.acceptRemittanceStatement.

Änderung der Gebühr toMwSt.

Dieses Objekt umfasst steuerliche Änderungen, die auf Überweisungen angewendet werden müssen.

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

string (Int64Value format)

ERFORDERLICH: Verhältnis von Umsatzsteuer zu Gebühren in Micros. Dies ist der Prozentsatz der Gebühren, der auf die Mehrwertsteuer angerechnet werden soll. Er muss größer oder gleich null sein. Die Rundung sollte auf „Halbton“ oder „Banker“ gerundet werden. Das bedeutet, dass beide Zahlen in gleichmäßigen Rundungen liegen, z. B. 2,5 -> 2, 5,5 -> 6.

Hier ein Beispiel für die Berechnung der Steuer:

  • Vom Zahlungsintegrator erhobene Bearbeitungsgebühr inklusive Steuern: 1.000 $
  • Steuersatz: 10%
  • (1.000 € = (Bearbeitungsgebühr) + (10 % × Verarbeitungsgebühr)
  • Bearbeitungsgebühr (Bonatsteuer) = 1.000 / 1,1 = 909,090909 USD
  • Vom Zahlungsintegrator gezahlte Steuer = 1.000 – 909.090909 = 90,909091 USD
  • vatToFeeRatioInMicros = (90.909091 / 1000) × 1000000 = 90909,091
  • Halbe Rundung bei 90909,091 = 90909

AnnehmenRemittanceStatementWithChangesResultCode

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert nie fest.
SUCCESS Die Überweisung wurde bei Änderungen erfolgreich akzeptiert.
INVALID_VAT_MODIFICATION Die Änderung der Umsatzsteuer wurde aufgrund eines ungültigen Antrags nicht akzeptiert.