Eindeutige Zahlungskennung – was ist das? Wofür ist das? Das ist das meiste FAQ Die Fragen, die Unternehmer stellen, wenn sie Steuern bei der Bank zahlen, wenn ein Bankangestellter darum bittet, dies anzugeben, sind rätselhaft. Wo finde ich es, wie bekomme ich es und kann ich darauf verzichten? Daher führte die Schaffung eines Tools zur Vereinfachung des Verfahrens zu neuen Fragen, die geklärt werden mussten.
Was ist eine eindeutige Kennung?
Eine eindeutige Zahlungskennung ist ein 20-stelliger Code, der bei der Begleichung von Steuerschulden angegeben werden muss. Dies ermöglicht eine einfache und schnelle Zahlung von Steuern von Ihrem persönlichen Konto auf der Website des Steuerdienstes. Dieser Ansatz vereinfacht und beschleunigt den Operationsvorgang erheblich. Die Zahlung erfolgt schnell und somit pünktlich, wodurch Verzögerungen und damit Strafen und Zinsen vermieden werden.
Die Verwendung einer eindeutigen Kennung ermöglicht es Unternehmern, Rechts- und Einzelpersonen Zahlen Sie Steuern auf eine für Sie bequeme Weise. Der Erhalt und das Ausfüllen von Steuerdokumentationsformularen weist in diesem Fall jedoch eigene Besonderheiten auf, die berücksichtigt werden müssen. Das Problem liegt auch darin, dass der staatliche Informationsdienst selbst eine komplexe, unübersichtliche Struktur aufweist, die selbst ein erfahrener Nutzer nicht immer verstehen kann.
Wofür ist das?
Es wird benötigt, damit der Bundessteuerdienst weiß, wann und von welcher Person das Geld auf dem Konto eingegangen ist. Es sind Millionen von Benutzern im GIS registriert; es ist schwierig festzustellen, von wem und zu welchen Zwecken Gelder überwiesen werden. Aus diesem Grund wurden mit Beschluss des Finanzministeriums Nr. 107n vom 12. November 2013 die Regeln geändert, wonach eine eindeutige Kennung für Rückstellungszahlungen gesondert für Steuern erscheint.
Der Steuerdienst benötigt es, um die Finanzpolitik effektiver umzusetzen und hartnäckige Zahlungsausfälle zu identifizieren. Juristische Personen und Einzelpersonen benötigen die bequemste und bequemste Lösung der schnelle Weg Steuern zahlen. Dadurch kann die Regierung die Handlungen von Steuerbeamten kontrollieren und Fälle stoppen, in denen ihre Handlungen die ihnen übertragenen Befugnisse überschreiten, was in der Vergangenheit häufig vorkam. Unternehmer sind weniger vom Willen des Einzelnen abhängig und leiden unter illegalen Erpressungen. Die Anzahl der durchgeführten Inspektionen wurde reduziert.
Wer sollte es angeben?
Sowohl normale Bürger als auch Unternehmer (Einzelpersonen) und juristische Personen können eine eindeutige Zahlungskennung angeben. Dies kann bei der Zahlung der Steuern direkt auf das Konto des Informationssystems oder über eine Bank erfolgen. Bei der Überweisung sollten Sie berücksichtigen, dass die Zahlung über die Sberbank ihre eigenen Besonderheiten hat. Sie haben ein eigenes Sonderformular, beim Ausfüllen muss keine eindeutige Kennung angegeben werden. Die UIN wird bei der Zahlung von Steuern und staatlichen Abgaben über den Staatsdienst oder eine Bankfiliale angegeben.
Wenn eine natürliche oder juristische Person Zahlungsbelege für die Zahlung von Steuern und Gebühren ausfüllt, deren Zahlungsfrist noch nicht abgelaufen ist, darf sie keine eindeutige Kennung eingeben, sondern im Fälligkeitsdatum für die Eingabe der Daten eine Null einfügen. Obwohl diese Art des Ausfüllens der Zeile gesetzlich zulässig ist, kann der Mitarbeiter bei Zahlung über eine Bank verlangen, dass die Zeile mit einer 20-stelligen Zahlungsnummer ausgefüllt wird, und hat das Recht, die Annahme der Zahlung zu verweigern. Daher ist es wichtig zu wissen, in welchen Fällen eine Angabe erforderlich ist und in welchen nicht.
In welchen Fällen ist eine Angabe erforderlich?
Es ist zu beachten, dass die Angabe der Kennung nicht immer erforderlich ist, sondern nur in bestimmten Fällen, die in den Regeln und Vorschriften der Bank von Russland (insbesondere der Verordnung Nr. 383-P) beschrieben sind. UIN – eine eindeutige Kennung wird in zwei Fällen angegeben:
- Wenn es vom Empfänger der Gelder angegeben und einer natürlichen Person bereitgestellt wurde oder juristische Person verpflichtet, diese entsprechend den Vertragsbedingungen zu zahlen. In diesem Fall wird die Kennung automatisch vergeben.
- Bei der Überweisung von Geldern an das Finanzamt. Ein Unternehmer oder eine Einzelperson füllt spezielle Felder (Zeilen) eines Zahlungsauftrags in Papierform oder aus im elektronischen Format. In diesem Fall bereitet das Befüllen einige Schwierigkeiten. Schließlich kennt ein Unternehmer nicht immer seine eindeutige Zahlungsidentifikationsnummer oder weiß, wo er diese erhalten kann.
Im zweiten Fall haben die meisten Steuerzahler Schwierigkeiten, weil sie nicht wissen, wo sie es bekommen und wo sie es im Dokument angeben sollen. Und falsch angegebene Daten führen zu Zahlungsverzögerungen, Strafen und Bußgeldern.
Wo und wie bekomme ich einen Ausweis?
Wie erfahre ich Informationen über die eindeutige Zahlungskennung und ob die Zahlung akzeptiert wurde? Sie können dies wie folgt überprüfen: persönliches Konto GIS nach der Registrierung im System und bei Zahlungsverzug nach Erhalt eines Zahlungsauftrags. Aber das ist ein Extremfall. Die Nummer erfährt der Unternehmer aus den Unterlagen, die dem Finanzamt das Vorliegen einer Schuld oder einer Geldbuße belegen.
Wenn keine überfälligen Zahlungen vorliegen, Sie aber die UIN angeben müssen, müssen Sie lediglich eine Anfrage an das Steueramt senden, um eine Nummer zu erhalten.
Wie fülle ich es richtig aus?
Wenn Steuerzahler Zahlungen leisten an Haushaltssystem RF füllen Sie den Zahlungsauftrag aus. Zusätzlich zur eindeutigen Kennung muss der Unternehmer Folgendes angeben:
- BIC des Instituts, über das die Zahlung erfolgen soll;
- Name der Bank, ihre juristische Adresse;
- das Girokonto, von dem die Überweisung erfolgen soll;
- Zahlungsart (Code);
- Datum der Operation.
Die Nummer wird in die Zeile der eindeutigen Zahlungskennung eingegeben – 22 (Feldcode). Nur bei fristgerechter Zahlung nicht ausfüllen. Geben Sie in diesem Fall in dieser Zeile „0“ (Null) ein.
Was tun, wenn das Dokument bereits eine UIN enthält?
Manchmal, insbesondere bei Zahlungen über spezielle Informationssysteme, erscheint beim elektronischen Ausfüllen einer Bestellung in der Zeile (der Code ist 22) eine eindeutige Zahlungskennung. Wie sollen wir uns dabei fühlen? Wird dies als Fehler angesehen, wenn die Gelder rechtzeitig eingezahlt werden? Tatsächlich liegt kein Fehler vor. Sie können entweder durch Angabe der ID-Nummer oder durch Eingabe einer „0“ in der Zeile bezahlen. Sie verlangen lediglich die Angabe der Kennung bei Zahlungsverzug, also auf Verlangen des Finanzamtes.
Obwohl es möglich ist, uneingeschränkt zu bezahlen, ist diese Vorgehensweise unerwünscht. Ein Unternehmen muss zwischen regelmäßigen Steuerzahlungen und solchen, die auf Verlangen der Steuerbehörden gezahlt werden, unterscheiden. Dies trägt dazu bei, Verwirrung bei der Berichterstattung zu vermeiden.
Aber auch wenn es nicht möglich war, die Kennung in der Bestellung herauszufinden und anzugeben, berechtigt dies die Banken nicht, die Annahme zu verweigern. Die Bank ist zur Annahme und Überweisung von Geldern verpflichtet, auch wenn die UIP (Unique Payment Identifier) nicht angegeben ist. Diese Regel ist in den offiziellen Dokumenten des Steuerdienstes festgelegt. Darin heißt es eindeutig, dass eine natürliche oder juristische Person lediglich ihre TIN angeben und in der Zeile (Code 22) der eindeutigen Zahlungskennung „0“ eingeben muss. In diesem Fall steht der Bank kein Recht zu, die Überweisung zu verweigern. Der Unternehmer muss jedoch berücksichtigen, dass die Bank im Falle eines Fehlers oder einer Verzögerung nicht verantwortlich ist.
Was bedeutet der Code: Entschlüsselung der Kennung
Die Kennung wird wie folgt entschlüsselt:
- Die Nummern 1 bis 3 geben den Code der Steuerabteilung an, bei der die Gelder eingehen.
- Die Zahl 4 gibt die Art der Zahlung an. Dieser Ort ist immer Null.
- Zahlen von 5 bis 19. Geben Sie den Dokumentencode im Steuersystem an. Jedem Zahler wird basierend darauf ein eigener Sondercode zugewiesen vorherige Version Dokumentenindex.
- Ziffer 20. Ihre Nummer bestimmt, welche Regierungsbehörde die Zahlung überprüft. Berechnet unter Berücksichtigung der restlichen 19 Ziffern des Codes.
Die eindeutige Zahlungskennung ist nur dann mit dem Dokumentenindex identisch, wenn der Index aus 20 Ziffern besteht.
Was passiert, wenn Sie es nicht angeben?
Anhand der UIN-Nummer werden Steuern und andere Zahlungen an den Haushalt automatisch erfasst. Informationen über Zahlungen an den Haushalt werden in eine einzige Datenbank übertragen. Wenn Sie einen falschen Code eingeben oder diesen nicht angeben, erkennt das System die Zahlung nicht und das Geld wird nicht überwiesen. Dies ist mit solchen Problemen behaftet wie:
- das Unternehmen wird Schulden gegenüber dem Budget und den Mitteln machen;
- es werden weiterhin Strafen verhängt;
- Sie müssen die Zahlung klären und ihr Schicksal herausfinden;
- das Geld wird mit Verzögerung beim Haushalt oder den Fonds ankommen.
Wenn ein Unternehmer keine eindeutige Zahlungskennung hat oder nicht weiß, wo er diese erhalten kann, kann er jederzeit den Support-Service im GIS nutzen, anstatt auf Maßnahmen der Steuerbehörden zu warten. Wenn ein Unternehmer keinen Zugang zum Internet hat und elektronisches System„Regierungsdienste“, er kann einen regulären Brief an das nächstgelegene Finanzamt senden oder persönlich erscheinen, um eine Kennung entgegenzunehmen.
Welche Dokumente werden benötigt, um einen Ausweis zu erhalten?
Es hängt alles von der Form ab, in der das Dokument erstellt wird, und von der Zahlungsmethode. Handelt es sich um ein Papierdokument, muss eine schriftliche Anfrage an gesendet werden Steuerbehörde. Geben Sie im Brief Ihre Passdaten, INN und SNILS-Nummer an. In einem Antwortschreiben wird eine eindeutige Zahlungskennung gesendet. Wenn eine juristische oder natürliche Person persönlich zur Entgegennahme dieser Informationen in die Abteilung kommt, müssen diese Dokumente bei ihr sein. Sie sind verpflichtet, Formulare auszufüllen.
Um die Daten elektronisch zu erhalten, müssen Sie sich zunächst in einer einzigen registrieren Informationssystem auf der Website der Staatsdienste unter Angabe derselben Daten wie in der schriftlichen Anfrage. Anschließend wird ein Brief mit einem Zugangsschlüssel an Ihren Wohnort geschickt. Und erst danach können Sie einen Antrag auf Erteilung einer eindeutigen Kennung stellen. In der Regel wird dieser Service innerhalb weniger Stunden nach der Antragstellung erbracht. Es sind keine Dokumente erforderlich.
Wie Sie sehen, ist die Verwendung der Kennung nicht kompliziert. Es wird nicht schwer sein, ihn zu erkennen. Dazu müssen Sie nicht viele Dokumente oder Zertifikate zusammentragen. Steuern können aber bequem und jederzeit bezahlt werden. Wenn früher juristische Personen und Einzelpersonen Zeit und Geld aufwenden mussten, um Steuerzahlungen zu leisten, können sie mit ihrer Hilfe bezahlt werden, ohne das Haus oder das Büro zu verlassen, ohne die Arbeit zu unterbrechen.
allgemeine Informationen
Beschreibung der Eingabeparameter
Beschreibung der Ausgabeparameter
oder
Ausgabe: XML-Dokument nach dem Schema WS_ULIPOTVID_2_311_09_04_02_01.XSD
Komplexe Typparameter werden im Anhang „Beschreibung allgemeiner Datenstrukturen“ (in den Absätzen 10, 6, 9) beschrieben.
Rückgabecodes
| № | Rückgabe Code | Beschreibung des Rückkehrcodes | Eintrittsbedingungen | Ein Kommentar |
| 1 | 01 | Die angeforderten Informationen wurden nicht gefunden | Tritt auf, sofern Informationen über die juristische Person nicht im Unified State Register of Legal Entities enthalten sind | |
| 2 | 51 | Anfrage zur Bearbeitung angenommen | Tritt auf, wenn eine Anfrage erfolgreich zur Verarbeitung angenommen wurde | |
| 3 | 52 | Die Antwort ist noch nicht fertig | Tritt auf, wenn eine Antwort auf eine erfolgreich zur Verarbeitung angenommene Anfrage noch nicht bereit ist | Wird für asynchrone Anfragen verwendet |
| 4 | 53 | Angaben zu einer juristischen Person/einem Einzelunternehmer können nicht elektronisch übermittelt werden | Tritt auf, wenn es nicht möglich ist, eine Antwort auf eine Anfrage in elektronischer Form zu generieren. | |
| 5 | 82 | Formatlogischer Steuerungsfehler | Tritt auf, wenn das Dokument (Anfrage) nicht mit dem XSD-Schema übereinstimmt | Reserve, darf nicht verwendet werden |
| 6 | 83 | Es gibt keine Anfrage mit der angegebenen Anfrage-ID und der Art der von dieser Behörde angeforderten Informationen | Tritt in einer Situation auf, in der die Anfrage nach einem Ergebnis einer Anfrage nach einem Auszug einer juristischen Person eine falsche (unbekannte) Anfrage-ID angibt und (oder) eine Anfrage mit einer solchen ID von dieser Behörde nicht eingegangen ist | Wird für eine asynchrone Anfrage verwendet (wenn das Ergebnis einer Anfrage nach einem Auszug von einer juristischen Person empfangen wird) |
| 9 | 99 | Systemfehler | Tritt auf, wenn interne Fehler in der IS-Software des Föderalen Steuerdienstes Russlands vorliegen |
Testfälle
Antwort auf eine Anfrage zum Erhalt des Ergebnisses einer Anfrage zur Einholung eines Auszugs von einer juristischen Person, falls die Anfrage noch nicht bearbeitet wurde
Antwort auf eine Anfrage zum Erhalt des Ergebnisses einer Anfrage zum Erhalt eines Auszugs von einer juristischen Person mit Rückkehrcode 53
Antwort auf eine Anfrage nach dem Ergebnis einer Anfrage nach einem Auszug einer juristischen Person mit einem Fehler (der Verarbeitungscode ist nicht reserviert)
(Attributwerte ändern sich und)
| |
Hinweis: Die Bedingungen für das Auftreten dieses Fehlers in der Testumgebung wurden künstlich ausgelöst. Dieses Beispiel beschreibt die allgemeine Logik und Struktur der Fehlerreaktion. Beim Testen in einer Produktionsumgebung ist es nicht möglich, genau dieselbe Antwort zurückzugeben, ohne die erforderlichen Bedingungen bereitzustellen.
- Die Schnittstelle muss HTTPS-Anfragen von Subnetz-IP-Adressen akzeptieren:
- 79.142.16.0, Maske 255.255.240.0 (20)
- 91.232.230.0, Maske 255.255.254.0 (23)
- Die Schnittstelle muss Parameter verarbeiten, die vom System mit der HTTP-GET-Methode übergeben werden.
- Die Schnittstelle muss eine Antwort an das System im XML-Format in UTF-8-Kodierung generieren.
- Der Informationsaustausch erfolgt im „Request-Response“-Modus und die Antwortgeschwindigkeit sollte 60 Sekunden nicht überschreiten, da das System sonst die Verbindung aufgrund eines Timeouts abbricht.
- Wenn erwartet wird, dass die erwartete Anzahl an Zahlungen für die Dienste des angeschlossenen Anbieters intensiv ist (bis zu 10 Zahlungen pro Minute oder mehr), ist es notwendig, dass die Schnittstelle Multithread-Kommunikation bis zu 10–15 gleichzeitige Verbindungen unterstützt.
- Die Schnittstelle muss Anfragen über das HTTPS-Protokoll auf einem der folgenden TCP-Ports annehmen: 80, 81, 443, 8008, 8080, 8081, 8090, 8443, 4433. Die Nutzung anderer Ports ist nicht erlaubt.
Grundprinzipien der Schnittstelle
Alle Anfragen werden mit der GET-Methode gesendet, Parameter werden im Anfragepfad übergeben.
Die Übermittlung der Zahlungsinformationen an den Anbieter erfolgt durch das QIWI Wallet-System in zwei Schritten – Überprüfung des Abonnentenstatus und direkte Ausführung der Zahlung. Es kann auch eine Vorstufe zur Beschaffung zusätzlicher Zahlungsparameter von einem Anbieter, der dem Abonnenten mehrere Dienste bereitstellt, hinzugefügt werden, um den Zahler zu informieren und Zahlungsparameter nach Wahl des Zahlers hinzuzufügen.
Die Art der Anfrage wird vom QIWI Wallet-System in der Befehlsvariablen übermittelt – einem String, der die Werte check, pay oder getInfo annimmt:
Abfrageparameter
Alle Parameter sind in den Abfragen erforderlich, in denen sie verwendet werden.
| Parameter | Format | Beschreibung | In welchen Abfragen wird es verwendet? |
|---|---|---|---|
| txn_id | Bis zu 20 Zeichen lange Ganzzahl | Eindeutige Zahlungskennung im QIWI-System. Diese Kennung wird zur Lösung kontroverser Probleme verwendet. | prüfen, bezahlen |
| Summe | Als Trennzeichen wird eine auf Hundertstel genaue Bruchzahl verwendet. (Punkt). Wenn die Summe eine ganze Zahl darstellt, wird sie noch mit einem Punkt und Nullen ergänzt, zum Beispiel - 152,00. | Höhe der Zahlung | prüfen, bezahlen |
| ccy | Alpha-3 ISO 4217-Währungscode | Währung | prüfen, bezahlen |
| txn_date | JJJJMMTDHHMMSS | Zahlungsdatum (das Zahlungsdatum im System bedeutet das Datum, an dem die Anfrage vom Kunden eingegangen ist). Basierend auf diesem Datum erfolgt der weitere Abgleich der gegenseitigen Abrechnungen zwischen QIWI Wallet und dem Anbieter. Beispielsweise hat der Kunde am 31.12.2010 um 23:59:59 Uhr eine Anfrage an das QIWI Wallet-System gesendet, und das QIWI Wallet-System hat seine Anfrage am 01.01.2011 um 00:00:05 Uhr an den Anbieter gesendet. Dies kann zu einem Zahlungsabgleichsproblem führen, wenn das System des Anbieters die Transaktion in den nächsten Abrechnungszeitraum platziert. Um solche Probleme zu vermeiden, stellt QIWI Wallet dem Anbieter das ursprüngliche Zahlungsdatum zur Verfügung. |
zahlen |
| Konto | Eine bis zu 200 Zeichen lange Zeichenfolge mit Buchstaben, Zahlen und Sonderzeichen | Abonnenten-ID. Der Anbieter identifiziert seinen Abonnenten durch eine eindeutige Kennung (persönliche Kontonummer, Telefonnummer, Login usw.). Vor der Übermittlung an den Anbieter wird die Kennung gem regulären Ausdruck, welche . | prüfen, bezahlen, Info erhalten |
| extra | Zulässige Zahlen sind Zahlen (0-9), Unterstriche (_) und Kleinbuchstaben des lateinischen Alphabets (a-z). | Zusätzliche Zahlungsdetails (zusätzliche Felder). Diese Parameter können verwendet werden, wenn die Zahlung nicht ohne zusätzliche Daten erfolgen kann (eine Benutzerkennung im System des Anbieters reicht nicht aus). Die Benutzer-ID ist beispielsweise eine Nummer Kreditkarte, aber um eine Zahlung durchzuführen, müssen Sie auch das Ablaufdatum der Karte angeben. Die Liste der an den Anbieter zu übertragenden Pflichtfelder ist im anzugeben. |
prüfen, bezahlen |
| prvId | Ganze Zahl | Dienstkennung im gemeinsamen System des Anbieters. | Informationen bekommen |
| Parametername | Das Format des Namens und Werts der Parameter wird vom Anbieter in angegeben. | Zusätzliche Optionen zur Teilnehmeridentifikation | Informationen bekommen |
Um die Erweiterbarkeit zu unterstützen und die Funktionalität des Dienstes des Anbieters während des Zeitraums aufrechtzuerhalten, in dem verschiedene im Protokoll vorgesehene Funktionen aktiviert sind (z. B. die Ermöglichung der Übertragung neuer Zahlungsdaten), wird davon ausgegangen, dass der Anbieter das Erscheinen neuer Zahlungsdaten nicht verhindert HTTP-Parameter in der Anfrage.
Es wird gewährleistet, dass das Auftauchen neuer Parameter in einer Anfrage nicht dazu führt, dass die Bearbeitung der Anfrage seitens des Anbieters geändert werden muss, es sei denn, eine solche Änderung der Logik wurde mit dem Anbieter vereinbart.
Antwortformat
Der Anbieter muss die Antwort auf Anfragen im XML-Format an das System zurücksenden. Die allgemeine Struktur der Antwort wird in der Registerkarte rechts angezeigt.
Wenn eine der Anfragen an den Anbieter fehlschlägt, gibt der Anbieter einen Fehlercode gemäß zurück.
Das Informationssystem des Anbieters sollte nicht zwei erfolgreich abgeschlossene Zahlungen mit derselben txn_id-Nummer enthalten. Wenn das System eine Anfrage mit der bereits im Informationssystem des Anbieters vorhandenen Kennung txn_id erneut sendet, muss der Anbieter das Ergebnis der Verarbeitung der vorherigen Anfrage zurücksenden.
Die Antwort kann die folgenden Tags enthalten:
Es gibt beispielsweise eine Situation: Der Kunde hat am 31.12.2010 um 23:59:59 Uhr eine Anfrage an das System gesendet. Unter Berücksichtigung der Verzögerung bei der Verarbeitung von Daten und der Übermittlung von Informationen über Kommunikationskanäle geht die Zahlung am 01.01.2011 um 00:00:05 Uhr beim Anbieter ein und wird dementsprechend im System des Anbieters in einem weiteren Reporting berücksichtigt Zeitraum. Um Probleme mit unterschiedlichen Berichtsperioden bei der Durchführung von Abstimmungen zu vermeiden, ist es erforderlich, dass der Anbieter das Datum der Abrechnung in seinem System zurückgibt.
Beispiel für eine Anfrage zur Überprüfung des Status des Kontos eines Abonnenten und zur Registrierung einer Zahlung
Beispielbedingungen:
Die Zahlungsanwendung payment_app des Anbieters befindet sich unter yourservice.prv.ru, der Server unterstützt HTTPS-Verbindungen auf Port 8443.
Um den Status des Abonnenten zu überprüfen, generiert das QIWI Wallet-System eine Anfrage (siehe Registerkarte rechts).
ERHALTEN / payment_app?command=check&txn_id=1234567& account=4957835959&sum=10,45&ccy=RUBDie Anfrage enthält Parameter:
- command=check – Identifikator der Anfrage zur Überprüfung des Abonnentenstatus;
Erfolgreiche Antwort des Anbieters (siehe Reiter rechts).
Die Rückgabe von result=0 bei einer Scheckanfrage zeigt an, dass das persönliche Konto des Abonnenten mit der entsprechenden Nummer im Kontofeld um den in der Anfrage im Summenfeld angegebenen Betrag aufgefüllt werden kann. Nach erfolgreicher Überprüfung des Kontostands des Abonnenten beginnt das System damit, eine Aufforderung zum Aufladen des Guthabens (Zahlungsaufforderung) zu generieren und zu versenden.
Beispiel für eine Anfrage zum Aufladen eines persönlichen Kontos
Beispielbedingungen:
Um die Zahlung zu bestätigen, generiert das QIWI Wallet-System eine Anfrage (siehe Reiter rechts).
ERHALTEN / payment_app?command=pay&txn_id=1234567& txn_date=20110815120133&account=4957835959&sum=10,45&ccy=RUB HTTP / 1.1-Host: yourservice.prv.ru:8443 Antwort des AnbietersDie Anfrage enthält Parameter:
- command=pay – Kennung der Anfrage zum Aufladen des Abonnentenguthabens;
- txn_id=1234567 – interne Zahlungsnummer im QIWI-System;
- txn_date=20090815120133 – Datum der Registrierung der Zahlung im QIWI-System;
- account=4957835959 – Teilnehmerkennung im Informationssystem des Anbieters;
- Summe=10,45 – Betrag, der dem persönlichen Konto des Abonnenten gutgeschrieben wird;
- ccy=RUB – Währung des Betrags, der dem persönlichen Konto des Abonnenten gutgeschrieben wird.
Durch die Rückgabe von result=0 an die Zahlungsanforderung meldet der Anbieter den erfolgreichen Abschluss der Guthabenauffüllung. Das System schließt die Verarbeitung dieser Transaktion ab.
Das optionale Kommentarfeld enthält einen Servicekommentar.
Beispiel für eine Anfrage nach zusätzlichen Zahlungsdaten
Beispielbedingungen:
Die Zahlungsanwendung payment_app des Anbieters befindet sich unter yourservice.prv.ru, der Server unterstützt HTTPS-Verbindungen auf Port 8443.
Um zusätzliche Zahlungsdaten zu erhalten, generiert das QIWI Wallet-System eine Anfrage (siehe Reiter rechts).
ERHALTEN / payment_app?command=getInfo&prvId=12345& account=4957835959&name1=%26%30AB&name2=0 HTTP / 1.1-Host: yourservice.prv.ru:8443 Antwort des AnbietersDie Anfrage enthält Parameter:
- command=getInfo – Identifikatoranfrage, um zusätzliche Zahlungsdaten für den Abonnenten zu erhalten;
- prvId=12345 – Kennung zur Identifizierung des Anbieterdienstes;
- account=4957835959 – Teilnehmerkennung im Informationssystem des Anbieters;
- name1, name2 – zusätzliche Abonnenten-IDs.
Die Antwort des Anbieters finden Sie auf der Registerkarte rechts.
Die Rückgabe von result=0 an eine getInfo-Anfrage zeigt an, dass die Anfrage erfolgreich abgeschlossen wurde und zusätzliche Daten empfangen wurden, die dem Abonnenten angezeigt werden sollen.
Das optionale Kommentarfeld enthält einen Servicekommentar.
Tägliche Versöhnung
Bis 10:00 Uhr Moskauer Zeit generiert und sendet das System an die angegebene Adresse elektronisches Register akzeptierte Zahlungen für den Vortag.
Das Register hat folgenden Aufbau:
Transaktionsdatum (Moskau);Berichtsdatum;Typ;Transaktionsnummer;Transaktionswährungs-ID;Transaktionsbetrag;Kommentar des Händlers;Transaktions-/Rechnungsnummer des Händlers;Ausstellungsdatum der Rechnung;QW-ID;Konto;Rückerstattungs-ID
Die Felder sind durch ein Schild getrennt; , der Bruchteil des Betrags wird durch einen Punkt getrennt, das Datum/die Uhrzeit ist Moskau, der Zeilenvorschub kann entweder aus den Zeichen x0D x0A oder einfach x0D bestehen.
Zum Beispiel:
31.02.2005 00:04:00;31.02.2005
00:00:00;Zahlung;3464968222;USD;5,00;;;;;0957835959;;
31.02.2005 00:04:00;31.02.2005 00:00:00;Zahlung;3464968912;RUB;10,34;;;;; [email protected];;
31.02.2005 00:11:00;31.02.2005 00:00:00;Zahlung;3464974548;EUR;4,72;;;;;ABC-12345;;
Das System erfasst nur erfolgreich abgeschlossene Zahlungen im Register.
Zahlungen, die sowohl über Online-Nachrichten als auch im Register eingegangen sind, gelten als bestätigt.
Wenn das Register keine Zahlungen enthält, die in der Datenbank des Anbieters getätigt wurden, oder Zahlungen enthält, die nicht in der Datenbank des Anbieters enthalten sind, oder wenn das Register nicht eingegangen ist, müssen Sie sich vor 12:00 Uhr an den in der Vereinbarung angegebenen QIWI-Ansprechpartner wenden um die Situation zu klären und eine Entscheidung zu treffen.
Zusätzliche Optionen zur Anforderungsautorisierung
Im Verbindungsantrag kann der Anbieter für ihn eine Kennung (Login) und ein geheimes Passwort angeben, die zur Autorisierung bei Anfragen von QIWI verwendet werden.
Diese Autorisierungsdaten werden gemäß den standardmäßigen Basisauthentifizierungsregeln für HTTP(S)-Anfragen übertragen. Der Anfrage wird ein Autorisierungs-HTTP-Header hinzugefügt. Der Header enthält die Zeichenfolge Basic (mit einem Leerzeichen am Ende) und das in BASE64 codierte Paar „login:password“:
Autorisierung: Basic ***
BASE64("Login:Password") = "***"
Anschlussantrag (Muster)
Liste der Exit-Codes
Bei der Verarbeitung von Anfragen aus dem System muss der Anbieter alle in seiner Anwendung auftretenden Fehler mit der untenstehenden Liste abgleichen und die entsprechenden Codes im Element zurückgeben.
Das +-Zeichen in der Spalte „Fatality“ zeigt an, dass der Fehler schwerwiegend ist. Für das QIWI Wallet-System bedeutet ein schwerwiegender Fehler, dass das erneute Senden einer Anfrage mit denselben Parametern zu einer 100-prozentigen Wiederholung desselben Fehlers führt – daher stoppt das System die Verarbeitung der Kundenanfrage und schließt sie mit einem Fehler ab.
Ein nicht schwerwiegender Fehler bedeutet für das System, dass eine Wiederholung der Anfrage mit den gleichen Parametern nach einer gewissen Zeit wahrscheinlich zum Erfolg führen wird. Das System wiederholt Anfragen, die nicht abgeschlossen werden fataler Fehler, wodurch das Intervall ständig erhöht wird, bis der Vorgang erfolgreich ist oder fehlschlägt oder bis die 24-Stunden-Lebensdauer der Anforderung abläuft.
Eine fehlende Verbindung zum Server des Anbieters ist ein nicht schwerwiegender Fehler.
Das Fehlen eines Elements in der Antwort (falsches XML, Seite mit vorübergehend nicht verfügbarem Dienst usw.) ist ebenfalls ein nicht schwerwiegender Fehler.
| Code |
|---|
