Method: acceptRemittanceStatementWithModifications

Hiermit wird Google mitgeteilt, dass der in diesem Antrag angegebene Auszug bezahlt wird, nachdem Änderungen daran vorgenommen wurden, z. B. die Gebühr für die Reklassifizierung der Mehrwertsteuer.

Wenn am Endpunkt bei der Verarbeitung der Anfrage ein Fehler auftritt, ist die Antwort dieses Endpunkts vom Typ ErrorResponse.

Die Antworten auf diese Abfrage sind möglicherweise leer, wenn diese Methode keinen HTTP 200-Fehler zurückgibt. Der Antworttext ist leer, wenn ein ErrorResponse mit einer eindeutigen Beschreibung verwendet werden könnte, um einem Angreifer zu helfen, die Kennung des Zahlungsintegrators anderer Integratoren zu verstehen. In Situationen, in denen der Signaturschlüssel nicht übereinstimmt, die Zahlungsintegrator-ID nicht gefunden wurde oder der Verschlüsselungsschlüssel unbekannt war, gibt diese Methode einen HTTP 404-Fehler mit einem leeren Text zurück. Wenn die Anfragesignatur verifiziert werden konnte, werden im Antworttext zusätzliche Informationen zum Fehler 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)

ERFORDERLICH: Gemeinsamer Header für alle Anfragen.
paymentIntegratorAccountId

string

ERFORDERLICH: Dies ist die Konto-ID des Zahlungsintegrators, die vertragliche Einschränkungen für diese Anweisung angibt.
statementId

string

ERFORDERLICH: Anfrage-ID der Anweisungsbenachrichtigung, 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: Die angeforderte Änderung, damit ein Teil der Gebühren der Mehrwertsteuer (MwSt.) zugeordnet wird.

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)

ERFORDERLICH: Gemeinsamer Header für alle Antworten.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

REQUIRED: Ergebnis des Aufrufs „v1.acceptRemittanceStatement“.

FeeToVATModification

Dieses Objekt enthält Steueränderungen, die auf Überweisungen angewendet werden sollen.

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

string (Int64Value format)

ERFORDERLICH: Verhältnis zwischen Mehrwertsteuer und Gebührenbetrag in Mikros. Der Prozentsatz der Gebühren, die auf die Umsatzsteuer umgerechnet werden können. Er muss größer oder gleich null sein. Die Rundung sollte halb gerade sein. oder „banker“ Rundung, d.h., auf den geraden Nachbarn gerundet, wenn beide Zahlen gleich weit voneinander entfernt sind (z.B.2,5 -> 2, 5,5 -> 6).

Im Folgenden finden Sie ein Beispiel für die Berechnung der Steuer:

  • Vom Zahlungsintegrator erhobene Bearbeitungsgebühr inklusive Steuern: 1.000 $
  • Steuersatz: 10%
  • 1.000 € = (Bearbeitungsgebühr) + (10 % × Bearbeitungsgebühr)
  • Bearbeitungsgebühr = 1.000 / 1,1 = 909,090909 $
  • Vom Payment Integrator gezahlte Steuer = 1.000 – 909.090909 = 90,909091 $
  • vatToFeeRatioInMicros = (90,909091 ÷ 1.000) × 1000000 = 90.909,091
  • Halbgleiche Rundung bei 90909,091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert niemals fest.
SUCCESS Überweisungsbescheid wurde mit Änderungen akzeptiert.
INVALID_VAT_MODIFICATION Die Umsatzsteuer-Änderung wurde aufgrund einer ungültigen Anfrage nicht akzeptiert.