- HTTP-Anfrage
- Anfragetext
- Antworttext
- RemittanceStatementSummary
- BillingPeriod (Abrechnungszeitraum)
- RemittanceInstructions
- Ereignis
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
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.ErrorResponse
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 ( |
Felder | |
---|---|
requestHeader |
ERFORDERLICH: Allgemeiner Header für alle Anfragen. |
paymentIntegratorAccountId |
ERFORDERLICH: Dies ist die Zahlungsintegrationskonto-ID, die vertragliche Einschränkungen für diese Abrechnung angibt. |
statementId |
ERFORDERLICH: Anfrage-ID der Benachrichtigung. |
eventOffset |
OPTIONAL: Gibt Ereignisse zurück, die bei diesem Offset beginnen. Sollte auf |
numberOfEvents |
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 ( |
Felder | |
---|---|
responseHeader |
REQUIRED: Allgemeiner Header für alle Antworten. |
remittanceStatementSummary |
REQUIRED: Zusammenfassung dieses Überweisungsscheins. |
eventOffset |
REQUIRED: Der Ereignisversatz dieser Antwort. |
nextEventOffset |
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 |
REQUIRED: Gesamtzahl der Ereignisse in dieser Anweisung. |
totalWithholdingTaxes |
ERFORDERLICH: Die Summe aller für diese Abrechnung einbehaltenen Steuern. Dieser Wert ist in micros angegeben. |
captureEvents[] |
ERFORDERLICH: Satz von Erfassungsereignissen. |
refundEvents[] |
ERFORDERLICH: Eine Reihe von Erstattungsereignissen. |
reverseRefundEvents[] |
OPTIONAL: Satz von Ereignissen für umgekehrte Erstattungen. |
chargebackEvents[] |
OPTIONAL: Eine Reihe von Rückbuchungsereignissen. |
reverseChargebackEvents[] |
OPTIONAL: Eine Reihe von Rückbuchungsereignissen. |
adjustmentEvents[] |
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 ( |
Felder | |
---|---|
statementDate |
REQUIRED: Datum (in Amerika/Los Angeles), an dem dieser Bericht erstellt wurde. |
billingPeriod |
ERFORDERLICH: Der Abrechnungszeitraum, für den diese Abrechnung gilt. |
dateDue |
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 |
currencyCode |
ERFORDERLICH: Dreistelliger Währungscode gemäß ISO 4217. |
totalDueByIntegrator |
ERFORDERLICH: Dieser Wert wird in Mikros und in der Währung |
remittanceInstructions |
ERFORDERLICH: Details zum Ausführen der Zahlung |
BillingPeriod
Abrechnungszeitraum für diese Abrechnung.
JSON-Darstellung |
---|
{ "startDate": string, "endDate": string } |
Felder | |
---|---|
startDate |
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 |
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 |
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 |
ERFORDERLICH: Bei Aufnahme- oder Erstattungsereignissen ist dies die |
paymentIntegratorEventId |
REQUIRED: ID, die der Zahlungsintegrator für dieses Ereignis zurückgegeben hat. Bei einer Aufnahme ist dies der 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 Bei Reverse-Erstattungen, Rückbuchungen und Reverse-Rückbuchungen ist dies die 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 |
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 |
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 Dieser Wert ist in micros angegeben. |
presentmentChargeAmount |
OPTIONAL: Transaktionsbetrag in der aktuellen Währungswährung (auch Transaktionswährung genannt) vor Devisenkursen. Dieses Feld folgt derselben Zeichenkonvention wie das Feld Dieser Wert ist in micros angegeben. |
presentmentCurrencyCode |
OPTIONAL: Der dreistellige Währungscode gemäß ISO 4217, der die aktuelle Währung (Transaktion) angibt. |
exchangeRate |
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 |
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. |