Method: remittanceStatementDetails

Gibt Transaktionsdetails zu einer Überweisung zurück.

Dies ist eine API mit Paginierung. Die Anzahl der Transaktionsereignisse pro Seite kann mit numberOfEvents angegeben werden. Wenn keine Vorgabe erfolgt, werden maximal 1.000 Ereignisse pro Seite zurückgegeben. Jede Anfrage an diese API gibt einen nextEventOffset zurück, der auf das nächste Transaktionsereignis in der Anweisung verweist, sowie ein totalEvents, das die Gesamtzahl der Transaktionen in der Anweisung angibt. Wenn die aktuell abgerufene Seite die letzten Transaktionen der Anweisung enthält, ist nextEventOffset nicht in der Antwort vorhanden.

Der Wert statementId ist der requestId aus remittanceStatementNotificationRequest

Wenn am Endpunkt bei der Verarbeitung der Anfrage ein Fehler auftritt, hat dieser Endpunkt eine Antwort vom Typ ErrorResponse.

Die Antworten auf diese Abfrage können leer sein, 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 Konto-ID des Zahlungsintegrators anderer Integratoren zu verstehen. In Fällen, in denen der Signaturschlüssel nicht übereinstimmt, die Zahlungsintegrator-ID nicht gefunden oder der Verschlüsselungsschlüssel unbekannt war, gibt diese Methode einen HTTP 404-Fehler mit leerem 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": "statement_detail_request_139932019",
    "requestTimestamp": "1502551332087"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "statementId": "0123434-statement-abc",
  "numberOfEvents": 4
}

Eine Beispielantwort sieht so aus:


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "eventOffset": 0,
  "nextEventOffset": 4,
  "totalEvents": 15,
  "remittanceStatementSummary": {
    "statementDate": "1502521200000",
    "billingPeriod": {
      "startDate": "1502434800000",
      "endDate": "1502434800000"
    },
    "dateDue": "1502348400000",
    "currencyCode": "INR",
    "totalDueByIntegrator": "1076000000",
    "remittanceInstructions": {
      "memoLineId": "stmt-1AB-pp0-invisi"
    }
  },
  "captureEvents": [
    {
      "eventRequestId": "bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ",
      "paymentIntegratorEventId": "ioj32SOIjf23oijSDfoij",
      "eventCharge": "700000000",
      "eventFee": "-28000000"
    },
    {
      "eventRequestId": "Ggghvh78200PQ3Yrpb",
      "paymentIntegratorEventId": "iasdf23dSdfijSDfoij",
      "eventCharge": "800000000",
      "eventFee": "-32000000"
    }
  ],
  "refundEvents": [
    {
      "eventRequestId": "liUrreQY233839dfFFb24gaQM",
      "paymentIntegratorEventId": "asd3SDf3f3oijSDfoij",
      "eventCharge": "-200000000",
      "eventFee": "8000000"
    },
    {
      "eventRequestId": "IIghhhUrreQY233839II9qM==",
      "paymentIntegratorEventId": "DFjidoso12FSDFSDE",
      "eventCharge": "-150000000",
      "eventFee": "6000000"
    }
  ]
}

HTTP-Anfrage

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "statementId": string,
  "eventOffset": integer,
  "numberOfEvents": integer
}
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

ERFORDERLICH: Anfrage-ID der Benachrichtigung.
eventOffset

integer

OPTIONAL: Gibt Ereignisse zurück, die bei diesem Offset beginnen. Sollte auf nextEventOffset festgelegt werden, wenn eine zurückgegeben wurde, oder nicht angegeben, wenn dies die erste Anfrage ist. Wenn eventOffset null ist, werden Ereignisse beginnend mit dem ersten Ereignis zurückgegeben. Wenn dieser Wert zwei ist, werden Ereignisse beginnend mit dem dritten Ereignis zurückgegeben. Wenn kein Wert angegeben ist, wird eventOffset als null angenommen.

numberOfEvents

integer

OPTIONAL: Anzahl der Ereignisse, die pro Seite angezeigt werden sollen. Wenn nicht angegeben oder größer als 1.000, ist dies 1.000.

Antworttext

Antwortobjekt für die Detailmethode der Überweisungsanweisung.

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

JSON-Darstellung 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "remittanceStatementSummary": {
    object (RemittanceStatementSummary)
  },
  "eventOffset": integer,
  "nextEventOffset": integer,
  "totalEvents": integer,
  "totalWithholdingTaxes": string,
  "captureEvents": [
    {
      object (Event)
    }
  ],
  "refundEvents": [
    {
      object (Event)
    }
  ],
  "reverseRefundEvents": [
    {
      object (Event)
    }
  ],
  "chargebackEvents": [
    {
      object (Event)
    }
  ],
  "reverseChargebackEvents": [
    {
      object (Event)
    }
  ],
  "adjustmentEvents": [
    {
      object (Event)
    }
  ]
}
Felder
responseHeader

object (ResponseHeader)

REQUIRED: Allgemeiner Header für alle Antworten.
remittanceStatementSummary

object (RemittanceStatementSummary)

REQUIRED: Zusammenfassung dieses Überweisungsscheins.
eventOffset

integer

REQUIRED: Der Ereignisversatz dieser Antwort.
nextEventOffset

integer

OPTIONAL: Versatz des nächsten zurückzugebenden Ereignisses. Wenn kein Wert angegeben ist, können keine weiteren Ereignisse für diese Anweisung abgerufen werden.
totalEvents

integer

REQUIRED: Gesamtzahl der Ereignisse in dieser Anweisung.
totalWithholdingTaxes

string (Int64Value format)

ERFORDERLICH: Die Summe aller für diese Abrechnung einbehaltenen Steuern.

Dieser Wert ist in micros angegeben.
captureEvents[]

object (Event)

ERFORDERLICH: Satz von Erfassungsereignissen.
refundEvents[]

object (Event)

ERFORDERLICH: Eine Reihe von Erstattungsereignissen.
reverseRefundEvents[]

object (Event)

OPTIONAL: Satz von Ereignissen für umgekehrte Erstattungen.
chargebackEvents[]

object (Event)

OPTIONAL: Eine Reihe von Rückbuchungsereignissen.
reverseChargebackEvents[]

object (Event)

OPTIONAL: Eine Reihe von Rückbuchungsereignissen.
adjustmentEvents[]

object (Event)

OPTIONAL: Gruppe von Anpassungsereignissen. Google kann nach eigenem Ermessen Anpassungsereignisse hinzufügen, um Abrechnungsdiskrepanzen auszugleichen. Wenn beispielsweise für eine Reihe früherer Transaktionen zu wenig Gebühren berechnet wurden, kann eine Anpassung verwendet werden, um den Integrator vollständig zu machen.

RemittanceStatementSummary

Zusammenfassungsobjekt für eine Überweisungsanweisung.

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

string (int64 format)

REQUIRED: Datum (in Amerika/Los Angeles), an dem dieser Bericht erstellt wurde.
billingPeriod

object (BillingPeriod)

ERFORDERLICH: Der Abrechnungszeitraum, für den diese Abrechnung gilt.
dateDue

string (int64 format)

OPTIONAL: Datum, an dem die Überweisung fällig ist. Sie werden in Millisekunden seit der Epoche angegeben. Es handelt sich um ein Datum. Daher beginnt es immer mit der ersten Millisekunde des Tages in der Zeitzone der Abrechnung.

Dieser Wert ist festgelegt, solange totalDueByIntegrator größer als 0 ist.
currencyCode

string

ERFORDERLICH: Dreistelliger Währungscode gemäß ISO 4217.
totalDueByIntegrator

string (Int64Value format)

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

object (RemittanceInstructions)

ERFORDERLICH: Details zum Ausführen der Zahlung

BillingPeriod

Abrechnungszeitraum für diese Abrechnung.

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

string (int64 format)

REQUIRED: Startdatum des Abrechnungszeitraums. Sie werden in Millisekunden seit der Epoche angegeben. Es handelt sich um ein Datum. Daher beginnt es immer mit der ersten Millisekunde des Tages in der Zeitzone der Abrechnung.

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

string (int64 format)

REQUIRED: Enddatum des Abrechnungszeitraums. Sie werden in Millisekunden seit der Epoche angegeben.

Dies ist die letzte Millisekunde des letzten Tages des Abrechnungszeitraums (23:59:59.999).

RemittanceInstructions

Gebäude mit Informationen zum Bezahlen dieser Überweisungsbenachrichtigung.

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

string

ERFORDERLICH: Identifizierungsnummer für Überweisungen, die auf der Zahlungszeile für die Zahlung angegeben werden muss.

Veranstaltung

Struktur, die ein einzelnes Ereignis in einer Überweisungsbescheinigung darstellt.

JSON-Darstellung 
{
  "eventRequestId": string,
  "paymentIntegratorEventId": string,
  "eventCharge": string,
  "eventFee": string,
  "presentmentChargeAmount": string,
  "presentmentCurrencyCode": string,
  "exchangeRate": string,
  "nanoExchangeRate": string
}
Felder
eventRequestId

string

ERFORDERLICH: Bei Aufnahme- oder Erstattungsereignissen ist dies die requestId, die Google mit der Anfrage sendet. Bei Reverse-Erstattungen, Rückbuchungen und Reverse-Rückbuchungen ist dies die requestId, die der Zahlungsintegrator mit der Benachrichtigung über dieses Ereignis sendet. Bei Anpassungen ist dies eine eindeutige ID, die Google dem Anpassungsereignis zuweist.
paymentIntegratorEventId

string

REQUIRED: ID, die der Zahlungsintegrator für dieses Ereignis zurückgegeben hat. Bei einer Aufnahme ist dies der paymentIntegratorTransactionId aus der Antwort auf einen capture-Aufruf, bei einer Erstattung der paymentIntegratorRefundId aus der Antwort auf einen refund-Aufruf.

Die Länge dieses Felds ist variabel. Die ID, die Sie für dieses Ereignis angeben, wird hier als Integrator angezeigt. Wenn vom Integrator für das entsprechende Ereignis kein Wert angegeben wurde, enthält dieses Feld denselben Wert wie das Feld eventRequestId.

Bei Reverse-Erstattungen, Rückbuchungen und Reverse-Rückbuchungen ist dies die requestId, die der Zahlungsintegrator mit der Benachrichtigung über das Ereignis gesendet hat.

Die Länge und das Format dieses Feldes hängen vom Quellfeld der einzelnen IDs ab. Weitere Informationen zu Längen- und Zeichensatzanforderungen finden Sie in der Dokumentation zu den einzelnen Quellfeldern. Beachten Sie insbesondere, dass dieses Feld manchmal von Google generierte IDs enthalten kann, die andere Anforderungen an die maximale Länge als die vom Integrationspartner generierten IDs haben können.
eventCharge

string (Int64Value format)

REQUIRED: in Währungscode, der in der Anweisung definiert ist. Wenn dieser Wert negativ ist, stellt er einen Geldwert dar, der von Google zum Zahlungsintegrator übertragen wird. Wenn dies positiv ist, handelt es sich um Geld vom Zahlungsintegrator an Google.

So sind beispielsweise Erfassungstransaktionen immer positiv und Erstattungen immer negativ. Umgekehrte Erstattungen und umgekehrte Rückbuchungen sind immer positiv. Rückbuchungsereignisse sind immer negativ.

Dieser Wert ist in micros angegeben.
eventFee

string (Int64Value format)

REQUIRED: in Währungscode, der in der Anweisung definiert ist. Wenn dieser Wert negativ ist, stellt er einen Geldwert dar, der von Google zum Zahlungsintegrator übertragen wird. Wenn dies positiv ist, handelt es sich um Geld vom Zahlungsintegrator an Google.

Wenn in einer Vereinbarung beispielsweise festgelegt ist, dass Google 1% der transactionCharge an den Zahlungsintegrator zahlt und diesen 1% bei der Erstattung dieser Transaktion zurückerstattet, ist die Erfassungsgebühr negativ und bei Erstattung positiv.

Dieser Wert ist in micros angegeben.
presentmentChargeAmount

string (Int64Value format)

OPTIONAL: Transaktionsbetrag in der aktuellen Währungswährung (auch Transaktionswährung genannt) vor Devisenkursen. Dieses Feld folgt derselben Zeichenkonvention wie das Feld eventCharge.

Dieser Wert ist in micros angegeben.

presentmentCurrencyCode

string

OPTIONAL: Der dreistellige Währungscode gemäß ISO 4217, der die aktuelle Währung (Transaktion) angibt.

exchangeRate

string (Int64Value format)

OPTIONAL: Wechselkurs, der zur Umrechnung des gegenwärtigen Betrags in den Abrechnungsbetrag verwendet wird.

Dieser Wert wird in Mikro-Basispunkten angegeben (1 Basispunkt = 0,0001 = 0,01%). Den Wechselkurs erhalten Sie, wenn Sie dieses Feld durch 10^10 teilen.
nanoExchangeRate

string (Int64Value format)

OPTIONAL: Wechselkurs, der zur Umrechnung des gegenwärtigen Betrags in den Ausgleichsbetrag (Rechnungsbetrag) verwendet wird, ausgedrückt in Nanobasispunkten.

Dieser Wert wird in nano-Basispunkten angegeben (1 Basispunkt = 0,0001 = 0,01%). Den Wechselkurs erhalten Sie, wenn Sie dieses Feld durch 10^13 teilen.

Sowohl dieses Feld als auch der Wechselkurs werden ausgefüllt. Sie sind gleichwertige Wechselkurse, die unterschiedlich präzise ausgedrückt werden. In zukünftigen Versionen wird der Wechselkurs zugunsten von nanoExchangeRate entfernt.