Method: remittanceStatementNotification

Benachrichtigt den Integrator einer neuen Überweisungserklärung.

Es wird jedes Mal eine Benachrichtigung angezeigt, wenn Google mit der Erstellung einer neuen Erklärung beglaubigt, dass Google dem Integrationspartner bezahlt, oder die Summe, die der Integrator Google schuldet.

Wird vom Integrationspartner ein Erfolg zurückgegeben, wird angenommen, dass die Aussage akzeptiert wurde und bezahlt wird.

requestId ist auch die Anweisungs-ID (wird an anderer Stelle verwendet). Die Kombination aus requestId im Header und paymentIntegratorAccountId ist der Idempotenzschlüssel und dient zur eindeutigen Identifizierung dieser Anweisung.

Wenn der Endpunkt bei der Verarbeitung der Anfrage auf einen Fehler stößt, sollte der Antworttext dieses Endpunkts vom Typ ErrorResponse sein.

Eine Beispielanfrage sieht so aus:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-statement-abc",
    "requestTimestamp": "1502632800000"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "remittanceStatementSummary": {
    "statementDate": "1502607600000",
    "billingPeriod": {
      "startDate": "1502434800000",
      "endDate": "1502521199000"
    },
    "dateDue": "1503212400000",
    "currencyCode": "INR",
    "totalDueByIntegrator": "1076000000",
    "remittanceInstructions": {
      "memoLineId": "stmt-1AB-pp0-invisi"
    }
  }
}

Eine Beispielantwort sieht so aus:


{
  "responseHeader": {
    "responseTimestamp": "1502632802000"
  },
  "paymentIntegratorStatementId": "334a",
  "result": "ACCEPTED"
}

HTTP-Anfrage

POST https://www.integratorhost.example.com/v1/remittanceStatementNotification

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "remittanceStatementSummary": {
    object (RemittanceStatementSummary)
  }
}
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.
remittanceStatementSummary

object (RemittanceStatementSummary)

ERFORDERLICH: Zusammenfassung dieser Überweisungsabrechnung

Antworttext

Antwortobjekt für die Benachrichtigungsmethode für die Überweisungsabrechnung.

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

JSON-Darstellung 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "paymentIntegratorStatementId": string,
  "result": enum (StatementNotificationResultCode)
}
Felder
responseHeader

object (ResponseHeader)

REQUIRED: Allgemeiner Header für alle Antworten.
paymentIntegratorStatementId

string

ERFORDERLICH: Die ID, die der Integrator kennt, kennt diese Aussage. Dies wurde vom Integrationsintegrator generiert.
result

enum (StatementNotificationResultCode)

ERFORDERLICH: Das Ergebnis dieser Benachrichtigung.

Überweisungsübersicht

Zusammenfassungsobjekt für eine Überweisung.

JSON-Darstellung 
{
  "statementDate": string,
  "billingPeriod": {
    object (BillingPeriod)
  },
  "dateDue": string,
  "currencyCode": string,
  "totalDueByIntegrator": string,
  "remittanceInstructions": {
    object (RemittanceInstructions)
  }
}
Felder
statementDate

string (int64 format)

ERFORDERLICH: Das Datum, an dem diese Anweisung erstellt wurde (in Amerika/Los Angeles).
billingPeriod

object (BillingPeriod)

ERFORDERLICH: Der Abrechnungszeitraum, der in dieser Abrechnung enthalten ist.
dateDue

string (int64 format)

OPTIONAL: Datum, an dem die Überweisung fällig ist Dies wird in Millisekunden seit Epoche dargestellt. Es handelt sich dabei um ein Datum, das immer zur ersten Millisekunde des Tages in der Zeitzone der Abrechnung beginnt.

Dies wird festgelegt, solange totalDueByIntegrator größer als 0 ist.
currencyCode

string

ERFORDERLICH: Der dreistellige Währungscode nach ISO 4217.
totalDueByIntegrator

string (Int64Value format)

REQUIRED: Dieser Wert ist in Micros in der Währung currencyCode angegeben. Dieser Wert ist immer positiv.
remittanceInstructions

object (RemittanceInstructions)

ERFORDERLICH: Details zur Überweisung

Abrechnungszeitraum

Abrechnungszeitraum dieses Kontoauszugs

JSON-Darstellung 
{
  "startDate": string,
  "endDate": string
}
Felder
startDate

string (int64 format)

ERFORDERLICH: Das Startdatum des Abrechnungszeitraums. Dies wird in Millisekunden seit Epoche dargestellt. Es handelt sich dabei um ein Datum, das immer zur ersten Millisekunde des Tages in der Zeitzone der Abrechnung beginnt.

Das ist die erste Millisekunde des Tages im Abrechnungszeitraum, 00:00:00.000.
endDate

string (int64 format)

ERFORDERLICH: Das Enddatum des Abrechnungszeitraums. Dies wird in Millisekunden seit Epoche dargestellt.

Das ist die letzte Millisekunde des letzten Tages des Abrechnungszeitraums, 23:59:59.999

Überweisungsanleitung

Struktur der Holdinginformationen zur Zahlung dieser Überweisung.

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

string

ERFORDERLICH: Die Kennung, die für die Identifizierung von Zahlungen als Lastschriftmandat angegeben werden muss.

StatementNotificationResultCode

Ergebniscodes für eine Benachrichtigung des Kontoauszugs

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert nie fest.
ACCEPTED Integrator hat diese Aussage akzeptiert.