1. Einführung

SwissBilling ist ein Schweizer Unternehmen (Teil der Cembra Money Bank) und wurde 2011 gegründet. Es konzentriert sich auf die Bereitstellung einer einfach zu bedienenden Zahlungsmethode, die Zahlungen auf Rechnung für Schweizer Online-Kunden ermöglicht. Bei dieser Lösung ist es Kunden möglich, ihren Kauf erst x Tage nach Erhalt bezahlen. Der Händler kann die Rechnung vor der Stornierung oder nach dem Versand bearbeiten. Bevor eine Zahlung akzeptiert wird, führt Swissbilling Bonitätsprüfungen über einen Abgleich mit Schweizer Datenbanken und der Kredithistorie des Kunden bei SwissBilling durch. Bei der Genehmigung eines Auftrags eröffnet SwissBilling eine Gutschrift für diese Kunden und entscheidet über deren Eignung und Zahlungsanforderungen.
Der Kauf auf Rechnung ist die bevorzugte Zahlungsmethode unter Schweizer Verbrauchern.

2. Ablauf

Eine Transaktion über SwissBilling läuft wie folgt ab:

  1. Der Kunde legt die gewünschten Artikel in seinen Warenkorb auf der Website des Händlers, geht zur Kasse und wählt SwissBilling als Zahlungsmethode aus. Diese Auswahlseite für die Zahlungsmethode kann von dem Händler oder von PostFinance gehostet werden.
  2. Der Kunde wird an SwissBilling weitergeleitet, und zwar über eine URL, die von SwissBilling bereitgestellt wird, und in der eine einmalige Transaktionsnummer und Händler-Identifizierung enthalten sind.
  3. Der Kunde beantragt einen Kauf auf Rechnung (Zahlung nach Lieferung). Dann prüft SwissBillling die Bonität des Kunden.
  4. Der Kunde wird über PostFinance wieder zum Händler zurückgeleitet. Der Händler erhält dann gleichzeitig einen Transaktionsstatus über PostFinance.

3. Integration

3.1 Konfiguration

Zur Aktivierung der Zahlungsmethode muss der Händler einen Akzeptanzvertrag mit SwissBilling abschliessen. Erstellen neuer SwissBilling-Transaktionen ist nur über den e-Commerce-Modus möglich. Bitte stellen Sie sicher, dass Sie hierfür ausschließlich die UTF-8-Variante unserer URL verwenden und als POST senden.

Sobald ein Kaufvertrag mit einer Zahlungsmethode unterschrieben wurde, muss der Händler mit unserer Merchanthelp (Händler-Hilfe) Kontakt aufnehmen, um die Zahlungsmethode zu konfigurieren und zu aktivieren. Nach Konfigurierung und Aktivierung er scheint diese im Web-Banking-Abschnitt der „Zahlungsmethoden“ in Ihrem PostFinance-Account.
Das Verfahren zur Erstellung eines Accounts läuft wie

  • folgt ab:
  • Der Händler unterschreibt einen Vertrag mit SwissBilling.
  • Der Händler oder SwissBilling teilen Merchanthelp die Details mit.
  • PostFinance kümmert sich um die SwissBilling Aktivierung für den Händler.

3.2 Auswahl der Zahlungsmethode

Beschreibung
PM / BRAND: SwissBilling

3.3 Eingabeparameter

Parameter

Beschreibung

PSPID Ihr Name in unserem System
Länge: 50
Pflichtfeld
ORDERID Bestellnummer des Händlers
Länge: 50
Pflichtfeld
EMAIL E-Mail-Adresse des Kunden
Länge: 6
Pflichtfeld
AMOUNT Summe der Transaktion
Länge: 6
Pflichtfeld
CURRENCY Währung des Auftrags (mit SwissBilling immer CHF)
Länge: ISO Alpha code
Pflichtfeld
LANGUAGE Sprache des Kunden
Länge: 5
Optionales Feld
REF_CUSTOMERID Kundennummer
Länge: 20
Optionales Feld
ECOM_BILLTO_COMPANY Unternehmensname des Kunden
Länge: 50
Optionales Feld
ECOM_BILLTO_POSTAL_NAME_PREFIX Präfix des Kunden
Länge: 4
Optionales Feld
ECOM_BILLTO_POSTAL_NAME_LAST Nachname des Kunden
Länge: 35
Pflichtfeld
ECOM_BILLTO_POSTAL_NAME_FIRST Vorname des Kunden
Länge: 35
Pflichtfeld
ECOM_BILLTO_POSTAL_STREET_NUMBER Hausnummer des Kunden
Länge: 10
Pflichtfeld
ECOM_BILLTO_POSTAL_STREET_LINE1 Strasse des Kunden (Zeile 1)
Länge: 35
Pflichtfeld
ECOM_BILLTO_POSTAL_STREET_LINE2 Strasse des Kunden (Zeile 2)
Länge: 35
Optionales Feld
ECOM_BILLTO_POSTAL_POSTALCODE Postleitzahl des Kunden
Länge: 5
Pflichtfeld
ECOM_BILLTO_POSTAL_CITY Stadt des Kunden
Länge: 25
Pflichtfeld
ECOM_BILLTO_POSTAL_COUNTRYCODE Ländercode des Kunden
Länge: 2
Pflichtfeld
ECOM_BILLTO_TELECOM_MOBILE_NUMBER Mobilfunknummer des Kunden
Länge: 20
Optionales Feld
ECOM_BILLTO_TELECOM_PHONE_NUMBER Telefonnummer des Kunden
Länge: 20
Optionales Feld
ECOM_SHIPTO_COMPANY Kundenlieferung - Unternehmensname
Länge: 50
Optionales Feld
ECOM_SHIPTO_POSTAL_NAME_PREFIX Lieferpräfix des Kunden
Länge: 4
Optionales Feld
ECOM_SHIPTO_POSTAL_NAME_FIRST Kundenlieferung - Vorname
Länge: 35
Pflichtfeld
ECOM_SHIPTO_POSTAL_NAME_LAST Kundenlieferung - Nachname
Länge: 35
Pflichtfeld
ECOM_SHIPTO_POSTAL_STREET_NUMBER Kundenlieferung - Hausnummer
Länge: 10
Pflichtfeld
ECOM_SHIPTO_POSTAL_STREET_LINE1 Kundenlieferung - Strasse (Zeile 1)
Länge: 35
Pflichtfeld
ECOM_SHIPTO_POSTAL_STREET_LINE2 Kundenlieferung - Strasse (Zeile 2)
Länge: 35
Optionales Feld
ECOM_SHIPTO_POSTAL_POSTALCODE Kundenlieferung - Postleitzahl
Länge: 5
Pflichtfeld
ECOM_SHIPTO_POSTAL_CITY Kundenlieferung - Stadt
Länge: 25
Pflichtfeld
ECOM_SHIPTO_POSTAL_COUNTRYCODE Kundenlieferung - Ländercode
Länge: 2
Pflichtfeld
ECOM_SHIPTO_TELECOM_MOBILE_NUMBER Kundenlieferung - Mobilfunknummer
Länge: 20
Optionales Feld
ECOM_SHIPTO_TELECOM_PHONE_NUMBER Kundenlieferung - Telefonnummer
Länge: 20
Optionales Feld
GENERIC_BL_DATA Info Sperrliste mit Kategorien des Händlers
Länge: 50
Optionales Feld
ITEMIDX ID eines Artikels
Länge: 15
Pflichtfeld
ITEMNAMEX Artikelname
Länge: 40
Pflichtfeld
ITEMPRICEX Preis für Artikeleinheit. Nur ITEMPRICEX
Länge: 10
Pflichtfeld
ITEMVATCODEX Artikel USt.-Code
Länge: 6
Pflichtfeld
ITEMQUANTX Artikelmenge
Länge: 4
Pflichtfeld
ITEMCATEGORYX Kategorie des Artikels
Länge: 50
Pflichtfeld

ITEMCATEGORYX Akzeptiert nur die folgenden Werte:
  • ComputersAndSoftware
  • Electronics
  • Phones
  • Appliances
  • HomeAndGarden
  • Fashion
  • HealthAndBeauty
  • Jewellery
  • Sport
  • LeisureAndHobbies
  • CarsAndMotorbikes
  • Furniture
  • KidsAndBaby
  • VideoGamesAndConsoles
  • ToysAndGames
  • Pets
  • FoodAndDrink
  • GiftAndFlowers
  • Entertainment
  • Travel
  • AuctionsAndGroupBuying
  • ServicesForIndividuals
  • ServicesForProfessionals
Bei ITEMCATEGORYX müssen Sie (der Händler) zunächst diese Kategorien definieren (ITEMCATEGORY1=SPORT, ITEMCATEGORY2=ESSEN usw .) und dann den Parameter in der Transaktion verwenden, zum Beispiel :
“<input type="hidden"
name="ITEMCATEGORY1"
value="SPORT"/>” .

Sie müssen 1* ITEMCATEGORY verwenden pro Artikel, zum Beispiel:
<input type="hidden" name="ITEMCATEGORY1" value="SPORT"/>
<input type="hidden" name="ITEMID1" value="2855"/>
<input type="hidden" name="ITEMNAME1" value="Adibok Supershoe"/>
<input type="hidden" name="ITEMPRICE1" value="3999"/>
<input type="hidden" name="ITEMQUANT1" value="1"/>
<input type="hidden" name="ITEMVATCODE1" value="20%"/>
<input type="hidden" name="TAXINCLUDED1" value="1"/>
TAXINCLUDEDX Muss immer als TAXINCLUDEDX=1 gesendet werden (1 – ITEMPRICEX versteht sich ink l.
MwSt.)
Länge: 1
Pflichtfeld

WICHTIGE HINWEISE:

  • SwissBilling kann nur mit CHF und bei Schweizer Kunden verwendet werden. Ein Artikel muss auch einen höheren Preis haben als 0.00CHF.
  • Der Händler kann bei der Anmeldung die B2B- oder B2C-Lösung wählen; bei B2B sind die Parameter zum Unternehmensnamen Pflichtfelder.
  • Für SwissBilling müssen die Versand- und die Rechnungsadresse identisch sein, um den Auftrag zu genehmigen!

4. Transaktionsverarbeitung und Maintenance-Aufgaben

4.1 Ausführung von Maintenance-Aufgaben

Maintenance-Aufgaben (wie: Datenerfassung, Stornierungen, Erstattungen usw.) für SwissBilling können über die manuellen Standard-Funktionen im Backoffice oder über DirectLink (direkte Maintenance) ausgeführt werden.

4.1.1 Ausführung von Maintenance-Aufgaben über das Backoffice Office

Autorisierte Transaktionen bestätigen

Befolgen Sie die folgenden Schritte, wenn Sie Ihre Transaktionen mit dem Zahlungsverfahren „Datenerfassung durch den Händler (manuell oder automatisch)“ ausführen und bestätigen möchten:

1. Wählen Sie diese Option unter "Konfiguration > Technische Informationen > Globale Transaktionsparameter > Voreingestelltes Datenerfassungs- (Zahlungs-)verfahren".

2. Bestätigen Sie die Transaktion manuell, wenn der Status „5 - autorisiert” ist. Eine Genehmigung (Autorisierung) ist lediglich eine Reservierung des Betrags auf der Karte/dem Konto Ihres Kunden (oder ein Abgleich gegen eine Sperrliste). Dies bedeutet jedoch KEINE Zahlung.

a. Rufen Sie die Transaktion über „Aufgaben > Transaktionen ansehen“ auf.

b. Klicken Sie auf den Button „Zahlung bestätigen (Datenerfassung): XXXXXXXX/X“ am Ende der Registerkarte mit den Auftragsdetails.

  • Der Status wechselt auf “91 - Zahlungsverarbeitung".
  • Sobald wir die Bestätigung der Datenerfassung von Ihrem Acquirer erhalten haben, wechselt der Status auf “9 - Zahlung angefordert". Dieser Status bedeutet, dass wir Ihren Acquirer aufgefordert haben, den reservierten Geldbetrag auf Ihr Bankkonto zu überweisen. Da Ihr Acquirer den Betrag auf Ihr Bankkonto überweist, können wir nicht genau sagen, wann Sie die Zahlung er halten.

Bevorzugen Sie automatisierte Ausführungen?

Batch: Senden Sie den Operation Code SAS in Feld 10

DirectLink: Senden Sie Operation=SAS

Zahlungen stornieren und erstatten
Eine Zahlung stornieren
Es handelt sich dabei um die Stornierung einer Zahlungsanforderung, die an einen Acquirer gesendet wurde. Dies ist nur bei Zahlungen per Kreditkarte möglich. Eine Zahlungsstornierung bedeutet, dass das Geld in der Regel noch nicht vom Bankkonto des Kunden abgerufen wurde (auf dem Bankkonto des Kunden ist weder eine Belastung noch eine Gutschrift erfolgt).
Einschränkung: Eine Zahlung kann am Tag der Datenerfassung bis zum Cutover-Zeitpunkt storniert werden (je nach Konfiguration Ihres Kontos). Der Cutover-Zeitpunkt ist der Zeitpunkt, an dem wir alle Zahlungsanforderungen an den Acquirer senden. Die Cutover-Zeit kann von Acquirer zu Acquirer variieren, liegt in der Regel jedoch bei 16.00 oder 24.00 Uhr MEZ. Sollte der Kunde seine Meinung ändern, nachdem diese Frist abgelaufen ist, müssen Sie das Geld zurückzahlen.

Eine Zahlung stornieren:

1. Rufen Sie die Transaktion über „Aufgaben > Transaktionen ansehen“ auf.

2. Klicken Sie auf den Button "Zahlung stornieren: XXXXXXXX/X“ am Ende der Registerkarte „Aufträge“.

Bevorzugen Sie automatisierte Ausführungen?

Batch: Senden Sie den Operation Code DES in Feld 10

DirectLink: Senden Sie OPERATION=DES

Erstattung einer Zahlung (Gutschrift)
Eine Erstattung bedeutet, dass das Geld zunächst belastet worden ist und später dem Bankkonto des Karteninhabers wieder gutgeschrieben wurde. Beide Finanzbewegungen erscheinen auf dem Kontoauszug des Karteninhabers.
Einschränkungen:

  • Die Option muss für Ihr Konto aktiviert sein.
  • Ihr Acquirer muss Erstattungen (Gutschriften) zulassen.
  • Erstattungen (Gutschriften) müssen bei der jeweiligen Zahlungsmethode möglich sein. Die Verfügbarkeit der Erstattungsfunktion hängt von Ihrem gewählten Vertragstyp ab.

Wenn Ihr Acquirer keine automatisierten Erstattungen (Gutschriften) zulässt, müssen diese direkt von Ihrem Acquirer ausgeführt werden.

Wie wird eine Zahlung (Gutschrift) erstattet?

1. Rufen Sie die Transaktion, die Sie erstatten möchten, über „Transaktionen ansehen > Details der Transaktion“ auf.

2. Klicken Sie auf den Button „Erstatten“, die Sie am Ende der Registerkarte „Aufträge“ finden. Sie können auch einen Grund für die Erstattung angeben.

Bevorzugen Sie automatisierte Ausführungen?

Batch: Senden Sie den RFS Operation Code in Feld 10

DirectLink: Senden Sie OPERATION = RFS

Möchten Sie mehr als den gezahlten Betrag erstatten?
Bei Kreditkarten besteht die Möglichkeit, einen höheren als den ursprünglich gezahlten Betrag gutzuschreiben.
Jedoch müssen Sie die oben genannten Einschränkungen berücksichtigen und prüfen, ob Ihr Kredit karten-Acquirer diese Möglichkeit einer „höheren Gutschrift“ zulässt.
Zudem muss die Teil-Maintenance-Option bei Ihrem Konto aktiviert sein, damit Sie den ursprünglichen Betrag in der Transaktionsübersicht ändern können.
Wenn Sie diese Funktion nutzen möchten, wenden Sie sich bitte an unser MerchantHelp-Team.

Möchten Sie mehr als den gezahlten Betrag erstatten?
Bei Kreditkarten besteht die Möglichkeit, einen höheren als den ursprünglich gezahlten Betrag gutzuschreiben.
Jedoch müssen Sie die oben genannten Einschränkungen berücksichtigen und prüfen, ob Ihr Kredit karten-Acquirer diese Möglichkeit einer „höheren Gutschrift“ zulässt.
Zudem muss die Teil-Maintenance-Option bei Ihrem Konto aktiviert sein, damit Sie den ursprünglichen Betrag in der Transaktionsübersicht ändern können.
Wenn Sie diese Funktion nutzen möchten, wenden Sie sich bitte an unser MerchantHelp-Team.

Spezielle Bearbeitungen von autorisierten Transaktionen

Die Durchführung einer Autorisierungsanfrage beinhaltet, dass die Gültigkeit der Karte/des Kontos sowie der damit verbundene Verfügungsrahmen überprüft werden. Jeder Acquirer kann den jeweiligen Betrag auf der Karte/dem Konto des Kunden für einen im Voraus festgelegten Zeitraum und für einen speziellen Händler reservieren.
Zusätzlich zu Autorisierungsanfragen ermöglicht Ihnen unser System auch die Stornierung und Erneuerung von Autorisierungen sowie die Durchführung manueller Autorisierungen. Die beiden letzten Funktionen sind nur bei Zahlungen per Kreditkarte möglich.

Eine Autorisierung stornieren

Immer dann, wenn eine Transaktion autorisiert ist, bedeutet es, dass der Acquirer einen bestimmten Geldbetrag auf der Karte/dem Konto des Kunden reserviert hat (oder die Anfrage mit einer Sperrliste abgeglichen wurde). Dieser reservierte Betrag ist dann an Sie zu zahlen, wenn die Zahlung angefordert wird.
Obwohl es Ihnen unsere Systemplattform ermöglicht, eine Autorisierung zu stornieren, unterstützen nicht alle Acquirer diese Art von Operation.
Um eine Autorisierung mit Hilfe unserer Systemplattform zu stornieren, rufen Sie die Transaktion auf dem Auswahlbildschirm über „Transaktionen ansehen“ auf und klicken Sie auf den Button „Genehmigung stornieren" am Ende der Seite mit den Auftragsdetails. Wir werden die Stornierung der Autorisierung in jedem Fall abbilden, auch wenn der Acquirer diese Operation nicht unterstützt.

Bevorzugen Sie automatisierte Ausführungen?

Batch: Senden Sie den Operation Code DES in Feld 10

DirectLink: Senden Sie OPERATION=DES

Eine Autorisierung erneuern

Der Gültigkeitszeitraum für eine Autorisierung ist abhängig vom Acquirer. In den Transaktionsdetails sehen Sie die noch verbleibenden Tage, bevor die Autorisierung für je de Transaktion abläuft. Diese Anzahl von Tagen dient nur als Hinweis. Der genaue Autorisierungszeitraum ist im Vertrag mit Ihrem Acquirer festgelegt.
Falls auf die Autorisierung innerhalb eines bestimmten Zeitraums keine Datenerfassung (Zahlungsanfrage) folgt, wird die Autorisierung in Rot angezeigt, was bedeutet, dass sie abgelaufen ist. Es besteht für den Händler keine Garantie mehr, dass das Geld noch für ihn auf der Karte/dem Konto des Kunden verfügbar ist.
Auch ohne eine gültige Autorisierung können Sie die Zahlung anfordern. Die Zahlung könnte jedoch verweigert werden (z. B. wenn keine aus reichende Deckung vorhanden ist).
Bevor Sie die Zahlung anfordern, können Sie die Autorisierung in Ihrem Backoffice erneuern. Dies bedeutet, dass Sie den Acquirer auffordern, das Geld für Sie erneut zu reservieren. Es ist jedoch möglich, dass der Karteninhaber seine Karte in der Zwischenzeit erneut eingesetzt hat und keine ausreichende Deckung mehr für Ihre Zahlung vorhanden ist.
Um eine Autorisierung zu erneuern, suchen Sie die Transaktion im Auswahlbildschirm über „Transaktionen ansehen“. Klicken Sie auf den Button „Genehmigung wiederholen“ am Ende der Seite mit den Auftragsdetails (sollte dieser Button nicht gleich zur Verfügung stehen, klicken Sie zunächst auf den Button „Fortgeschritten“).
Falls die Originalautorisierung mit dem 3-D Secure-Protokoll eingegangen ist, treffen die Original 3-D Secure-Bedingungen möglicherweise nicht mehr auf die erneuerte Autorisierung zu. In Übereinstimmung mit den Verfahrensregeln von VISA International und MasterCard International muss sich der Kunde bei je der Autorisierung ausweisen, um von der 3-D Secure-Garantie zu profitieren. Die Garantiebedingungen für Zahlungen nach dem 3-D Secure-Protokoll werden exklusivzwischen dem Händler (Ihnen) und seinem Acquirer verwaltet. Bei Ihrem Acquirer erhalten Sie hierzu weitere Informationen.
Die Verfügbarkeit der Option „Genehmigung wiederholen" hängt von Ihrem gewählten Vertragstyp ab. Die Option muss von unserer Merchanthelp aktiviert werden.
Bevorzugen Sie automatisierte Ausführungen?

Batch: Senden Sie den operation code REN in feld 10

DirectLink: Senden Sie operation=REN

Eine manuelle Autorisierung durchführen

Manchmal führt ein Acquirer eine Autorisierung nicht automatisch aus, z. B. wenn Sie Ihr genehmigtes Transaktionslimit erreicht haben. Der Acquirer lehnt die Autorisierung ab und fordert Sie in einer Mitteilung auf, Kontaktzu seinem Händler-Callcenter aufzunehmen. Wenn Sie den Acquirer kontaktieren und er entscheidet, eine Autorisierung durchzuführen, teilt er Ihnen möglicherweise einen Autorisierungscode telefonisch mit.

Sie können den Autorisierungscode, den Sie vom Acquirer erhalten haben (telefonisch oder per Fax usw.), in Ihr Backoffice eingeben. Rufen Sie die Transaktion über den Auswahlbildschirm „Transaktionen ansehen“ auf. Wenn Sie die Transaktionsdetails aufrufen, sehen Sie am Ende der Seite einen Button „Manuelle Autorisierung" (sollte dieser Button nicht sofort verfügbar sein, klicken Sie zunächst auf den Button „Fortgeschritten"). Geben Sie dann den Autorisierungscode, den Sie vom Acquirer erhalten haben, in das Feld neben dem Button „Manuelle Genehmigung“ ein und klicke n Sie auf „Manuelle Genehmigung“.
Als Händler tragen Sie die volle Verantwortung für die manuelle Eingabe des Autorisierungscodes, auch wenn die Transaktion anschliessend den Status 9 aufweist und keine wirkliche Zahlung ausgeführt wird. Wenn Sie einen 3-D Secure-Vertrag mit Ihrem Acquirer abgeschlossen haben, können sich die Garantiebedingungen für Zahlungen nach dem 3-D Secure-Protokoll, die für eine Standard-Autorisierung nach dem 3-D Secure-Protokoll gelten, von denen für Zahlungen nach einer manuellen Autorisierung unterscheiden. In Übereinstimmung mit den Verfahrensregeln von VISA International und MasterCard International muss sich der Kunde bei je der Autorisierung ausweisen, um von der 3-D Secure-Garantie zu profitieren. Die Garantiebedingungen für Zahlungen nach dem 3-D Secure-Protokoll werden
exklusiv zwischen dem Händler (Ihnen) und seinem Acquirer verwaltet. Bei Ihrem Acquirer erhalten Sie hierzu weitere Informationen.

Teil- und Mehrfachausführungen

Im Rahmen von „Teilausführungen“ (Teilverwaltung) können Sie Datenerfassungen, Autorisierungsstornierungen sowie Erstattungen für einen geringeren Betrag als den Original-Auftragsbetrag durchführen. „Mehrfachausführungen“ (Mehrfachverwaltung) ermöglichen Ihnen die Durchführung von mehrfachen Datenerfassungen,
Autorisierungsstornierungen und Erstattungen derselben Transaktion („Mehrfachausführungen“ und „Teilausführungen“ sind unterschiedliche Optionen). Die Verfügbarkeit dieser beiden Funktionen hängt von Ihrem gewählten Vertragstyp ab sowie davon, ob Ihr Acquirer diese Operationen erlaubt. Die Optionen müssen von
unserer Merchanthelp aktiviert werden. Ist die Teilausführungsoption für Ihr Konto aktiviert, sehen Sie neben den Maintenance-Buttons am Ende der Seite mit den Auftragsdetails Textfelder, in die Sie den Betrag eingeben können. Wenn die Mehrfachausführungsoption für Ihr Konto aktiviert ist, sehen Sie neben den Textfeldern, in die Sie einen Betrag eingeben können, eine „Letzte“-Checkbox.

Teilausführungen (Teilverwaltung)

Zur Durchführung einer Datenerfassung/Erstattung/Autorisierung/Stornierung für einen Teilbetrag müssen Sie auf die Seite mit den Transaktionsdetails gehen. Dort finden Sie am Ende der Seite den Button „Zahlung bestätigen (Datenerfassung)“/ Erstattung/„Autorisierung stornieren“.

1. Tragen Sie den Teilbetrag in das Feld neben dem entsprechenden Button ein (standardmässig wird der Gesamtbetrag eingegeben).

2. Klicken Sie auf den entsprechenden Button und bestätigen Sie. Bevorzugen Sie automatisierte Ausführungen?

Do you prefer automated operations?

Datenerfassungen

Batch: Senden Sie den Operation Code SAS in Feld 10

DirectLink: Senden Sie OPERATION=SAS

Erstattungen

Batch: Senden Sie den Operation Code RFS in Feld 10

DirectLink: Senden Sie OPERATION=RFS

Autorisierung stornieren

Batch: Senden Sie den Operation Code DES in Feld 10

DirectLink: Senden Sie OPERATION=DES

Mehrfachausführungen (Mehrfachverwaltung)

Um bei der Mehrfachausführung von Datenerfassungen/Erstattungen oder einer Autorisierungsstornierung die Transaktion für weitere Maintenance-Aktivitäten offen zu halten, gehen Sie auf die Seite mit den Transaktionsdetails, dort finden Sie am Ende der Seite den Button „Zahlung bestätigen (Datenerfassung)“/Erstattung/„Autorisierung stornieren“.
1. Tragen Sie den Teilbetrag in das Feld neben dem entsprechenden Button ein (standardmässig wird der Gesamtbetrag eingegeben).
2. Setzen Sie ein Häckchen im Feld neben „Letzte“, wenn dies die letzte Operation ist, die Sie zu dieser Transaktion durchführen möchte, ODER löschen Sie das Häkchen im Feld neben „Letzte“, wenn Sie noch weitere Operationen zu dieser Transaktion durchführen möchten (z. B. 50,00 EUR für die Waren anfordern, die Sie an den Kunden bereits ausgeliefert haben, und den restlichen Transaktionsbetrag anfordern, wenn Sie den Restausliefern).
3. Klicken Sie auf den entsprechenden Button und bestätigen Sie.

Bevorzugen Sie automatisierte Ausführungen?

Datenerfassungen

Batch: Senden Sie den Operation Code SAL (nicht letzte) oder SAS (letzte) in Feld 10

DirectLink: Senden Sie OPERATION=SAL (nicht letzte) oder OPERATION=SAS (letzte)

Erstattungen

Batch: Senden Sie den Operation Code RFD (nicht letzte) oder RFS (letzte) in Feld 10

DirectLink: Senden Sie OPERATION=RFD (nicht letzte) oder OPERATION=RFS (letzte)

Autorisierung stornieren

Batch: Senden Sie den Operation Code DEL (nicht letzte) oder DES (letzte) in Feld 10

DirectLink: Senden Sie OPERATION=DEL (nicht letzte) oder OPERATION=DES (letzte)

Direkte Maintenance
Eine direkte Maintenance-Anforderung von Ihrer Anwendung ermöglicht es Ihnen:
  • Eine Datenerfassung (Zahlung) eines autorisierten Auftrags automatisch durchzuführen (im Gegensatz zu manuell im Backoffice);
  • Eine Autorisierung eines Auftrags zu stornieren;
  • Eine Autorisierung eines Auftrags zu erneuern;
  • Einen bezahlten Auftrag zu erstatten.

Datenerfassungen, Autorisierungsstornierungen und Autorisierungserneuerungen gelten spezie ll für Händler, die ihr Konto/ihre Anforderungen so konfiguriert haben, dass die Autorisierung und die Datenerfassung in zwei Schritten durchgeführt werden.

Maintenance-Anforderung
1. Anforderungs-URL
Die Anforderungs-URL in der TEST-Umgebung ist https://e-payment.postfinance.ch/ncol/test/maintenancedirect.asp.
Die Anforderungs-URL in der PRODUCTION-Umgebung ist https://e-payment.postfinance.ch/ncol/prod/maintenancedirect.asp.
„Test“ in "Prod“ ändern
Ersetzen Sie „test“ durch „prod“ in der Anforderungs-URL, wenn sie zu Ihrem Production-Konto wechseln. Wenn Sie vergessen, die Anforderungs-URL zu ändern, sobald Sie mit wirklichen Aufträgen arbeiten, werden Ihre Maintenance-Transaktionen an die Testumgebung geschickt und nicht an die Acquirer/Banken.

1.2 Anforderungsparameter
Die folgende Tabelle enthält die Pflichtangaben von Anforderungsparametern zur Durchführung einer Maintenance-Aufgabe:
Feld Beschreibung
AMOUNT Auftragssumme mit 100 multipliziert
Dies ist nur erforderlich, wenn sich die Summe der Maintenance von der Summe der ursprünglichen Autorisierung unterscheidet. Dennoch empfehlen wir die Verwendung in allen Fällen.
Unser System prüft, ob die Summe der Maintenance-Transaktion nicht höher als die Autorisierungs-/Zahlungssumme ist.
OPERATION
Mögliche Werte:
  • REN: Erneuerung der Autorisierung, wenn die ursprüngliche Autorisierung nicht mehr gültig ist.
  • DEL: Autorisierung stornieren, Transaktion bleibt offen für weitere mögliche Maintenance-Aufgaben
  • DES: Autorisierung stornieren, Transaktion nach dieser Aufgabe schliessen.
  • SAL: Teilweise Datenerfassung (Zahlung), Transaktion bleibt offen für weitere mögliche Datenerfassung.
  • SAS: (letzte) teilweise oder vollständige Datenerfassung (Zahlung), schliessen der Transaktion (für weitere Datenerfassungen) nach dieser Datenerfassung.
  • RFD: teilweise Erstattung (eines bezahlten Auftrags), Transaktion bleibt offen für weitere mögliche Erstattung.
  • RFS: (letzte) teilweise oder vollständige Erstattung (eines bezahlten Auftrags), schliessen der Transaktion nach dieser Erstattung.
Bitte beachten Sie: Bei DEL und DES unterstützen nicht alle Ac quirer die Stornierung einer Autorisierung. Wenn Ihr Acquirer DEL/DES nicht unterstützt, werden wir dennoch die Stornierung der Autorisierung im Backoffice simulieren.
ORDERID Sie können die PAYID oder die ORDERID senden, um den ursprünglichen Auftrag zu identifizieren. Wir empfehlen die Verwendung der PAYID.
PAYID Die PSPID Ihres Kontos.
PSPID Die ID Ihres PSP
PSWD Passwort Ihres API-Benutzers
SHASIGN
Signatur (hashed string) zur Authentifizierung der Daten (siehe SHA-IN-signature)
USERID
Ihr API-Benutzer

1.2.1 Testseite
Sie können direkte Maintenance-Anforderungen hier testen: https://e-payment.postfinance.ch/ncol/test/testdm.asp

2. Maintenance-Antwort
Unser Server schickt eine XML-Antwort auf die Maintenance-Anforderung:
Beispiel für eine XML-Antwort auf eine direkte Maintenance-Anforderung
<?xml version=”1.0”?>
< ncresponse orderID=”99999” PAYID=”1111111” PAYIDSUB=”3” NCSTATUS=”0” NCERROR=””
NCERRORPLUS=”” ACCEPTANCE=”12345” STATUS="91" amount="125" currency="EUR"/>

Die folgende Tabelle enthält eine Liste der NC-Antwort-Tag-Attribute:

Feld Beschreibung
ACCEPTANCE Akzeptanz-Code, der vom Acquirer zurückgeschickt wird
AMOUNT Auftragssumme (nicht mit 100 multipliziert)
CURRENCY Währung des Auftrags
NCERROR Fehler-Code
NCERRORPLUS Erläuterung des Fehler-Codes
NCSTATUS Erste Stelle von NCERROR
ORDERID Ihre Auftragsreferenz
PAYID Zahlungsreferenz in unserem System
PAYIDSUB
ID History-Level der Maintenance-Aufgabe an der PAYID
STATUS Transaktionsstatus (Possible statuses)

Die Standard-NC-Antwort-Tag-Attribute sind die gleichen wie bei einer XML-Antwort auf einen neuen Auftrag, ausser bei dem Zusatz-Attribut PAYIDSUB.
1.3 Doppelte Anforderung
Wenn Maintenance zwei Mal für denselben Auftrag angefordert wird, wird die zwei te Anforderung theoretisch abgelehnt mit einem Fehler „50001127“ (Dieser Auftrag ist nicht autorisiert), d a die erste er folgreiche Transaktion den Auftragsstatus geändert hat.

4.1.3 Autorisierung und Erfassung

SwissBilling pflegt einen Ablauf in 2 Schritten, was bedeutet, dass Autorisierung und Erfassung im Auftragsverfahren getrennt werden können. Dennoch werden nur vollständige Erfassungen von SwissBilling akzeptiert.

4.1.4 Erstattungen

Weitere Informationen zu Erstattungen finden Sie in Kapitel 3.1 Ausführung von Maintenanc e-Aufgaben.

4.1.5 Testanmeldedaten

Tests laufen auf SwissBilling. Setzen Sie sich mit unserer Merchanthelp (Händlerhilfe) in Verbindung, um einen Endto-End-Test aufzubauen.
Tests müssen mit der HändlerID, dem Passwort und der ShopID durchgeführt werden, die bei der Unterzeichnung eines Vertrags mit SwissBilling mitgeteilt wurden.