Produktfamilie
PAYONE bietet Zahlungen mit Kreditkarte und SEPA-Lastschriftverfahren an.
Bitte beachten Sie, bevor Sie mit der Implementierung von SubscriptionJS auf Ihrer Sign up Seite beginnen, dass nicht alle Zahlungsmethoden dieses PSP die ProcessPaymentData-Methode unterstützen:
Zahlungsmethode | ProcessPaymentData Methode unterstützt |
Kreditkarte (inkl. 3D Secure) | Ja |
Lastschriftverfahren (Direct Debit) | Ja |
Auf Rechnung | Nein |
Konfiguration Ihres PAYONE-Accounts
Frisbii Transform kann in Kombination mit dem PAYONE Payment Merchant Interface (PMI) eingesetzt werden
Payone Einstellungen
Modul Protect ist erforderlich (muss beantragt und durch PAYONE freigeschaltet werden)
Refunds API muss für alle Zahlungsmittel freigeschaltet sein (muss beantragt und durch PAYONE freigeschaltet werden)
Mandatgenerierung muss freigeschaltet sein (muss beantragt und durch PAYONE freigeschaltet werden)
Client-API Zugang muss aktiviert sein (muss beantragt und durch PAYONE freigeschaltet werden)
Die Gläubiger-ID muss dieselbe sein, wie die in Ihrem Frisbii Transform-Konto
die Zahlungsmittel Kreditkarte und/oder SEPA Lastschrift müssen erlaubt sein (je nach Anforderung)
Falls Sie SEPA-Lastschriftzahlungen von außerhalb Deutschlands empfangen möchten, müssen Sie alle Länder einzeln von PAYONE freischalten lassen.
In PAYONE und Frisbii Transform muss der gleiche Hash-Algorithmus gewählt werden (MD5 oder SHA2-384).
Berücksichtigen Sie in der Konfiguration Ihres Payment Gateways die Aktivierung von "extended response-data" für den Test- und den Live-Modus.
Im Modul Protect muss die folgenden Sicherheitsfunktion aktiviert sein:
Bankaccount Check
Folgende Funktionen werden von uns empfohlen:
POS Sperrdatei
Überprüfung der Kreditkarte
Dynamische Steuerung von 3-D Secure
Für einige Anwendungsfälle kann es auch sinnvoll sein, die folgende Auswahl zu verwenden:
BIN Check
BIN Country Filter
IP Check
IP Country Filter
Bitte wenden Sie sich an Ihren PAYONE Kundenbetreuer, um weitere Informationen zu dem Modul zu erhalten.
Livebetrieb
Es ist prinzipiell nur ein Zahlungsportal notwendig. Wenn Sie 3D-Secure für Kreditkartenzahlungen verwenden möchten, können Sie vielleicht benötigen Sie möglicherweise ein zweites PAYONE Portal:
eine für die ersten Zahlungen; 3D Secure muss aktiviert werden
ein weiteres für die wiederkehrenden Zahlungen (3D-Secure kann hier ebenfalls aktiv sein, muss es jedoch nicht)
Ob ein zweites Portal notwendig ist, hängt von dem für Ihren PAYONE-Account verwendeten Aquirer ab. Bitte fragen Sie bei PAYONE nach, ob dies bei Ihrem Account der Fall ist.
Bitte beachten Sie, dass Sie die TransaktionsStatus-URL aus den PAYONE Einstellungen in Ihrem Frisbii Transform Konto in den PAYONE Portaleinstellungen zu speichern.
Testbetrieb
Für den Testmodus benötigen Sie nur ein Portal, das in den Frisbii Transform Einstellungen für beide Portale verwendet werden kann. 3D-Secure muss aktiv sein.
Webhooks
Speichern Sie die URL für die Webhooks, die PAYONE an das Frisbii Transform System sendet, in Ihrem PAYONE Konto.
Sie können die URL Ihres PAYONE Kontos im Frisbii Transform System nachschlagen (siehe Abbildung oben) und im PAYONE Konto unter"Konfiguration > Zahlungsportale > Erweitert" eingeben.
Speichern Sie die Einstellung in Ihrem PAYONE-Account.
Bitte beachten Sie, dass die Fertigstellung Ihres PAYONE-Accounts auf Seiten von PAYONE einige Zeit in Anspruch nehmen kann. Dieses Konto muss eingerichtet werden, bevor Sie PAYONE mit Frisbii Transform nutzen können.
Konfiguration in Ihrem Frisbii Transform Konto
Die Einstellungen des Zahlungsanbieters in Ihrem billwerk Account nehmen Sie unter "Einstellungen > Zahlung > Zahlungseinstellungen > PAYONE" vor.
Sie benötigen die folgenden Daten, die Sie bitte Ihrem PAYONE-Account entnehmen. Alle Felder sind Pflichtfelder:
Händler-ID
Unterkonto-Kennung
Portal #1 - Portal-Id
Portal #1 - Schlüssel
Portal #2 - Portal Id
Portal #2 - Schlüssel
Falls Sie nur ein Portal verwenden, tragen Sie bitte dieselben Daten in Portal #1 und Portal #2 ein.
Die Daten finden Sie in Ihrem PAYONE-Account unter: "Konfiguration > Zahlungsportale > API-Parameter".
Mit der Auswahl "Modus" stellen Sie ein, ob Sie die PAYONE-Konfiguration im Test- oder Produktivmodus betreiben wollen.
Speichern Sie die Angaben, nachdem Sie alles ausgefüllt haben und aktivieren Sie nun die gewünschten Zahlungsmittel auf der Übersichtsseite der Zahlungsanbieter. Vergessen Sie nicht, diese Auswahl nochmals abzuspeichern. Die Zahlungsmethode ist nun in Ihrem Frisbii Transform-Konto aktiviert.
Zahlen auf Rechnung
(Wird nicht mehr angeboten, alternativ kann der CAMT.053 importieren verwendet werden)
Wenn Sie Zahlen auf Rechnung mit PAYONE verwenden möchten, lassen Sie bitte das Feature "Offene Rechnung" bei PAYONE für Ihren Account freischalten.
Zahlen auf Rechnung kann generell in zwei verschiedenen Optionen verwendet werden. Entweder überweisen Ihre Kunden auf ein Treuhandkonto von Payone oder Sie gewähren Payone Einblick auf ein Bankkonto von Ihnen, auf dem Payone eingehende Zahlungen erfassen kann.
Dann aktivieren Sie die Zahlungsmethode in den Zahlungseinstellungen in Frisbii Transform.
Ihr Kunde muss bei jeder neuen Überweisung einen eindeutigen Rechnungsreferenzcode als Verwendungszweck angeben. Diesen Rechnungsreferenzcode können Sie als Platzhalter automatisch auf der Rechnung mit ausgeben lassen. Fügen Sie in der PDF-Rechnungsvorlage im Bereich "Text Zahlung auf Rechnung (HTML)" den Platzhalter {invoice.referencecode} ein. Damit erhält Ihr Kunde den einmaligen Verwendungszweck für die nächste Überweisung. Wenn dieser Verwendungszweck angegeben wird, kann die eingehende Zahlung automatisch erfasst und der versendeten Rechnung und dem Vertragskonto zugeordnet werden.
Sie können das Fälligkeitsdatum von Zahlungen in den Frisbii Transform Zahlungseinstellungen für PAYONE konfigurieren. Gehen Sie dazu in die PAYONE-Einstellungen und setzen Sie die gewünschte Fälligkeitsdauer ein. Das Zahlungsziel wird somit automatisch auf der erstellten Rechnung angezeigt.
Einschränkungen:
Dauerüberweisungen Ihrer Kunden werden bei "Zahlen auf Rechnung" nicht unterstützt. Da sich bei Dauerüberweisung der Verwendungszweck nicht ändert, kann hier keine eindeutige Zuordnung zu einer vorher erstellten Rechnung hergestellt werden. Sie können Ihre Kunden sowohl in Ihren AGB und auf Ihrer Rechnung darauf hinweisen, dass dieser Zahlungsmodus nicht unterstützt wird.
Eine Mischung aus Akontozahlungen über Payone und zusätzlichen Zahlungseingängen auf anderen Konten, die in Frisbii Transform als externe Zahlungen erfasst werden, wird nicht unterstützt. Eingehende Zahlungen, die noch nicht an Frisbii Transform übermittelt wurden, müssen immer über das Payone-Händlerportal zugeordnet werden.
Auf Mahnungen kann kein expliziter Verwendungszweck ausgegeben werden, der für eine automatische Verbuchung bei Payone verwendet werden kann. Kunden müssen die offenen Rechnungen mit dem auf der ursprünglichen Rechnung ausgegebenen Verwendungszweck begleichen.
3. SEPA-Referenzzeile konfigurieren
Sie können die SEPA-Referenzzeile manuell konfigurieren. Weitere Informationen finden Sie in dem Artikel SEPA-Referenz konfigurieren.
Testdaten
Folgende Zahlungsmitteldaten können Sie für Ihre Tests einsetzen:
Kreditkarte
Mit 3-D Secure:
Kreditkartennummer | CVC | 3-D Secure Passwort: | Ablaufdatum | |
VISA (Geprüft durch VISA) | 4012001037141112 | Beliebige dreistellige Zahlenkombination | 12345 | Datum in der Zukunft |
MasterCard (MasterCard SecureCode) | 5453010000080200 | Beliebige dreistellige Zahlenkombination | 12345 | Datum in der Zukunft |
MasterCard (MasterCard SecureCode) | 27209900000000071 | Beliebige dreistellige Zahlenkombination | 12345 | Datum in der Zukunft |
Ohne 3-D Secure:
Kreditkartennummer | CVC | Ablaufdatum | |
VISA | 4111111111111111 | Beliebige dreistellige Zahlenkombination | Datum in der Zukunft |
MasterCard | 5500000000000004 | Beliebige dreistellige Zahlenkombination | Datum in der Zukunft |
American Express | 340000000000009 | Beliebige dreistellige Zahlenkombination | Datum in der Zukunft |
JCB | 3088000000000009 | Beliebige dreistellige Zahlenkombination | Datum in der Zukunft |
Carte Bleue | 4973010000000004 | Beliebige dreistellige Zahlenkombination | Datum in der Zukunft |
Diners Club | 30000000000004 | Beliebige dreistellige Zahlenkombination | Datum in der Zukunft |
Entdecken Sie | 6011111111111117 | Beliebige dreistellige Zahlenkombination | Datum in der Zukunft |
Zahlen auf Rechnung (Überweisung)
Um die SEPA-Lastschrift nutzen zu können, müssen Sie unter"Einstellungen > Konto > Firma > Gläubiger-Identifikation" eine Gläubiger-Identifikation (z.B. DE98ZZZ09999999999) konfigurieren.
IBAN | DE85123456782599100003 |
BIC | TESTTEST |
Kontoinhaber | Jeder beliebige Name |
Ergebnis | Erfolgreicher Lastschrifteinzug |
Zahlen auf Rechnung
Wenn Sie diese Zahlungsart mit PAYONE nutzen, können Sie die folgenden Testdaten verwenden:
Nachname | Testfall |
Zahler | wird bezahlt |
Unterzahler | wird teilweise bezahlt |
Überzahler | Der gezahlte Betrag ist höher als der Rechnungsbetrag |
Neverpayer | Die Rechnung wird nicht bezahlt |
Kundendaten
PAYONE definiert Kundendatenfelder, die obligatorisch sind, da sonst die Zahlung fehlschlägt (z.B. errorCode = 901). Diese sind:
Nachname
Vorname (Falls es sich nicht um eine Firma handelt)
Stadt
Land
Funktionseinschränkungen
SEPA Lastschrift
Für jede IBAN kann nur ein SEPA-Lastschriftmandat in PAYONE erstellt werden. Alle zusätzlichen Mandate für diese IBAN beziehen sich auf das bestehende Mandat.
Bei der Erstellung von Lastschiftmandaten wird stets das aktuelle Tagesdatum als Mandat-Signatur-Datum gesetzt, die PAYONE Schnittstelle bietet keine Möglichkeit ein frei gewähltes Datum zu übergeben. Die Schnittstelle unterstützt nicht die Übergabe eines benutzerdefinierten Datums.
Bitte informieren Sie sich vor der Nutzung des europaweiten SEPA-Lastschriftverfahrens, ob dies mit Ihrem PAYONE-Konto möglich ist, indem Sie sich an den PAYONE-Support wenden.
Debitorenmanagement
PAYONE bietet ein eigenes Debitorenmanagement-System an, das nicht in Kombination mit Frisbii Transform eingesetzt werden kann, da bei der Verwendung von Frisbii Transform Frisbii Transform das führende Debitorenmanagement-System sein muss. Funktionen im Debitorenmanagement-System von PAYONE, wie z.B. "Forderungen ausbuchen", sind nicht mit Frisbii Transform synchronisiert.
Kontaktdaten:
PAYONE Merchant Service: sales@payone.com ; +49 431-25968-400