Method: remittanceStatementNotification

Informiert den Integrator über einen neuen Überweisungsnachweis.

Benachrichtigungen zu Kontoauszügen werden immer dann gesendet, wenn ein neuer Kontoauszug für Google an den Integrator gezahlt wird oder der Geldbetrag, den der Integrator Google schuldet.

Wenn der Integrator einen Erfolg zurückgibt, wird davon ausgegangen, dass die Aussage akzeptiert wurde und bezahlt wird.

requestId ist auch die Anweisungs-ID (an anderer Stelle verwendet). Die Kombination aus requestId im Header und paymentIntegratorAccountId ist der Idempotenzschlüssel und identifiziert diese Anweisung eindeutig.

Wenn am Endpunkt bei der Verarbeitung der Anfrage ein Fehler auftritt, sollte der Antworttext von diesem Endpunkt den Typ ErrorResponse haben.

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)

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.
remittanceStatementSummary

object (RemittanceStatementSummary)

ERFORDERLICH: Zusammenfassung dieses Überweisungsauftrags.

Antworttext

Antwortobjekt für die Benachrichtigungsmethode der Ü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)

ERFORDERLICH: Gemeinsamer Header für alle Antworten.
paymentIntegratorStatementId

string

ERFORDERLICH: Kennung, unter der der Integrator diese Anweisung kennt. Dies wird von einem Integrator generiert.
result

enum (StatementNotificationResultCode)

ERFORDERLICH: Ergebnis dieser Benachrichtigung.

RemittanceStatementSummary

Zusammenfassungsobjekt zu einem Überweisungsbescheid.

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

string (int64 format)

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

object (BillingPeriod)

ERFORDERLICH: Der Abrechnungszeitraum, der sich auf diesen Abrechnungszeitraum bezieht.
dateDue

string (int64 format)

OPTIONAL: Das Datum, an dem die Überweisung fällig ist. Dies wird als Millisekunden ab Epoche angegeben. Es handelt sich um ein Datum und beginnt daher immer zur ersten Millisekunde des Tages in der Abrechnungszeitzone.

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

string

ERFORDERLICH: Der dreistellige Währungscode gemäß ISO 4217.
totalDueByIntegrator

string (Int64Value format)

ERFORDERLICH: Dieser Wert wird in „micros“, Mikros und in der Währung currencyCode angegeben. Dieser Wert ist immer positiv.
remittanceInstructions

object (RemittanceInstructions)

ERFORDERLICH: Hier erhalten Sie detaillierte Informationen zur Überweisung.

BillingPeriod

Abrechnungszeitraum dieses Kontoauszugs.

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

string (int64 format)

ERFORDERLICH: Das Startdatum des Abrechnungszeitraums. Dies wird als Millisekunden ab Epoche angegeben. Es handelt sich um ein Datum und beginnt daher immer zur ersten Millisekunde des Tages in der Abrechnungszeitzone.

Dies ist die erste Millisekunde des Tages des Abrechnungszeitraums, 00:00:00.000
endDate

string (int64 format)

ERFORDERLICH: Das Enddatum des Abrechnungszeitraums. Dies wird als Millisekunden ab Epoche angegeben.

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

RemittanceInstructions

Struktur, die Informationen zur Zahlung dieser Überweisungsbenachrichtigung enthält.

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

string

ERFORDERLICH: Kennzeichnung, die in der Gutschriftzeile für die Zahlung zur Identifikationsnummer angegeben werden muss.

StatementNotificationResultCode

Ergebniscodes für Benachrichtigungen zu Anweisungen.

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert niemals fest.
ACCEPTED Der Integrator hat diese Erklärung akzeptiert.