Home

Implementation_Guide_Zahlungsformular_PayZen_V2.3

1. Wartet auf Autorisierung Autorisierungs anfrage OK Autorisierung angenommen i Wartet auf i Stornierung Kassenschnitt Am Tag des angefragten Bank Kassenschnitts Vorgelegt Die Stornierung einer Rate zieht in keinem Fall die Stornierung der folgenden Raten nach sich deren Bank Kassenschnitt noch aussteht PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 16 Modus f r manuelle Best tigung Lebenszyklus einer Transaktion f r sofortige Barzahlung Nach einem Zahlungsauftrag werden automatisch verschiedene Pr fungen durchgef hrt e Die 3 D Secure Authentifizierung e Verschiedene lokale Pr fungen die direkt durch die Zahlungsplattform durchgef hrt werden dazu z hlen potenziell die Pr fungen in Verbindung mit der Anmeldung beim zus tzlichen Dienst f r Betrugsschutzkontrollen e Eine Autorisierungsanfrage wird an die Bank des K ufers gesendet Wenn eine dieser Pr fungen scheitert wird der Zahlungsauftrag abgelehnt Der K ufer wird dar ber auf dem Bildschirm informiert Im Back Office kann die Transaktion mit dem Status Verweigert abgerufen werden Im umgekehrten Fall wird die Zahlung angenommen und die Transaktion kann im Back Office mit dem Status Zu best tigen abgerufen werden Der H ndler muss die Transaktion dann vor dem angefragten Datum des Kassenschnitts best tigen Andernfalls erh lt die Transaktion den Status Verfallen und der Bank Kassenschnitt kann
2. PayZen 2 3 6 Benachrichtigungseinstellungen 31 6 4 Konfigurieren der Benachrichtigung bei Abschluss der Zahlung Diese Benachrichtigung ist unerl sslich um das Ergebnis eines Zahlungsauftrags zu bermitteln So konfigurieren Sie diese Benachrichtigung 1 Wechseln Sie zu https de payzen eu vads merchant 2 Gehen Sie zum Men Einstellung gt Regeln der Benachrichtigungen 3 Klicken Sie mit der rechten Maustaste auf IPN am Ende der Zahlung amp IPN Aufruf H ndler E Mail Aktiviert Name x IPN bei Stornierung x IPN nach Aktion im Backoffice x IPN bei Autorisierung durch batch x IPN bei nderung durch batch Y IPN am Ende der Zahlung Abbildung 15 Konfigurieren der IPN am Ende der Zahlung 4 W hlen Sie Regel verwaltung 5 Geben Sie die URL Ihrer Seite in die Felder Aufzurufende URL im Testumfeld und Aufzurufende URL im Produktionsumfeld ein ey Test DE Regelverwaltung CHECKURL IPN am Ende der Zahlung x b Einstellungen Regelbedingungen Informationen gt Allgemeine Einstellungen Name der Regel IPN am Ende der Zahlung IPN Einstellungen Die URL m ssen von unserem Server aus erreichbar sein Die URL zur Weiterleitung sind verboten Aufzurufende URL im Produktionsumfeld m E Mailadresse zur Fehlermeldung nlor o mn mon Automatischer Neuversuch im Falle eines F Scheiterns Schlie en Abbildung 16 IPN am Ende der Zahlung 6 F lle
3. LF e lt 10 praeldervappend char y se O else bunleer oppend ehar z e 37 2a 270 Funktion die die Signatur berechnet publie ActionForward performCheck ActionMapping actionMapping Basivoirorm form HttpServletRequest request HttpServletResponse response SortedSet lt String gt vadsFields new TreeSet lt String gt Enumeration lt String gt paramNames request getParameterNanes while paramNames hasMoreElements String paramName paramNames nextElement ir paremllamer stareem en a vadsFields add paramNane String sep Sha SEPARATOR StringBuilder sb new StringBuilder for String vadsParamName vadsFields String vadsParamValue request getParameter vadsParamName if vadsParamValue null sb append vadsParamValue sb append sep sb append shakey String sign Sha encode s0 TOStrLng s return signy PayZen 2 3 9 Berechnen der Signatur 73 9 2 Beispiel einer PHP Implementierung Tuncetion chart eslenlates the segqnature l params s table containing the Fields tO send to the Form Eo eion geo naa perzemea ITnircializarion of the yariable char will contain the string co encrypt nar e OnE sort field alphabetically parans foreach Sparams as snom gt valeur I Beeowery or wacs r elds if Subor nom da WR Concatenartion wirta Vi mona re o me zu wu IE Adesindstcbe certi ore zitate
4. gnrnnannedbaunananansuranannn a Verweigert KO gt Lokale Kontrollen Aannnnnnnnnnnnnnnnnngannnnnnnna KO Versendung von E Mail an K ufer Wartet auf Autorisierung OK Autorisierung angenommen D Wartet auf Stornierung Kassenschnitt Am Tag des angefragten Bank Kassenschnitts Vorgelegt PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 15 Lebenszyklus einer Transaktion f r Ratenzahlung Die erste Rate einer Ratenzahlung verh lt sich zum Datum ihres Kassenschnitts exakt wie eine Transaktion f r sofortige Barzahlung oder eine Transaktion f r zeitverz gerte Barzahlung Die folgenden Raten erhalten standardm ig den Status Wartet auf Autorisierung Die Bank des K ufers kann die Autorisierungsanfrage zur ckweisen Die Zahlungsplattform informiert daraufhin den H ndler per E Mail ber die Verweigerung der Transaktion Die Autorisierungsanfragen f r die folgenden Raten werden automatisch als Transaktion f r eine zeitverz gerte Zahlung ausgef hrt also mit zwei m glichen Daten e Standardverfahren am Tag des gew nschten Datums f r den Bank Kassenschnitt e Verfahren mit Autorisierung im Voraus abh ngig vom gew hlten Zahlungsmittel an T A siehe Tabelle zur G ltigkeit einer Autorisierung vor dem gew nschten Datum des Bank Kassenschnitts Die weiteren Raten erfolgen nach dem folgenden Statusschema Fall einer nicht wiederholten Autorisierungsanfrage
5. Beschreibung Information zum Benutzer der die Zahlung veranlasst Die Verwendung des Betrugsschutzmoduls ClearSale erfordert dass dieses Feld mit CPF CNPJ ausgef llt wird Steuernummer im numerischen Format mit 11 bis 20 Stellen Im Fall einer Zahlung durch Formular wird dieser Parameter in der Antwort mit dem in der Anforderung bermittelten Wert gesendet Im Fall einer MOTO Zahlung ber das Back Office wird dieses Feld mit dem Benutzerkonto Login ausgef llt das diese Zahlung durchgef hrt hat Format ans 255 Fehlercode 61 Kategorie Informationen zum K ufer E vads validation mode Beschreibung Gibt den Best tigungsmodus der Transaktion an Format string enum Fehlercode 05 Beschreibung M gliche Werte Standardeinstellung des Shops beibehalten kann im Back Office festgelegt vorhanden werden oder leer DE Automatische Best tigung durch die Zahlungsplattform Manuelle Best tigung durch den H ndler Kategorie Informationen zur Transaktion E vads version Beschreibung Pflichtparameter Version des Protokolls f r den Austausch mit der Zahlungsplattform Format string enum Fehlercode 01 M glicher Wert V2 Kategorie Technische Informationen PayZen 2 3 16 Datenlexikon 159 E vads _ warranty result Beschreibung Format M gliche Werte Kategorie In der Antwort zur ckgegebenes Feld Gibt die Zahlungsgarantie im Fall einer angenommenen Zahlu
6. gt name vads currency value 978 gt name vads page action value PAYMENT gt name vads payment config value SINGLE gt name vads redirect error message value Sie werden auf ihre Webseite name vads_redirect error timeout value 0 gt name vads redirect success message value Sie werden auf ihre Webseite name vads_redirect success _timeout value 0 gt name vads_return_mode value GET gt name vads site id value 12345678 gt name vads trans date value 20140526101407 gt name vads trans id value 239848 gt name vads url return value http demo com return php gt name vads yersion value v7 name signature value 86b2al7b9a5fcefb6c0120c57b25ec86ad1704ee gt name bezahlen value Bezahlen gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 60 8 9 Personalisierung der Zahlungsseite Sie k nnen bestimmte Elemente der Zahlungsseite personalisieren die bei der Zahlung angebotenen Zahlungsmittel e die Sprache in der die Zahlungsseiten angezeigt werden e die Sprachen die dem K ufer auf den Zahlungsseiten angezeigt werden L nderflaggen e den Namen und die URL des Shops e die Beschriftung der Schaltfl che Zur ck zum Shop Wenn Sie die Option Fortgeschrittene Personalisierung aktivieren k nnen Sie die Zahlungsseite so bearbeiten dass sie visuell dem Design Ihres Shops entspricht Dies schafft eine vertraute Umgebung und f rdert das V
7. vads_version Version des Austauschprotokolls vads _payment_config Zahlungsart siehe Schritt 2 vads_capture_delay Zeitspanne vor Bank Kassenschnitt VD vads_validation_mode Best tigungsmodus 0 automatisch oder 1 manuell Tabelle 6 Liste der Felder Ratenzahlung 2 Geben Sie einen Wert in das Feld vads_payment_config ein und beachten Sie dabei die folgende Syntax e Feste Betr ge und Ratenf lligkeiten MULTI first 1000 count 3 period 30 oder first entspricht dem Betrag in der kleinsten W hrungseinheit der ersten Zahlung die am Zahlungstag ausgef hrt wurde count entspricht der Gesamtzahl der Raten period bestimmt das Intervall zwischen jeder Rate e Personalisierte Betr ge und Ratenf lligkeiten MULTI_EXT Datumi Betrag1 Datum2 Betrag2 Datum3 Betrag3 wobei Datumi1 Betragi das Datum und den Betrag der ersten Zahlung festlegt Die Betr ge werden in der kleinsten Einheit der W hrung angegeben Die Gesamtsumme der Betr ge muss dem Wert im Feld vads_amount entsprechen Die Daten werden im Format JJJJMMDD angegeben PayZen 2 3 7 Erzeugen eines zahlungsformulars 44 Setzen Sie das Feld vads_capture_delay auf 0 Der Bank Kassenschnitt f r die 1 Zahlung erfolgt am selben Tag Setzen Sie das Feld vads_validation_mode auf 0 wenn Sie eine automatische Best tigung w nschen Bank Kassenschnitt f r die Zahlung erfolgt automatisch F r eine manuelle Best tigung manueller Vorgang im Back Offic
8. E vads cust address Beschreibung Postanschrift des K ufers Format ans 255 Fehlercode 19 Hinweis Pflichtfeld f r 3xCB Cofinoga Kategorie Informationen zum K ufer PayZen 2 3 16 Datenlexikon 112 E vads cust address number Beschreibung Hausnummer des K ufers Format an 5 Fehlercode 112 Kategorie Informationen zum K ufer E vads cust cell phone Beschreibung Mobilfunknummer des K ufers Format an 32 Fehlercode 77 Kategorie Informationen zum K ufer E vads cust city Beschreibung Stadt des K ufers Format an 128 Fehlercode 21 Hinweis Pflichtfeld f r 3xCB Cofinoga Kategorie Informationen zum K ufer E vads cust_country Beschreibung Erm glicht die Angabe des L ndercodes des K uferlands gem Norm ISO 3166 Format a2 M gliche Werte BRASILIEN KORSIKA FRANKREICH GUADELOUPE MARTINIQUE NEUKALEDONIEN ST PIERRE UND MIQUELON a nn Hinweis Pflichtfeld f r 3xCB Cofinoga Kategorie Informationen zum K ufer E vads cust district Beschreibung Format Fehlercode Kategorie E vads cust email Beschreibung Format Fehlercode Kategorie PayZen 2 3 16 Datenlexikon 113 Bezirk des K ufers ans 127 113 Informationen zum K ufer E Mail Adresse des K ufers Erforderlich wenn die Zahlungsplattform eine E Mail an den K ufer senden soll Damit der K ufer eine E Mail erh lt m ssen Sie diesen Parameter bei der Erstellung einer Zahlungsauffo
9. Pay 4 amp 2 e amp m Payment Implementation Guide Zahlungsformular PayZen 2 3 Version 3 1 PayZen 2 3 Inhalt 2 Inhalt 1 VERSIONSVERLAUF DES DOKUMENTS 000022000uu0000nnunnnenunnnnnnunnennnnnnnnunnunnnnnnnnunnnrnnnnnnnnnn 4 2 KONTAKTIEREN DES TECHNISCHEN SUPPORTS 22220220000000000n200n0nnnnnnnnnnnnnnnnnnnnnnnnn nn 5 3 DIE VERSCHIEDENEN ZAHLUNGSARTEN uu2u 20022200200000n000nnn0nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 6 3 1 S010r 010 Barzani ea ee ee ee 6 3 2 Zeitverz gerte BarzahliINE une nenn en en anne anne enden 6 3293 Ile 0736 000 see E er ee rer 6 3 4 AULOTISIETNNSSANIT AT ee tennis heuer een J 4 BERBLICK BER DEN ABLAUF EINER ZAHLUNG uuusssnsnonnnanannonnnnnnnnnununununnnnnnnnnnnnnnunnnunnnnnnn 8 4 1 Festlegen der Schritte f r eine Zahlung aus K ufersicht 2222222222222sensseeeseeeeeeeneneenneeenenennennnn 8 4 2 Festlegen der Schritte f r eine Zahlung aus H ndlersicht 000s0ssennennnennnnnnn nennen 11 4 3 Lebenszyklus der Transaktionen u0000000000R0eennaehennensnnndennnnnnnn anna ennnnnnnennansnanneenaneene 12 5 EINRICHTEN DES DIALOGS MIT DER ZAHLUNGSPLATTFORM uususu02n2unannnnnennnnnnnannn 21 5 1 Festlegen der URL der Zahlungsseite 222222222222000000000nnnnnnnnnennnenennnnnenneennnennennnnneennnnnnnnsnnnnnsnnnnnn 21 3 locnulziernmne peim Dat manstanse sssrin a 21 5 3 Ausw hle
10. PayZen 2 3 15 H ufig gestellte Fragen FAQ 92 15 H UFIG GESTELLTE FRAGEN FAQ FAQ sind auf unserer Website unter https www de payzen eu haufige fragen fag verf gbar Sie finden darin h ufig gestellte Fragen zu den Fehlercodes die bei der bermittlung des Zahlungsformulars zur ckgegeben werden PayZen 2 3 16 Datenlexikon 93 16 DATENLEXIKON Das Datenlexikon enth lt eine vollst ndige Liste der Felder die im Zahlungsformular verwendet werden k nnen Es f hrt zun chst die wichtigsten Kategorien auf wie technische Informationen Auftragsinformationen usw Alle Felder die einer Kategorie angeh ren werden angezeigt Diese bersichten sind wie folgt dargestellt e Name des Feldes Name des Parameters wie er in einer HTTP Anfrage verwendet wird e Format Datenformat nach folgender Kodierung 2 Aiphabetische Zeichen von AbisZundvonabis OOOO Tabelle 28 Liste von Feldern und Formaten e Beschreibung Beschreibung des Feldes Das Datenlexikon gibt Details f r jedes der Felder an Jedes Feld wird wie folgt beschrieben e Beschreibung Beschreibung des Feldes Format Datenformat siehe obige bersicht Liste der Felder und Format e M gliche Werte erwartete Werte wenn spezifische Werte in das Feld eingegeben werden m ssen e Beispiel Beispiel f r die richtige Kodierung der Daten e Fehlercode Bei Fehlern an der Schnittstelle zwischen dem Shop und der Zahlungsplattform gibt
11. type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type submit name vads action mode value INTERACTIVE gt name vads amount value 11000 gt name vads capture delay value 0 gt name vads ctx mode value TEST gt name vads currency value 978 gt name vads ext info nbre articles value 2 gt name vads_product _amount0 value 5000 gt name vads product label0 value produitl gt name vads_product_qty0 value 2 gt name vads_ product _ref0 value refl gt name vads_product amount value 1000 gt name vads_product labell value produit2 gt name vads_product_qtyl value 1 gt name vads_product_refl value ref2 gt name vads_order id value CD100000857 gt name vads page action value PAYMENT gt name vads payment config value SINGLE gt name vads site id value 12345678 gt name vads trans date value 20140327145218 gt name vads trans id value 571381 gt name vads version value V2 gt name signature value 7896adcaaf7336839030469715afal2353313 42 gt name bezahlen value Bezahlen gt lt form gt PayZen 2 3 8 Verwenden von erg nze
12. 152 E vads_threeds_mpi Beschreibung Aktiviert deaktiviert den 3 D Secure Prozess w hrend einer E Commerce Zahlung Format n1 Fehlercode 50 ae Beschreibung aaa M gliche Werte EEE eere nicht 3 D Secure Authentifizierung von der Zahlungsplattform verwaltet Konfiguration vorhanden des H ndlers oder leer 3 D Secure Authentifizierung von der Zahlungsplattform verwaltet Konfiguration des H ndlers 3 D Secure Authentifizierung vollst ndig vom H ndler verwaltet wenn vads_card_number angegeben ist Eingabe der Kartendaten beim H ndler Die sich aus der vom MPI des H ndlers ergebenden Daten der 3 D Secure Authentifizierung m ssen dann in die entsprechenden Felder des Formulars bertragen werden vads_threeds_enrolled vads_threeds_cavv vads_threeds_eci vads_threeds_xid vads_threeds_ cavvAlgorithm vads_threeds_status 3 D Secure Authentifizierung f r die Transaktion deaktiviert unabh ngig von der blichen Konfiguration des H ndlers Kategorie 3 D Secure Authentifizierung u vads_threeds_sign_valid Beschreibung In der Antwort zur ckgegebenes Feld Gibt die G ltigkeit der Signatur der PARes Meldung an Das Feld wird von der Zahlungsplattform ausgef llt Format n1 M gliche Werte e EAEE Kein 3 D Secure 000 Ung ltige Signatur Korrekte Signatur Kategorie 3 D Secure Authentifizierung E vads_threeds_ status Beschreibung Gibt den Authentifizierungsstatus des Inhabers an Das Feld w
13. Chinesisch Spanisch Franz sisch Italienisch Japanisch Niederl ndisch Polnisch Portugiesisch Russisch Schwedisch T rkisch Wenn der Wert des Feldes vads_available_languages fehlerhaft ist wird das Formular zur ckgewiesen 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit einer Liste f r die Sprachenauswahl lt form method POST action https secure payzen eu vads payment gt lt input type hidden name vads action mode value INTERACTIVE gt lt input type hidden name vads amount value 3000 gt lt input type hidden name vads available languages value fr en gt lt input type hidden name vads capture delay value 0 gt lt input type hidden name vads ctx mode value TEST gt lt input type hidden name vads currency value 978 gt lt input type hidden name vads page action value PAYMENT gt lt input type hidden name vads payment config value SINGLE gt lt input type hidden name vads site id value 12345678 gt lt input type hidden name vads trans date value 20140526101407 gt lt input type hidden name vads trans id value 239848 gt lt input type hidden name vads version value V2 gt lt input type hidden name signature value 86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee gt lt
14. Erzeugen eines zahlungsformulars 43 7 3 Erstellen einer Ratenzahlung Diese Zahlungsart erm glicht es dem H ndler dem K ufer eine Zahlung in Raten anzubieten Das Zahlungsformular definiert die Anzahl von Raten und deren Intervall Die erste Rate wird auf dieselbe Art und Weise gezahlt wie eine sofortige Barzahlung Die folgende n Rate n wird werden wie eine zeitverz gerte Barzahlung en ausgef hrt Erinnerung Die Benachrichtigungsregeln m ssen je nach Rate aktiviert werden Ausf hrlichere Informationen entnehmen Sie bitte dem Kapitel Benachrichtigungsoptionen einstellen Hinweise Zum Tag der Zahlung wird dem H ndler nicht der gesamte Betrag gutgeschrieben und die Zahlungsgarantie gilt nicht f r k nftige Raten Das Datum der letzten Rate darf nicht sp ter als 1 Jahr nach dem Datum der bermittlung des Formulars liegen Andernfalls wird eine Fehlermeldung angezeigt und das Formular wird zur ckgewiesen 1 Verwenden Sie alle nachstehenden Felder um Ihr Zahlungsformular zu erstellen Name des Feldes Beschreibung vads_site_id Kennung des Shops Bsp 12345678 vads_ctx_mode Funktionsweise vads_trans_id Transaktionsnummer vads_trans_date Datum und Uhrzeit UTC des Zahlungsformulars vads amount Zahlungsbetrag in der kleinsten W hrungseinheit vads_currency Code der W hrung die f r die Zahlung verwendet wird vads action _mode Modus f r die Erfassung der Kartendaten vads_page_action Durchzuf hrende Aktion
15. Festlegen des Modus f r den Bank Kassenschnitt e Automatisch Keine Aktion erforderlich die Zahlungen werden an die Bank bermittelt wenn der Termin f r den Kassenschnitt erreicht ist e Manuell Der H ndler muss jede Zahlung vor dem gew nschten Datum des Kassenschnitts im Back Office best tigen damit sie an die Bank bermittelt wird Alle Transaktionen die nicht fristgerecht best tigt wurden gelten als verfallen und werden nicht an die Bank bermittelt Standardm ig ist das Back Office so konfiguriert dass der Bank Kassenschnitt f r alle Zahlungen automatisch erfolgt Der H ndler kann diese Einstellung in seinem Zahlungsformular ndern Er muss Kriterien seiner Wahl festlegen Lagerbestandsstatus Wiederbeschaffungsfrist usw die es erm glichen zu entscheiden ob der Bank Kassenschnitt f r die Transaktion automatisch erfolgen soll 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Verwenden Sie das Feld vads_validation_mode um den Modus f r den Bank Kassenschnitt Ihrer Transaktion festzulegen manuell oder automatisch Dieses Feld wird in der Antwort mit dem Wert zur ckgegeben der im Formular bermittelt wurde Beschreibung Nicht vorhanden oder leer bernimmt den im Back Office definierten Wert Automatischer Bank Kassenschnitt Tabelle 8 Mit dem Feld vads_validation_mode verbundene Wer
16. ck zum Shop geklickt hat URL an die der K ufer weitergeleitet wird wenn er auf L schen und zur ck zum Shop vads_url_cancel klickt bevor er die Zahlung get tigt hat vads_url_error URL an die der K ufer im Fall eines internen Verarbeitungsfehlers der Zahlungsplattform weitergeleitet wird 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit Festlegung der Back URL abh ngig vom Ergebnis der Zahlung lt form method POST action https secure payzen eu vads payment gt lt input lt input lt input Sein on ke type hidden type hidden type hidden type hidden name vads action mode value INTERACTIVE gt name vads amount value 3000 gt name vads capture delay value 0 gt name vads ctx mode value TEST gt lt input type hidden name vads currency value 978 gt lt input type hidden name vads page action value PAYMENT gt lt input type hidden name vads payment config value SINGLE gt lt input type hidden name vads site id value 12345678 gt lt input type hidden name vads trans date value 20140526101407 gt lt input type hidden name vads trans id value 239848 gt lt input type hidden name vads_url_cancel value http demo com cancel php gt lt input type hidden name vads_url
17. die mit dem Ergebnis der Zahlung verbundenen Parametern werden von der Zahlungsplattform im POST Modus bermittelt Voraussetzung e Die URL der Seite die das Ergebnis der Zahlung analysiert muss im Back Office eingegeben werden siehe Kapitel Benachrichtigungsoptionen einstellen e Der H ndler muss sicherstellen dass die Zahlungsplattform ohne Weiterleitung eine Verbindung zu der URL herstellen kann Weiterleitungen f hren zum Verlust der Daten im POST e Sollte von Seiten des Shops eine Beschr nkung eingerichtet sein muss die IP Adressseite 194 50 38 0 24 autorisiert werden Die Seite darf keine HTML Anzeige enthalten Der Zugriff auf Ressourcen wie Bilder oder Stylesheets kann den Datenaustausch zwischen der Zahlungsplattform und dem Shop verlangsamen Zudem liest die Plattform systematisch die ersten 512 vom Shop zur ckgegebenen Zeichen Diese Zeichen werden anschlie end im Transaktionsverlauf angezeigt e Vermeiden Sie in diesem Skript nach M glichkeit zeitaufwendige Aufgaben wie die Erstellung von Rechnungen oder Versendung von E Mails Die Bearbeitungszeit hat direkte Auswirkungen auf die Anzeigegeschwindigkeit der bersichtsseite zur Zahlung Je l nger die Bearbeitung der Benachrichtigung dauert umso sp ter erfolgt die Anzeige Nach Ablauf von 35 Sek sieht die Plattform den Sendevorgang als gescheitert an Timeout Fehlgeschlagene Benachrichtigung IPN Bei einem Fehlschlag der IPN wird eine E Mail
18. r die Zahlung verwendet wurde e Bei einer fraktionierten Zahlung d h bei einer Zahlung f r die mehrere Zahlungsmittel verwendet werden sind folgende Felder auszuf llen vads_card_brand MULTI F r die Zahlung werden mehrere Arten von Karten verwendet vads_payment_seq Im json Format siehe folgende Details der ausgef hrten Transaktionen Angaben Das Feld vads_payment_seq json Format beschreibt die Abfolge der fraktionierten Zahlung Sie enth lt folgende Elemente 1 trans_id Kennung der Transaktion die der Zahlungsabfolge zugrunde liegt 2 transaction bersicht der Transaktionen der Abfolge Sie besteht aus folgenden Elementen Name des Parameters Beschreibung Betrag der Abfolge der Zahlung operation_type Belastungsvorgang auth_number Autorisierungsnummer die vom Bankserver zur ckgegeben wurde falls verf gbar ansonsten leer Dieser Parameter wird bei einer Zahlung mit e Urlaubsgutscheinen leer zur ckgegeben Der Server der Titel von ANCV gibt sie nicht an capture_delay Frist bis Kassenschnitt in Tagen e Beieiner Zahlung mit e Urlaubsgutscheinen wird f r diesen Parameter 0 eingestellt e Urlaubsgutscheine werden in Echtzeit gepr ft Bei einer Zahlung mit Bankkarte ber cksichtigt der Parameter die Frist bis zum Kassenschnitt in Anzahl von Tagen Wird dieser Parameter im Zahlungsformular nicht bertragen wird der im Back Office festgelegte Standardwert verwendet card_brand Verwendetes Zahlung
19. 36 6 7 Aktivieren des automatischen Neuversuchs Mit dieser Option wird die Benachrichtigung im Falle eines Scheiterns automatisch bis zu vier Mal an den Shop gesendet 1 Wechseln Sie zu https de payzen eu vads merchant 2 Gehen Sie zum Men Optionen gt Benachrichtigungsregeln 3 Klicken Sie mit der rechten Maustaste auf eine der angezeigten Benachrichtigungsregeln 4 W hlen Sie Regelverwaltung E 4 Test DE Regelverwaltung CHECKURL IPN am Ende der Zahlung x FE Einstellungen Regelbedingungen Q Informationen Allgemeine Einstellungen Name der Regel IPN am Ende der Zahlung IPN Einstellungen Die URL m ssen von unserem Server aus erreichbar sein Die URL zur Weiterleitung sind verboten m Aufzurufende URL im Testumfeld Aufzurufende URL im Produktionsumfeld E Mailadresse zur Fehlermeldung alom e mao mon Automatischer Neuversuch im Falle eines F Scheiterns ba Schlie en Abbildung 19 URL der Benachrichtigung bei Abschluss der Zahlung 5 F llen Sie das Feld E Mail Adresse n zur Benachrichtigung im Falle eines Scheiterns aus 6 Um mehrere E Mail Adressen anzugeben trennen Sie sie durch ein Semikolon 7 Konfigurieren Sie den Automatischen Neuversuch im Falle eines Scheiterns Die Sendeversuche erfolgen zu festen Zeiten alle 15 Minuten 00 15 30 45 Nach jedem fehlgeschlagenen Versuch wird eine E Mail mit einer Fehlermeldung an die zuvor angegebene
20. Adresse gesendet Die E Mail die in einem solchen Fall gesendet wird enth lt im Betreff die Nummer die mit dem Versuch zum Senden der Benachrichtigung verbunden ist Sie wird wie folgt dargestellt attempt gefolgt von der Nummer des Versuchs Beispiel f r einen E Mail Betreff der nach dem ersten gescheiterten Benachrichtigungsversuch am Ende einer Zahlung versendet wurde RES EMOBDUS En Mean Shop AN ARS 2 ie 192557 EAS CHAC beamer endens har UVRNEZUrR Best erg ung fehlgeschlagener attempt 1 Im Falle mehrfacher Ablehnungen wird im Betreff die Anzahl der gescheiterten Versuche angezeigt Beispiel f r einen E Mail Betreff beim Scheitern des zweiten Versuchs FERSEMODUS Meine Shop ir Rer 06792577 RO CHMA beim Senden ihrer URE zuU2 Beste eigung fehlgeschlagener attempt 2 Beispiel f r einen E Mail Betreff beim Scheitern des dritten Versuchs FEESEMODUS Mein shop ir Ber 0679257 EiiikSCHEAg beim senden Ihrer URE zu2 Best stigung fehlgeschlagener attempt 3 Um den Shop ber das Scheitern des letzten Benachrichtigungsversuchs zu informieren wird im Betreff der Vermerk attempt last angezeigt PayZen 2 3 6 Benachrichtigungseinstellungen 37 Beispiel f r einen E Mail Betreff beim Scheitern des letzten Versuchs DERSEMODUS 7 Mean Shop ir Ber 067 9257 7 EnunSCHrAGCbeaim Senden Ihren URN zu Bese g eung fehlgeschlagener attempt last Der Inhalt jeder der E Mails enth lt folgende Angaben e Das aufgetrete
21. Autorisierungsservern hin Bsp geschlossener Vertrag falscher MCC Code angegeben usw Kontaktieren Sie den Kundenservice um den Fehler beheben zu lassen Nicht honorieren Dieser Code wird von der Bank ausgegeben die die Karte ausgestellt hat Er tritt in der Regel in folgenden F llen Ung ltiges Verfalldatum ung ltige CVV Verf gungsrahmen berschritten kein ausreichendes Guthaben usw Um den genauen Grund der Zur ckweisung zu erfahren muss der K ufer sich an seine Bank wenden Ungen gende Deckung oder Verf gungsrahmen berschritten Dieser Code wird von der Bank ausgegeben die die Karte ausgestellt hat Er kann auftreten wenn der K ufer nicht ber ein ausreichendes Guthaben f r seinen Kauf verf gt Um den genauen Grund der Zur ckweisung zu erfahren muss der K ufer sich an seine Bank wenden Karte nicht erfasst Dieser Code wird von der Bank ausgegeben die die Karte ausgestellt hat Die eingegebene Kartennummer ist fehlerhaft oder die Kartennummer Verfalldatum Kombination ist nicht vorhanden Transaktion f r diesen Inhaber nicht zul ssig Dieser Code wird von der Bank ausgegeben die die Karte ausgestellt hat Er tritt in der Regel in folgenden F llen auf e Der K ufer versucht eine Zahlung im Internet mit einer Debitkarte vorzunehmen e Der Verf gungsrahmen der Karte ist berschritten Um den genauen Grund der Zur ckweisung zu erfahren muss der K ufer sich an seine Bank wenden Betrugsve
22. Back Office Best tigung durch den H ndler WAITING_AUTHORIZATION IPN nach Aktion im Back Office Antwort auf die REFUSED WAITING AUTHORIZATION e Autorisierungsanfrage von 1 Euro WAITING_AUTHORIZATION_TO_VALIDATE amp Antwort auf die AUTHORIZED REFUSED Autorisierungsanfrage AUTHORIZED_TO_VALIDATE EN DEEAULOBSIE TUN QAFEN HALEN Tabelle 2 Benachrichtigungsregeln die bei einer zeitverz gerten Barzahlung zu aktivieren sind PayZen 2 3 6 Benachrichtigungseinstellungen 30 6 3 Benachrichtigungen ber die verschiedenen Statuswerte f r die Raten von Ratenzahlungen WAITING_ ilar nm ss AUTHORIZATION Stornierung CANCELED T x vor dem angefragten Datum des Bank Kassenschnitts Autorisierungsanfrage Zahlung verweigert Zahlung angenommen AUTHORIZED unnnnunnnnnnn Stornieru ng uunn CANCELED Bank Kassenschnitt mit der Zahlung R ckerstattung AUTHORIZED Neue Transaktion Abbildung 14 Flussdiagramm F lligkeiten von Ratenzahlungen A G ltigkeitsdauer der Autorisierung a e e a n T E a re 5 Pe A aea aa Iran e a Hrn Rear E aA AA A A Ereignis bermitteiter Status u kKonfigurierenco LrEISNIS Name der zu len Regel Stornierung durch den H ndler CANCELED IPN nach Aktion im Back Office Antwort auf die Autorisierungsanfrage AUTHORIZED REFUSED IPN bei Autorisierung durch batch Tabelle 3 Benachrichtigungsregeln die bei einer Ratenzahlung zu aktivieren sind
23. Best tigen klickt 8 Wenn der H ndler und die Karte des K ufers f r das 3 D Secure Programm registriert sind findet eine 3 D Secure Authentifizierung statt 9 Eine Autorisierungsanfrage bei der Bank des K ufers und beim Aussteller sowie die internen Betrugskontrollen der Zahlungsplattform werden durchgef hrt PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 10 10 Im Erfolgsfall wird dem K ufer eine bersichtsseite mit den Informationen der Transaktion angezeigt Eine Schaltfl che wird angezeigt mit der der K ufer zum Shop zur ckkehren kann PayZen Sichere Zahlung VISA Ihr Zahlungsauftrag wurde erfasst Zahlungs bersicht SHOP shop URL Adresse httpellwww shop com Kennnummer des H ndlers 91335531 Transaktionsnummer 523584 Bestellnummer bht 1107 VISA 1 0 EUR Datum Uhrzeit 28 10 2014 09 33 29 GMT 1 Kartennummer 497010XXXXXX0000 06 15 3 D Secure Zertifikat Q2F2dkNhdnZDYXZ2Q2F2dkNhdnY Genehmigungsnummer 3fe45f Zertifikat ecf78dced8572ad377b2a17a9dbe22d5a439f591 K Kassenzeftel Zuruck zum Shop Pay a a a M M DSS Copyright PayZen 2014 Alle Rechte vorbehalten Paiement sur internet Abbildung 4 Transaktions bersicht Im Fall eines Fehlschlags wird eine Meldung angezeigt Der K ufer wird dar ber informiert dass sein Zahlungsauftrag verweigert wurde Eine Schaltfl che wird angezeigt mit der der K ufer die Transaktion stornieren und zum Shop
24. Betr ge von K ufen ber eine Kartennummer oder des H chstbetrages einer Bestellung BIN_FRAUD Pr fung auf Vorhandensein des BIN Codes der Karte in der BIN Code Blacklist ECB Pr fung ob es sich bei der Karte des K ufers um eine e Carte Bleue handelt CARD_COMMERCIAL Pr fung ob es sich bei der Karte des K ufers um eine Gesch ftskarte handelt SYSTEMATIC_AUTO Pr fung ob es sich bei der Karte des K ufers um eine Karte mit systematischer Autorisierung handelt INCONSISTENT_COUNTRIES Pr fung ob das Land der IP Adresse das Ausgabeland der Zahlungskarte und das Land der Adresse des K ufers bereinstimmen NON_WARRANTY_PAYMENT Pr fung des Haftungs bergangs der Transaktion SUSPECT_IP_COUNTRY Pr fung auf Vorhandensein des Landes des K ufers das durch seine IP Adresse identifiziert wird in der Liste der gesperrten L nder Tabelle 24 Liste der betrugsbezogenen Pr fungen Die m glichen Werte f r result sind OK PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 85 Informative Pr fung fehlgeschlagen ERROR Blockierende Pr fung fehlgeschlagen Tabelle 25 Liste der betrugsbezogenen Pr fungen 11 Bestimmen Sie den f r die Zahlung verwendeten Kartentyp Zwei F lle k nnen angezeigt werden e Bei einer Zahlung die mit einer einzigen Karte erfolgte Folgende Felder sind auszuf llen Verfallmonat von 1 bis 12 z B 3 f r M rz 10 f r Oktober Tabelle 26 Analyse der Karte die f
25. Formular bermittelt wurden e Anf hrungszeichen im Formular gesendet e Die bermittelte Signatur entspricht nicht den Berechnungsregeln f r Signaturen Kategorie Technische Informationen E vads action_mode Beschreibung Pflichtparameter Modus f r die Erfassung der Karteninformationen Format string enum Fehlercode 47 M gliche Werte INTERACTIVE Eingabe der Karteninformationen auf der Zahlungsseite SILENT Eingabe der Karteninformationen im Shop abh ngig von der von Ihrer Bank bereitgestellten kommerziellen Option Kategorie Technische Informationen E vads amount Beschreibung Format Fehlercode Kategorie E vads auth mode Beschreibung Format M gliche Werte Kategorie PayZen 2 3 16 Datenlexikon 102 Transaktionsbetrag ausgedr ckt in der kleinsten W hrungseinheit Cent beim Euro Beispiel Bei einer Transaktion von 10 Euro und 28 Cents Rappen ist der Wert des Parameters 1028 Das Zahlungsformular wird in den folgenden F llen zur ckgewiesen e Betrag gleich Null vads_amount 0 e Negativer Betrag vads_amount 100 e Betrag mit Dezimalstellen oder Punkten vads_amount 100 50 e Formular ohne das Feld vads_ amount fehlender Betrag Eine technische Fehlermeldung wird mit einem R ckgabecode 09 vads_extra_result zur ckgegeben n 12 09 Informationen zur Transaktion In der Antwort zur ckgegebenes Feld Legt fest auf welche Weise die Autorisierungsanfr
26. Geben Sie in das Feld vads_currency den Code der gew nschten W hrung gem der W hrungstabelle ein Beispiel 978 f r Euro 840 f r US Dollar F gen Sie optionale Felder gem Ihren Anforderungen hinzu siehe Kapitel Verwenden von erg nzenden Funktionen Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Formulars f r Barzahlung lt form method POST action https secure payzen eu vads payment gt lt input type hidden name vads action mode value INTERACTIVE gt lt input type hidden name vads amount value 3000 gt lt input type hidden name vads capture delay value 0 gt lt input type hidden name vads ctx mode value TEST gt lt input type hidden name vads currency value 978 gt lt input type hidden name vads page action value PAYMENT gt lt input type hidden name vads payment config value SINGLE gt lt input type hidden name vads site id value 12345678 gt lt input type hidden name vads trans date value 20140526101407 gt lt input type hidden name vads trans id value 239848 gt lt input type hidden name vads version value V2 gt lt input type hidden name signature value 86b2al7b9a5fcefb6c0120c57b25ec86ad1704ee gt lt input type submit name bezahlen value bezahlen gt lt LOLS Pay
27. Plattform erzeugten Wert e Oder die Verwaltung dieser Kennungen erfolgt durch den H ndler In diesem Fall ist der Parameter mit dem gew nschten Wert der Kennung f r die Ratenzahlung anzugeben Achtung Die Eindeutigkeit der Kennungen ist vom Shop sicherzustellen Alle Anforderungen f r die Erfassung einer Ratenzahlung die eine bereits vorhandene Ratenzahlungskennung enthalten werden zur ckgewiesen und f hren zur Anzeige einer Fehlermeldung ans 50 63 Informationen zur Ratenzahlung PayZen 2 3 16 Datenlexikon 146 E vads sub_amount Beschreibung Pflichtparameter der bei der Erstellung einer Ratenzahlung verwendet wird Er verweist auf den Betrag der Raten der Ratenzahlung f r alle Raten au er den eventuell in vads_sub_init_amount_number definierten Der Wert muss in der kleinsten W hrungseinheit angegeben werden Cent beim Euro Beispiel Bei einem Betrag von 10 Euro und 28 Cent ist der Wert des Parameters 1028 Format n 12 Fehlercode 65 Kategorie Informationen zur Ratenzahlung E vads sub_currency Beschreibung Pflichtparameter der bei der Erstellung einer Ratenzahlung verwendet wird Er gibt die f r die Ratenzahlung zu verwendende W hrung gem Norm ISO 4217 an Format n3 M gliche Werte Folgende W hrungen sind m glich D nische Krone 208 901 Isl ndische Krone 352 949 Norwegische Krone 578 414 Schwedische Krone 752 788 Tschechische Krone 203 032 Australischer Dollar 036 484 Kanadi
28. Shop 8 Der Shop empf ngt die Daten und berechnet die Signatur Sie vergleicht die berechnete Signatur mit der von der Plattform bermittelten Signatur 9 Wenn die Signaturen nicht bereinstimmen analysiert der Shop die Ursache des Fehlers Berechnungsfehler Betrugsversuch usw Andernfalls aktualisiert der Shop seine Datenbank Status des Lagerbestands Status der Bestellung USW Aufbewahrung des Produktionszertifikats Nach der ersten mit einer realen Karte durchgef hrten Zahlung wird das Produktionszertifikat aus Sicherheitsgr nden maskiert Es wird dringend empfohlen dieses Zertifikat an einem sicheren Ort aufzubewahren verschl sselte Datei Datenbank usw Im Fall eines Verlusts kann der H ndler ber sein Back Officeein neues Zertifikat erstellen Zur Erinnerung Das Produktionszertifikat kann im Back Office ber das Men Einstellung gt Shop gt Registerkarte Zertifikate angezeigt werden Verwalten von sensiblen Daten Online Zahlungstransaktionen unterliegen strengen Regeln PCI DSS Zertifizierung Als H ndler m ssen Sie darauf achten niemals Daten komplett zu bertragen die sich auf eine Kartennummer beziehen k nnten Ihr Formular wird andernfalls zur ckgewiesen Code 999 Sensitive data detected Vermeiden Sie insbesondere Bestellnummern mit einer L nge zwischen 13 und 16 Stellen und die mit 3 4 oder 5 beginnen Nutzen von i Frames Ein i Frame Inline Frame wird verwendet um eine W
29. Zahlungsseite uueseesseesnnsennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnneenenennennnenn 60 8 10 ndern der URL zur sofortigen Zahlungsbest tigung IPN uueeeseenenenennennenennennennnnennennnnennnnn 66 8 11 Erstellen einer Zahlung ohne Weiterleitung zur Zahlungsseite uu222222222220200nnnennnseneeneeneeeneeneenen 67 9 BERECHNEN DER SIGNATUR uc insuuan anna anna aaa heran ana na enTu 70 9 1 Beispiel einer JAV A Implementierung usuusseessesennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnenn 12 9 2 Beispiel einer PHP Implementierune 000er 73 PayZen 2 3 Inhalt 3 10 VERSENDEN DES ZAHLUNGSAUFTRAGS uuu0220020000nn000nnnunnnnnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 74 10 1 Weiterleiten des K ufers zur Zahlungsseite ussssssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnenennnnnenn 74 10 2 Verwaltung yon Fehlen nennen seen een 74 11 ANALYSIEREN DES ERGEBNISSES DER ZAHLUNG u2 2220220022000000000nnnnnnnnnnnnnnnnnnnnnn nun 75 11 1 Abrufen der in der Antwort zur ckgegebenen Daten 222222220000000000000nnnnnnnnnnnnnnnnnnnnnnennnneennnnnnnn 11 1152 Berechnen der Siena unse ek TI 1 123 Vergleichen der Senati een ee TI 11 4 Analyse der Art der Benachrichtigung eseeeeeeereereessreessseesssssssssssssssssssssssssssssssseesseetreererreerrerreee 79 11 5 Angeben des Vorsanssyp a n
30. a0 FRAUD_SCORE_TOO_HIGH Verweigert Der Betrugswert bersteigt die Toleranzschwelle 480 SUCCESS_TO_REVIEW Die Bestellung wurde markiert um vom Decision Manager gepr ft zu werden SUCCESS_TO_REJECT Die Bestellung wurde vom Decision Manager zur ckgewiesen Tabelle 42 Mit vads_risk_analysis_result Cybersource verbundene Werte Kategorie Informationen zur Transaktion u vads_risk_control Beschreibung Format M gliche Werte Kategorie PayZen 2 3 16 Datenlexikon 139 In der Antwort zur ckgegebenes Feld Erm glicht das Ergebnis der Risikokontrolle zu definieren Pr fungi1 Ergebnis1 Pr fung2 Ergebnis2 Beschreibung CARD_FRAUD Pr fung auf Vorhandensein der Kartennummer in der Karten Blacklist SUSPECT_COUNTRY Pr fung auf Vorhandensein des Ausgabelandes der Karte des K ufers in der Liste der gesperrten L nder IP_FRAUD Pr fung auf Vorhandensein der IP Adresse des K ufers in der IP Blacklist CREDIT_LIMIT Pr fung der H ufigkeit und Betr ge von K ufen ber eine Kartennummer oder des H chstbetrages einer Bestellung BIN_FRAUD Pr fung auf Vorhandensein des BIN Codes der Karte des K ufers in der BIN Code Blacklist ECB Pr fung ob es sich bei der Karte des K ufers um eine e Carte Bleue handelt CARD_COMMERCIAL Pr fung ob es sich bei der Karte des K ufers um eine Gesch ftskarte handelt SYSTEMATIC_AUTO Pr fung ob es sich bei der Karte des K ufers um eine Karte mit systematis
31. die Attribute name und value siehe Kapitel Datenlexikon Alle Daten des Formulars m ssen im Format UTF 8 codiert werden Sonderzeichen Akzente Satzzeichen usw werden daraufhin von der Zahlungsplattform richtig interpretiert Andernfalls wird die Signatur fehlerhaft berechnet und das Formular wird zur ckgewiesen Die Schaltfl che Bezahlen die das Senden der Daten erm glicht lt input type submit name bezahlen value Bezahlen gt Anwendungsf lle werden in den folgenden Kapiteln vorgestellt Sie erm glichen es Ihnen Ihr Zahlungsformular gem Ihren Anforderungen zu erstellen e Erstellen einer sofortigen Barzahlung Erstellen einer zeitverz gerten Barzahlung e Erstellen einer Ratenzahlung e Erstellen einer Autorisierung ohne Buchung PayZen 2 3 7 Erzeugen eines zahlungsformulars 40 7 1 Erstellen einer sofortigen Barzahlung Im Modus f r die sofortige Barzahlung bezahlt der K ufer den gesamten Kauf auf einmal Der Bank Kassenschnitt f r die Zahlung erfolgt am selben Tag 1 Verwenden Sie alle Felder in der folgenden Tabelle um Ihr Zahlungsformular zu erstellen NamedesFeldes Beschreibung wm Tabelle 4 Liste der Felder sofortige Barzahlung 2 Setzen Sie das Feld vads_payment_config auf SINGLE Setzen Sie das Feld vads_capture_delay auf 0 Setzen Sie das Feld vads_validation_mode f r eine automatische Best tigung der Bank Kassenschnitt f r die Zahlung erfolgt automatisch auf 0
32. enthaltenen Produkte anzugeben Format n 12 Kategorie Informationen zur Bestellung E vads operation type Beschreibung In der Antwort zur ckgegebenes Feld Erm glicht einen Belastungs und Gutschriftvorgang Erstattung zu unterscheiden Format string enum M gliche Werte DEBIT CREDIT Kategorie Informationen zur Transaktion E vads_order_id Beschreibung Bestellnummer Sie ist auch in der E Mail mit der Zahlungsbest tigung enthalten die an den K ufer gesendet wird Feld im alphanumerischen Format Nur das Sonderzeichen ist zul ssig Wenn dieses Feld ein anderes Sonderzeichen amp usw enth lt gibt die Zahlungsplattform einen Fehler zur ck Format an 32 Fehlercode 13 Kategorie Informationen zur Bestellung E vads_order_info Beschreibung Format Fehlercode Kategorie u vads_oder info2 Beschreibung Format Fehlercode Kategorie E vads_order_info3 Beschreibung Format Fehlercode Kategorie E vads page action Beschreibung Format Fehlercode M gliche Werte Kategorie Beschreibung der Bestellung an 255 14 Informationen zur Bestellung Beschreibung der Bestellung an 255 14 Informationen zur Bestellung Beschreibung der Bestellung an 255 14 Informationen zur Bestellung Pflichtparameter Definiert die durchzuf hrende Aktion string enum 46 e PAYMENT REGISTER e REGISTER _UPDATE e REGISTER_PAY e REGISTER_SUBSCRIBE e
33. gt lt input type hidden name vads currency value 978 gt lt input type hidden name vads page action value PAYMENT gt lt input type hidden name vads payment config value SINGLE gt lt input type hidden name vads_ship _to_city value COLOGNE gt lt input type hidden name vads_ship to_country value DE gt lt input lt input lt input type hidden type hidden type hidden name vads_ship_to_name value LYRA gt name vads_ship_to_street value main street gt name vads_ship_to_street_number value 10 gt lt input type hidden name vads_ship_to_ zip value 50668 gt lt input type hidden name vads site id value 12345678 gt lt input type hidden name vads trans date value 20140327143509 gt lt input type hidden name vads trans id value 561095 gt lt input type hidden name vads version value V2 gt lt input type hidden name signature value 52a8c87ec10b35e6fd1769e7189c26a6e279566e gt lt input type submit name bezahlen value Bezahlen gt lt form gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 51 8 4 bermittlung der Bestellungsdaten Der H ndler kann in seinem Zahlungsformular angeben ob er die Bestellungsdaten Bestellnummer Beschreibung Inhalt des Einkaufskorbs usw bermitteln m chte Diese Daten werden im Back Office angezeigt indem die Einzelheiten der Transaktion abgerufen werden R
34. ihrer Signatur die Seite f r die Auswahl des Zahlungsmittels an PayZen Sichere Zahlung A http www shop com W hlen Sie Ihr Zahlungsmittel aus Kennnummer des H ndlers 91335531 Transaktionsnummer 523584 Masa VI S A Bestellnummer bht 1107 Betrag 1 00 EUR MasterCard Visa American Express a Loschen und zur ck zum Shop PaylZ ss z2 zun om yess C ight PayZen 2014 alle Rechte vorbehalten Paiement sur internet eie Abbildung 2 Auswahl des Zahlungsmittels Wenn das Zahlungsmittel im Formular festgelegt wurde wechselt der K ufer direkt zu Schritt 6 4 Der K ufer w hlt sein Zahlungsmittel aus 5 Er klickt auf Best tigen 6 Er gibt die Nummer und das Verfalldatum seiner Karte an Wenn die Karte mit einer Kartenpr fnummer versehen ist muss diese angegeben werden PayZen Sichere Zahlung VISA SEn Gesicherte Zahlung Kennnummer des H ndlers 91335531 nn E T z Der URL Pr fix https dieser Zahlungsseiten bedeutet dass die Zahlungsseiten ransaktionsnummer 523584 h s z m sicher sind und Sie Ihre Bankdaten ausf llen k nnen Bestellnummer bht 1107 Betrag 1 00 EUR Kartennummer G ltig bis Monat 2 Jahr Kartenpr fnummer CVV 7 Loschen und zur ck zum Shop Pay 5 zum Som iess Copyright PayZen 2014 alle Rechte vorbehalten Paiement sur internet Abbildung 3 Eingabe der Informationen zum Zahlungsmittel 7 Er best tigt seine Eingabe indem er auf
35. im Back Office angezeigt UPDATED Der Alias oder die UMR wurde erfolgreich aktualisiert ABANDONED Aktion vom K ufer Debitor abgebrochen Der Alias oder die UMR wurde nicht erstellt und wird nicht im Back Office angezeigt Kategorie Informationen zur Ratenzahlung E vads insurance_amount Beschreibung Betrag der Versicherung f r die gesamte Bestellung Spezifisch f r das Zahlungsmittel PayPal Format n 12 Fehlercode 42 Kategorie Informationen zur Bestellung E vads language Beschreibung Im Zahlungsauftrag Legt die Sprache fest in der die Zahlungsseite angezeigt wird Norm ISO 639 1 Wenn das Feld im Zahlungsauftrag nicht gesendet oder leer gelassen wird wird die Zahlungsseite in der Sprache des Browsers des K ufers angezeigt In der Antwort Gibt den im Formular festgelegten Wert zur ck wenn der K ufer die Sprache auf der Zahlungsseite nicht ge ndert hat Gibt die vom K ufer gew hlte Sprache zur ck wenn dieser die Sprache auf der Zahlungsseite durch Auswahl einer anderen Flagge ge ndert hat Format a2 Fehlercode 12 PayZen 2 3 16 Datenlexikon 123 M gliche Werte Sprache ISO 639 1 Codierung Deutsch Englisch Chinesisch Spanisch Franz sisch Italienisch Niederl ndisch Polnisch Portugiesisch Russisch Schwedisch T rkisch wo oo wooo Kategorie Personalisierung der Zahlungsseite E vads nb products Beschreibung Erm glicht die Anzahl der im Einkaufskorb
36. im Parameter first angegeben werden Wenn ein Rest ungleich Null bleibt wird er auf den Betrag der letzten Rate aufgeschlagen Zahlungsanforderung e vads_capture_delay 2 e vads_currency 978 e vads amount 20000 e vads_payment_config MULTI first 10000 count 4 period 30 Ergebnis Eine erste Zahlung von 100 Euro wird am T 2 in der Bank eingezahlt vads_capture_delay Eine zweite Zahlung von 33 33 Euro wird am T 32 ausgef hrt vads_capture_delay period PayZen 2 3 16 Datenlexikon 128 Eine dritte Zahlung von 33 33 Euro wird am T 62 ausgef hrt Eine vierte und letzte Zahlung von 33 34 Euro wird am T 92 ausgef hrt Der Gesamtbetrag ergibt 200 Euro vads amount 20000 Der Rest wurde dem Betrag der letzten Rate hinzugef gt Diese Anweisung erm glicht es sofort 4 Zahlungen mit derselben Transaktionsnummer jedoch einer unterschiedlichen Ratennummer zu erstellen vads_sequence_number Beispiel 2 Mit MULTI_EXT kann ein personalisierter Ratenzahlungsplan definiert werden Sie k nnen somit das Datum und den Betrag jeder Rate definieren Zahlungsanforderung MULTI EXT e vads_currency 978 e vads amount 10000 e vads payment_config MULTI_EXT 20150601 5000 20150701 2500 20150808 2500 Ergebnis Die erste Zahlung ber 50 Euro findet am 1 Juni 2015 statt Die zweite Zahlung ber 25 Euro findet am 1 Juli 2015 statt Eine letzte Zahlung ber 25 Euro findet am 8 August 2015 statt Hinweis Die Ge
37. input type submit name bezahlen value Bezahlen gt lt form gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 64 ndern des Namens und der URL des Shops Wenn Sie ber zwei Dom nennamen verf gen k nnen Sie den Namen und die URL des Shops ndern damit darin der Dom nenname enthalten ist 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen Shops zu ndern Verwenden Sie das Feld vads_shop_name um den auf der Zahlungsseite angezeigten Namen des Dieser Wert wird f r das Transaktionsticket sowie in die Best tigungs E Mail bernommen ndern Verwenden Sie das Feld vads_shop_url um die auf den Zahlungsseiten angezeigte URL des Shops zu Dieser Wert wird in die Best tigungs E Mail bernommen Wenn der Wert des Feldes vads_shop_url fehlerhaft ist wird das Formular nicht zur ckgewiesen Sein Wert wird jedoch f r 3 D Secure verwendet Die Zahlung wird m glicherweise verweigert wenn die URL ung ltig ist Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit nderung des Namens und der URL des Shops lt form method POST action https secure payzen eu vads payment gt lt LNPUT lt INPUT lt input lt input more lt input lt LNPUT lt i
38. llt n1 Aktiviert deaktiviert den 3 D Secure Prozess w hrend einer E Commerce Zahlung Gibt die G ltigkeit der Signatur der PARes Meldung an Das Feld wird von der Zahlungsplattform ausgef llt vads_threeds_mpi vads_threeds_sign_valid vads_threeds_status Gibt den Authentifizierungsstatus des Inhabers an Das Feld wird durch den 3 D Secure Authentifizierungsserver ACS w hrend des 3 D Secure Prozesses ausgef llt vads_threeds_xid ans 28 Gibt die eindeutige Referenz der 3 D Secure Transaktion an Das Feld wird durch den Authentifizierungsserver ACS w hrend des 3 D Secure Prozesses ausgef llt Tabelle 35 Parameterliste 3 D Secure Authentifizierung E Informationen zu Spendenzahlungen Name des Feldes Format Beschreibung Spendenbetrag in der kleinsten W hrungseinheit Cent beim Euro vads_ext_info_donation_contribution Betrag in Cent des Beitrags in der kleinsten W hrungseinheit Cent beim Euro vads_ext_info_donation_merchant Kennung des Shops in dem die Spende erfolgt vads_ext_info_donation_recipient HelloAsso Kennung der Organisation die die Spende erhalten hat vads_ext_info_donation_recipient_name Name der Organisation die die Spende erhalten hat vads_risk_primery_warranty string Erm glicht die Konfiguration der Risikokontrolle Pr fung des enum Haftungs bergangs bei der Prim rtransaktion zu ndern Tabelle 36 Parameterliste Informationen zu Spendenzahlungen PayZen 2 3 16 Datenle
39. nach einer erfolgreichen Zahlung fest vads_redirect_success_timeout vads_redirect_error_timeout Legt die Wartezeit vor der Umleitung nach einer verweigerten Zahlung fest Diese Zeitspanne wird in Sekunden angegeben und muss zwischen O und 300 Sekunden liegen vads_redirect_error_message Legt die Wartemeldung vor der Umleitung nach einer verweigerten Zahlung fest Tabelle 13 Liste der verf gbaren optionalen Felder 3 Setzen Sie das Feld vads_return_mode auf GET 4 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars lt form method POST action https secure payzen eu vads payment gt lt input lt input lt input lt INPUT lt INPUT lt input lt inpne lt input type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden zur ckgef hrt gt lt input lt input type hidden type hidden zur ckgef hrt gt lt input lt input mplt lt input lt input lt input lt input lt LNPUT lt input oc type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type submit name vads action mode value INTERACTIVE gt name vads amount value 3000 gt name vads capture delay value 0 gt name vads ctx mode value TEST
40. nicht im Back Office angezeigt AUTHORISED Wartet auf Kassenschnitt Die Transaktion ist angenommen und zum vorgesehenen Datum erfolgt automatisch der Kassenschnitt bei der Bank AUTHORISED_TO_VALIDATE Zu best tigen Die durch manuelle Best tigung erstellte Transaktion ist autorisiert Der H ndler muss den Bank Kassenschnitt manuell best tigen Die Transaktion kann best tigt werden solange das Datum des Kassenschnitts nicht berschritten ist Wenn dieses Datum berschritten wird erh lt die Zahlung den Status Verfallen Der Status Verfallen ist endg ltig CANCELED Storniert ER Joenktanuurdeduehdent ndersmin CAPTURED Mit Kassenschnitt ED bern tar ie Transaktion stero Verfallen Das Datum des Kassenschnitts ist erreicht und der H ndler hat das Datum E des Bank Kassenschnitts der Transaktion nicht best tigt Verweigert m OOO OO EP WAITING_AUTHORISATION Wartet auf Autorisierung Das angefragte Datum des Kassenschnitts liegt nach dem Ablaufdatum der G ltigkeit einer Autorisierungsanfrage Eine Autorisierungsanfrage f r einen euro Auskunftsanfrage wird durchgef hrt und von der ausgebenden Bank akzeptiert Die Autorisierungsanfrage wird automatisch zu T 1 vor dem Datum des Bank Kassenschnitts ausgel st Die Zahlung kann angenommen oder verweigert werden Der Bank Kassenschnitt erfolgt automatisch WAITING_AUTHORISATION_TO Zu best tigen und zu autorisieren _VALIDATE Das angefragte Datum des Kassenschnitts liegt
41. rend De Konlameur Conten u hy Applying SHA 1 algorythm Done e ea ona re on en recurcn sigmat re g PayZen 2 3 10 Versenden des Zahlungsauftrags 74 10 VERSENDEN DES ZAHLUNGSAUFTRAGS F r jede Transaktion muss der K ufer zur Zahlungsseite weitergeleitet werden um seinen Kauf abzuschlie en Sein Browser muss die Daten des Zahlungsformulars bermitteln 10 1 Weiterleiten des K ufers zur Zahlungsseite Die URL der Zahlungsplattform lautet wie folgt httos secure payzen eu vads payment Beispiel f r Parameter die an die Zahlungsplattform gesendet werden lt form method POST action https secure payzen eu vads payment gt lt input Senyon ke lt INPUT lt input lt input lt input lt input lt input lt input lt input lt input lt nonEe lt input lt input lt 1NPUT lt input type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type submit name vado action mode value TNTERACTIVES 72 name vads amount value 2990 gt name vads capture delay value 0 gt name vads ctx mode value TEST gt name vads currency value 978 gt name vads cust country value FR gt name vads cust email value nom prenom exemple com gt Name veads page laet ion value U PAYMENT 7 name vad
42. sofortigen Zahlungsbest tigung die Sie im Modus TEST und PRODUCTION eingegeben haben 2 Klicken Sie auf Einstellung gt Regeln der Benachrichtigungen 3 Geben Sie die URL zur sofortigen Zahlungsbest tigung ein Geben Sie keine Adresse unter localhost ein Der Aufruf dieser URL erfolgt von Server zu Server 4 Klicken Sie auf Speichern e Wenn der Status Gescheitert ist siehe Kapitel Fehlerbehandlung PayZen 2 3 14 Aktivieren des Shops im Produktionsmodus 90 14 AKTIVIEREN DES SHOPS IM PRODUKTIONSMODUS Dieses Kapitel erl utert folgende Aufgaben e Erzeugung des Produktionszertifikats e Umstellung des Shops auf das Produktionsumfeld e Durchf hrung einer ersten Zahlung im Produktionsumfeld e Erneute Erzeugung eines Produktionszertifikats im Fall von Problemen 14 1 Erzeugung des Produktionszertifikats Sie k nnen das Produktionszertifikat ber das Men Einstellung gt Shop gt Registerkarte Zertifikate gt Schaltfl che Erneut erstellen erzeugen Nachdem das Produktionszertifikat erstellt wurde wird sein Wert auf der Registerkarte Zertifikate angezeigt Eine E Mail wird an den zust ndigen Ansprechpartner Projektverantwortlicher des Unternehmens gesendet um ihm die Erzeugung des Produktionszertifikats zu best tigen 14 2 Umstellung des Shops auf das Produktionsumfeld 1 Setzen Sie das Feld vads_ctx_mode auf PRODUCTION 2 ndern Sie den Wert des Testzertifikats mit dem Wert Ihres Produktionszertif
43. ufer seine Zahlung nicht vor Ablauf der Zahlungssitzung abgeschlossen hat Die maximale Dauer einer Zahlungssitzung betr gt 10 Minuten So konfigurieren Sie diese Benachrichtigung 1 Wechseln Sie zu https de payzen eu vads merchant 2 Gehen Sie zum Men Einstellung gt Regeln der Benachrichtigungen 3 Klicken Sie mit der rechten Maustaste auf die Zeile IPN bei Stornierung 4 W hlen Sie Regel verwalten 5 Geben Sie die URL Ihrer Seite in die Felder Aufzurufende URL im Testumfeld und Aufzurufende URL im Produktionsumfeld ein 6 F llen Sie das Feld E Mailadresse n zur Fehlermeldung aus 7 Um mehrere E Mail Adressen anzugeben trennen Sie sie durch ein Semikolon 8 Konfigurieren Sie den Automatischen Neuversuch im Falle eines Scheiterns Mit dieser Option wird die Benachrichtigung im Falle eines Scheiterns automatisch bis zu vier Mal an den Shop gesendet Ausf hrlichere Informationen entnehmen Sie bitte dem Kapitel Aktivieren des automatischen Neuversuchs 9 Speichern Sie Ihre nderungen Wenn die Plattform die URL Ihrer Seite nicht erreichen kann wird eine E Mail an die in Schritt 6 angegebene Adresse gesendet Sie enth lt e den HTTP Code des aufgetretenen Fehlers e vom Fehler abh ngige Analyseelemente e Informationen ber das Verfahren das vom Back Office auszuf hren ist um die Anfrage wieder auf die in Schritt 5 definierte URL zur ckzuleiten PayZen 2 3 6 Benachrichtigungseinstellungen
44. zur ckkehren kann PayZen Sichere Zahlung VISA Ihr Zahlungsauftrag wurde von Ihrer Bank abgelehnt Loschen und zuruck zum Shop Pay e a a a Gm m m DSS Copyright PayZen 2014 Alle Rechte vorbehalten Paiement sur internet Abbildung 5 bersichtsseite im Fall eines Fehlschlags der Transaktion PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 11 4 2 Festlegen der Schritte f r eine Zahlung aus H ndlersicht Auf der H ndlerseite wird die Online Zahlung wie folgt abgewickelt Best tigt den Ruft das Ergebnis der Einkaufskorb Zahlung ab A i i ET PIOS EEE AE A A AE I ee E TE sendet das Analysiert und Zeigt das Ergebnis Erstellt das Zahlungsformular an bearbeitet das Ergebnis der Zahlung dem Zahlungsformular PayZen Weiterleitung der Zahlung K ufer an des K ufers an PayZen Benachrichtigung PAA EEEE EEEE EEEE E IE EEEE A I l I F hrt die Zahlung aus 1 Versendet des Leitet den K ufer zum gt Ergebnis shop weiter der Zahlung 2 j Abbildung 6 berblick ber die Interaktionen aus H ndlersicht 1 Der K ufer best tigt seinen Einkaufskorb 2 Der Shop erstellt das Formular anhand der Daten im Einkaufskorb des K ufers 3 Der Shop leitet den K ufer zur Zahlungsplattform weiter Diese Weiterleitung erfolgt mithilfe eines HTML POST Formulars ber HTTPS Die Parameter aus denen es sich zusammensetzt sind im Kapitel Erzeugen eines Zahlungsformulars beschrieben 4 Nach der
45. 00 Kategorie Informationen zur Lieferung u vads ship to name Beschreibung Erm glicht den Namen des K ufers anzugeben Format ans 63 Fehlercode 80 Kategorie Informationen zur Lieferung E vads ship to phone num Beschreibung Erm glicht die Telefonnummer des K ufers anzugeben Format ans 32 Fehlercode 87 Kategorie Informationen zur Lieferung u vads ship to speed Beschreibung Erm glicht den Liefermodus anzugeben Format string enum Fehlercode 95 M gliche Werte STANDARD EXPRESS Kategorie Informationen zur Lieferung E vads ship to status Beschreibung Erm glicht den Typ der Lieferadresse festzulegen Format string enum Fehlercode 93 M gliche Werte PRIVATE COMPANY Kategorie Informationen zur Lieferung E vads ship to_ state Beschreibung Erm glicht den Status des K ufers anzugeben Format ans 127 Fehlercode 84 Kategorie Informationen zur Lieferung PayZen 2 3 16 Datenlexikon 142 PayZen 2 3 16 Datenlexikon 143 u vads ship to_ street Beschreibung Erm glicht die Adresse des K ufers anzugeben Format ans 255 Fehlercode 81 Kategorie Informationen zur Lieferung E vads ship to_ street2 Beschreibung Erm glicht die zweite Adresszeile des K ufers anzugeben Format ans 255 Fehlercode 82 Kategorie Informationen zur Lieferung E vads ship to street number Beschreibung Erm glicht die Hausnummer anzugeben Format an 5 Fehlercode 114 Kategorie Informati
46. 17 gt lt input type hidden name vads page action value PAYMENT gt lt input type hidden name vads_payment_cards value VISA gt lt input type hidden name vads payment config value SINGLE gt lt input type hidden name vads site id value 12345678 gt lt input type hidden name vads trans date value 20140326164147 gt lt input type hidden name vads trans id value 164147 gt lt input lt input lt form gt type hidden type submit name vads version value V2 gt name bezahlen value Bezahlen gt PayZen 2 3 9 Berechnen der Signatur 70 9 BERECHNEN DER SIGNATUR Um die Signatur berechnen zu k nnen m ssen alle Felder deren Bezeichnung mit vads_ beginnt und das Zertifikat in Ihrem Besitz sein der Wert des Zertifikats erm glicht die Berechnung der numerischen Signatur abgerufen werden So berechnen Sie die Signatur 1 2 3 Sortieren Sie die Felder deren Name mit vads_ in alphabetischer Reihenfolge Vergewissern Sie sich dass alle Felder mit UTF 8 codiert sind Verketten Sie die Werte dieser Felder indem Sie sie mit dem Zeichen trennen Verketten Sie das Ergebnis mit dem Test oder Produktionszertifikat und trennen Sie die Werte mit dem Zeichen Wenden Sie den SHA 1 Algorithmus an um den Wert der Signatur zu erhalten Beispiel f r Parameter die an die Zahlungsplattform gesendet werden lt form method
47. 28 Gibt den Namen des bei der Zahlung verwendeten Beitrags an Joomla osCommerce usw vads_ctx_mode string Kommunikationsmodus der Zahlungsplattform enum vads_extra_result n2 Erg nzender Antwortcode Seine Bedeutung h ngt von dem Wert ab der in vads_result angegeben ist Eindeutiger Schl ssel der ausschlie lich an die URL zur Zahlungsbest tigung IPN zur ckgesendet wird vads_page_action string Definiert die durchzuf hrende Aktion enum vads_payment_error Fehlercodes bei einer verweigerten Zahlung vads_result n ja Allgemeiner R ckgabecode f r das Ergebnis der Zahlung vads_url_check ans 127 URL der nach Abschluss der Zahlung zu benachrichtigenden Site ndert den in den Einstellungen f r die Benachrichtigungsregeln eingegebenen Wert vads_url_check_src string Dieser Parameter definiert den Ursprung des Aufrufs der URL zur enum Zahlungsbest tigung IPN oder Server URL Version des Protokolls f r den Austausch mit der Zahlungsplattform Tabelle 29 Parameterliste technische Informationen E Informationen zur Bestellung Namedesreides Format Beschreibung OC OOOO Personalisierbare Felder die es erm glichen der an den H ndler gesendeten Best tigungs E Mail zus tzliche Felder hinzuzuf gen PayZen 2 3 16 Datenlexikon 95 Name des Feldes Beschreibung vads_order_info2 Beschreibung der Bestellung vads_product_ amountN vads_product_labeiN vads_product_gtyN vads_product_refN vad
48. 437faa5a7fce15d1ddcb9eaeaea377667b8 Aufbau der Sicherheitsmechanismen Konfiguriert die Daten bihnn Empf ngt die Daten Vergleicht die des Formulars iiia aa d f des Formulars und berechnete und die i EIN Akwualisierun berechnet die Signatur on gae berechnet die Signatur _ bermittelte Signaturen der Zahlun g und bermittelt das ung Signatur identisch g Formular Analyse der NEIN Fehlerursache JA ignaturen identisch Empf ngt die Daten des Vergleicht die F hrt die Konfiguriert die Daten Formulars und berechnete und die Zahlung aus _ es Formulars berechnet die Signatur bermittelte Signatur berechnet die Signatur und bermittelt das Formular Abbildung 11 Schema der Sicherheitsmechanismen Der Shop erfasst die Daten des Formulars und berechnet die Signatur Der Shop bermittelt das Formular an die Plattform Die Plattform empf ngt die Daten des Formulars und berechnet die Signatur u a E Die Plattform vergleicht die berechnete Signatur mit der vom Shop bermittelten Signatur PayZen 2 3 5 Einrichten des Dialogs mit der Zahlungsplattform 26 5 Wenn die Signaturen nicht bereinstimmen wird die Zahlung verweigert Andernfalls f hrt die Plattform die Zahlung durch 6 Die Plattform empf ngt die Daten des Ergebnisses und berechnet die Antwortsignatur 7 Abh ngig von den Einstellungen f r den Shop siehe Kapitel Benachrichtigungseinstellungen bermittelt die Plattform das Ergebnis der Zahlung an den
49. 5 Die Erstattung ist nicht zul ssig zu erzwingen Ung ltige W hrung f r die nderung MOTO Zahlung f r diese Karte nicht zul ssig Der Betrag bersteigt den autorisierten Betrag MOTO Ratenzahlung f r diese Karte nicht zul ssig 47 Das gew nschte Vorlagedatum liegt nach dem 119 Das bermittelte Datum ist ung ltig G ltigkeitsdatum der Autorisierung 48 Die erforderliche nderung ist ung ltig 120 Die Zahlungsoption der urspr nglichen Transaktion ist nicht anwendbar Unbekannter Shop Zahlung durch den Acquirer abgelehnt 51 Unbekannter Wechselkurs 126 Diese Aktion ist nicht m glich da die Zahlungssequenz nicht abgeschlossen ist 52 Der Vertrag ist seit dem 0 geschlossen Aufgrund einer technischen St rung k nnen wir Ihre Anforderung nicht verarbeiten 53 132 Der Shop 0 ist seit dem 1 geschlossen 135 Die Integration der Zahlungsseite in einen i Frame ist nicht zul ssig 54 Parameter zur ckgewiesen der sensible Daten 136 Ablehnung von abgeleiteten Transaktionen ohne enthalten kann 0 Haftungs bergang bei der Prim rtransaktion 55 Aufgrund einer technischen St rung k nnen wir 137 Die Transaktion liegt doppelt vor Ihre Anforderung nicht verarbeiten Fehler beim Abruf des Alias Eine Teilerstattung ist f r diese Transaktion nicht m glich Erstattung abgelehnt 58 Der Status des Alias ist mit diesem Vorgang nicht 139 kompatibel 9 Fehler beim Abruf des Alias 141 Die Risikokontrolle hat diese T
50. 55 In der Antwort zur ckgegebenes Feld Erm glicht den Status der Transaktion zu definieren string enum ABANDONED Die Zahlung wurde vom K ufer abgebrochen Die Zahlung wurde nicht erstellt und wird daher nicht im Back Office angezeigt AUTHORISED Wartet auf Kassenschnitt Die Transaktion ist angenommen und zum vorgesehenen Datum erfolgt automatisch der Kassenschnitt bei der Bank AUTHORISED_TO_VALIDATE Zu best tigen Die durch manuelle Best tigung erstellte Transaktion ist autorisiert Der H ndler muss den Bank Kassenschnitt manuell best tigen Die Transaktion kann best tigt werden solange das Datum des Kassenschnitts nicht berschritten ist Wenn dieses Datum berschritten wird erh lt die Zahlung den Status Verfallen Der Status Verfallen ist endg ltig CANCELED Storniert u Die Transaktion wurde durch den H ndler storniert CAPTURED Mit Kassenschnitt Der Bank Kassenschnitt f r die Transaktion ist erfolgt Verfallen Das Datum des Kassenschnitts ist erreicht und der H ndler hat das Datum des Bank Kassenschnitts der Transaktion nicht best tigt Verweigert Die Transaktion wird verweigert WAITING_AUTHORISATION Wartet auf Autorisierung Das angefragte Datum des Kassenschnitts liegt nach dem Ablaufdatum der G ltigkeit einer Autorisierungsanfrage Eine Autorisierungsanfrage f r einen euro Auskunftsanfrage wird durchgef hrt und von der ausgebenden Bank akzeptiert Die Autorisierungsanfrage wird aut
51. 71381 gt lt input type hidden name vads version value V2 gt lt input type hidden name signature value 7896adcaaf7336839030469715afal2353313f42 gt lt input type submit name bezahlen value Bezahlen gt toren PayZen 2 3 8 Verwenden von erg nzenden Funktionen 54 8 6 Festlegen des H ndlervertrags Der H ndler kann in seinem Zahlungsformular den Wert des zu verwendenden H ndlervertrags angeben Diese Funktionalit t ist nur von Nutzen wenn Sie ber mehrere Vertr ge innerhalb eines Akzeptanznetzes verf gen 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Verwenden Sie das optionale Feld vads_contracts um den zu verwendenden H ndlervertrag festzulegen Beispiel Beschreibung Nicht vorhanden oder leer Verwendung des Vertrags in der Priorit tsreihenfolge wie im Back Office festgelegt Men Einstellung gt Shop gt Registerkarte Vertr ge MASTERCARD 2323123 MasterCard K ufer AMEX 949400444000 American Express Netz PAYPAL name paypal com PayPal Um eine Liste von Vertr gen zu erstellen trennen Sie die Werte durch ein Semikolon 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel Sie verf gen ber e zwei VISA Vertr ge 1231230 und 1231231 e
52. Die Liste von Feldern kann aktualisiert werden Die Daten werden von der Zahlungsplattform immer im POST Modus gesendet Der erste Schritt besteht somit darin die im POST Modus erhaltenen Inhalte abzurufen Beispiele e In PHP werden die Dateien im bergeordneten globalen Array _POST gespeichert e In ASP NET C m ssen Sie die Eigenschaft Form der Klasse HttpRequest verwenden e In Java m ssen Sie die Methode getParameter der Schnittstelle HttpServletRequest verwenden Das Skript muss eine Schleife ausf hren um alle bermittelten Felder abzurufen 11 2 Berechnen der Signatur Die Signatur wird nach derselben Logik berechnet die bei der Erstellung des Zahlungsformulars verwendet wurde Alle empfangenen Felder sind zu ber cksichtigen So berechnen Sie die Signatur 1 Ber cksichtigen Sie alle Felder deren Name mit vads_ beginnt 2 Sortieren Sie diese Felder in alphabetischer Reihenfolge 3 Vergewissern Sie sich dass alle Felder mit UTF 8 codiert sind 4 Verketten Sie das Ergebnis mit dem Test oder Produktionszertifikat und trennen Sie die Werte mit dem Zeichen 5 Wenden Sie den SHA 1 Algorithmus an um den Wert der Signatur zu erhalten 11 3 Vergleichen der Signaturen PUm die Integrit t der Antwort sicherzustellen m ssen Sie den Wert des in der Antwort erhaltenen Feldes signature mit dem im vorherigen Schritt berechneten vergleichen Wenn die Signaturen bereinstimmen e gilt die Antwort als s
53. EPTED Standardwerte Ihre Zahlungsanforderung wurde vor Ihrem Bankinstitut abgelehnt PayZen 2 3 16 Datenlexikon 150 Beschreibung Diese Nachricht wurde durch das Feedback der f r die Risikokontrolle zust ndigen Stelle erzeugt Der Vertrag muss alle Arten von Karten unterst tzen die im Vertrag vorgesehen sind und nicht die Teilgruppe die der H ndler akzeptieren m chte Damit kann der Wortlaut der Ablehnung bei Verwendung einer e carte bleue berschrieben werden wenn diese von der Risikokontrolle nicht akzeptiert wird Kategorie Personalisierung der Zahlungsseite E vads_threeds_cavv Beschreibung Gibt die berpr fung der Authentifizierung des Inhabers durch den ACS ein Das Feld wird durch den 3 D Secure Authentifizierungsserver ACS ausgef llt wenn der K ufer ordnungsgem authentifiziert wird vads_threeds_status gleich Y oder A Format ans 28 Fehlercode 52 Kategorie 3 D Secure Authentifizierung u vads _threeds_cavvAlgorithm Beschreibung Vom ACS verwendeter Algorithmus um den Wert des CAVV zu erzeugen Das Feld wird durch den 3 D Secure Authentifizierungsserver ACS ausgef llt wenn der K ufer ordnungsgem authentifiziert wird vads_threeds_status gleich Y oder A Format n1 Fehlercode 55 a Beschreibung M gliche Werte gt Kategorie 3 D Secure Authentifizierung E vads threeds_ eci Beschreibung Gibt den E Commerce Index ICE an Das Fe
54. ERE T ey I a vacie CTX MOCE TESI Beispiel f r den Aufruf einer Konfigurationsdatei im Zahlungsformular CONE Ee Parse aaa elle Neem e eO e a e uns a e N E a ae ever ER eo a e a E a E O Zr E E a a a PayZen 2 3 6 Benachrichtigungseinstellungen 28 6 BENACHRICHTIGUNGSEINSTELLUNGEN Das Back Office erm glicht es die Ereignisse zu einzurichten die zur Erzeugung eines Aufrufs an den Shop f hren und die URL der zu kontaktierenden Seite zu konfigurieren Die folgenden Schemata zeigen f r jedes Ereignis den Status der Transaktion der in der Benachrichtigung bermittelt wird F r jeden Status gilt folgende Legende Aktion durch den H ndler erforderlich manuell Back Office oder automatisch WebService N Aktion des K ufers 6 1 Benachrichtigungen ber die verschiedenen Statuswerte bei einer sofortigen Barzahlung Durchf hrung der Zahlung Aufgabe ABANDONED Autorisierungsanfrage Zahlung verweigert Zahlung angenommen Automatische Best tigung AUTHORIZED T Stornierung O_VALIDATE Best tigung des NEIN Verfall der H ndlers Zahlung CANCELED e Stornierung AUTHORIZED CANCELED D R ckerstattung AUTHORIZED Neue Transaktion Abbildung 12 Flussdiagramm Sofortige Barzahlung Ereignis bermittelter Status Name der zu konfigurierenden Regel Abbruch durch den K ufer ABANDONED IPN bei Stornierung Stornierung durch den H ndl
55. Eingabe der Daten des Zahlungsmittels durch den K ufer f hrt die Plattform mit der Zahlung fort 5 Abh ngig von den Einstellungen f r den Shop erfolgt ein automatischer Aufruf um das Ergebnis der Zahlung an den Shop zu bermitteln 6 Der Shop analysiert und verarbeitet das Ergebnis der Zahlung 7 Er aktualisiert die Datenbank Status des Lagerbestands Status der Bestellung usw 8 Der K ufer wird auf der Plattform ber das Ergebnis der Zahlung informiert Wenn der K ufer sich entscheidet zum Shop zur ckzukehren dankt ihm der Shop und zeigt den Status seiner Bestellung an PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 12 4 3 Lebenszyklus der Transaktionen F r alle nachstehenden Schemata gilt die folgende Legende Aktion durch den H ndler erforderlich manuell Back Office oder automatisch WebService Modus f r automatische Best tigung Lebenszyklus einer Transaktion f r sofortige Barzahlung Durchf hrung der Zahlung 3 D Secure Authentifizierung Verweigert KO gt Lokale Kontrollen AuUEEEEEEEEBEEEBEEEBEEBEREEENEENEEE OK Autorisierungs anfrage OK Autorisierung angenommen KO Versendung von E Mail an K ufer Wartet auf Stornierung Kassenschnitt Am Tag des angefragten Bank Kassenschnitts Vorgelegt Nach einem Zahlungsauftrag werden automatisch mehrere Pr fungen durchgef hrt e Die 3 D Secure Authentifizierung e Vers
56. Format n 3 Fehlercode 06 Kategorie Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 107 E vads card brand Beschreibung In der Antwort zur ckgegebenes Feld Verwendetes Zahlungsmittel falls verf gbar andernfalls leer Der Wert stammt aus den BIN Bereichen Format an 127 M gliche Werte Sich auf den Parameter vads_payment cards beziehen Kategorie Informationen zum Zahlungsmittel E vads card country Beschreibung In der Antwort zur ckgegebenes Feld L ndercode der f r die Zahlung verwendeten Karte gem Norm ISO 3166 Format ISO 3166 Kategorie Informationen zum Zahlungsmittel E vads card _ number Beschreibung Im Zahlungsauftrag Komplette Kartennummer bei stiller Zahlung In der Antwort e Verdeckte Kartennummer Enth lt die ersten 6 Stellen der Nummer gefolgt von XXXXXX und den 4 letzten Stellen e IBAN und BIC die f r die Zahlung verwendet werden getrennt durch _ im Fall einer Lastschriftzahlung Format an 36 Fehlercode 40 Kategorie Informationen zum Zahlungsmittel PayZen 2 3 16 Datenlexikon 108 E vads_contracts Beschreibung Erm glicht in Form einer Liste f r jedes Akzeptanznetz den zu verwendenden H ndlervertrag festzulegen Format NETZ1 Vertragl NETZ2 Vertrag2 NETZ3 Vertrag3 M gliche Werte Die m glichen Netze sind ACCORD Banque Accord Netz Geschenk und Kundenkreditkarten ACCORD_SANDBOX Banque Accord Netz Geschenk und Kundenkreditkar
57. K ufer angegeben wurden PayZen 2 3 8 Verwenden von erg nzenden Funktionen 68 6 F llen Sie das Feld vads_payment_cards gem der Auswahl des K ufers aus Verwenden Sie dazu die folgende Tabelle Beschreibung ACCORD_STORE ACCORD_STORE_SB ALINEA ALINEA_CDX ALINEA_CDX_SB ALINEA_SB AMEX AURORE MULTI BIZZBEE_CDX BIZZBEE_CDX_SB BRICE_CDX BRICE_CDX_SB Zahlung mit Banque Accord Karte Zahlung mit Banque Accord Karte Sandbox Alinea Kundenkreditkarte Alinea Geschenkkarte Alinea Geschenkkarte SandBox Alinea Kundenkreditkarte SandBox American Express Aurore Karte Bizzbee Geschenkkarte Bizzbee Geschenkkarte SandBox Brice Geschenkkarte Brice Geschenkkarte SandBox CDGP COF3XCB COF3XCB_SB COFINOGA CORA_BLANCHE CORA_PREM CORA_VISA DINERS E CARTEBLEUE IDEAL ILLICADO ILLICADO_SB Privilege Karte 3 Mal CB Cofinoga 3 Mal CB Cofinoga Sandbox Be Smart Karte Cora Blanche Karte Cora Premium Karte Cora Visa Karte Diners Club Karte E carte bleue Bank berweisung Illicado Geschenkkarte go Illicado Geschenkkarte SandBox JCB Karte Joueclub Geschenkkarte an O gI JOUECLUB_CDX JOUECLUB_CDX_SB JULES_CDX JULES_CDX_SB MAESTRO MASTERCARD ONEY ONEY_SANDBOX PAYLIB PAYPAL PAYPAL_SB PAYSAFECARD POSTFINANCE POSTFINANCE_EFIN S MONEY S Joueclub Geschenkkarte SandBox Jules Geschenkkarte Jules Geschenkkarte SandBox Maestro MasterCard 3 4 Mal Zahlung Oney FaciliPay 3 4
58. Letztere den fehlerhaften Parameter im Feld vads_extra_result durch einen numerischen Code an e Anmerkung Zusatzinformationen Pr zisierungen e Kategorie Kategorie der das Feld angeh rt Pr zisierungen hinsichtlich der Fehlercodes Fehlercode entspricht der Nummer des Fehlers bei der bermittlung eines fehlerhaften Zahlungsformulars e Im Testmodus wird dieser Code auf der Zahlungsseite angezeigt e Im Produktionsmodus wird eine Warnmeldung per E Mail verschickt die den Code und den Namen des fehlerhaften Parameters angibt Beispiel Fehler 09 entspricht einem Fehler beim Betrag Der gesendete Betrag ist nicht im erforderlichen Format PayZen 2 3 16 Datenlexikon 94 u Anzeigen der Parameter nach Kategorie Gehen Sie zur gew nschten Kategorie um die entsprechende nachstehend aufgef hrte Parameterliste anzuzeigen e Informationen zur 3 D Secure Authentifizierung e Informationen zur Ratenzahlung e Informationen zum K ufer e Informationen zum Zahlungsmittel e Informationen zur Bestellung e Informationen zur Lieferung e Technische Informationen e Informationen zur Transaktion e Informationen zu Spendenzahlungen e Personalisierung der Zahlungsseite e Automatische Weiterleitung u Technische Informationen Name des Feldes Format Beschreibung Erm glicht die Integrit t der Anforderungen zu berpr fen Definiert den Modus f r die Erfassung der Kartendaten enum vads_contrib ans 1
59. Mal Zahlung Oney FaciliPay Sandbox Paylib PayPal PayPal Sandbox Prepaid Karte Paysafecard PostFinance PostFinance Modus E finance S Money SEPA berweisung SEPA Lastschrift Sofort Truffaut Geschenkkarte O a J J SOFORT_BANKING TRUFFAUT_CDX V_ME VISA VISA_ELECTRON ECCARD IDEAL V me by Visa Visa Visa Electron eccard IDEAL go PayZen 2 3 8 Verwenden von erg nzenden Funktionen 69 7 F gen Sie optionale Felder gem Ihren Anforderungen hinzu siehe Kapitel Verwenden von erg nzenden Funktionen 8 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Formulars f r eine Zahlung ohne Weiterleitung zur Zahlungsseite lt form method POST action https secure payzen eu vads payment gt lt input lt input type hidden type hidden name vads_action_mode value SILENT gt name vads amount value 4000 gt lt input type hidden name vads capture delay value 0 gt lt input type hidden name vads_card number value 4970100000000000 gt lt input type hidden name vads ctx mode value TEST gt lt input type hidden name vads currency value 978 gt lt input type hidden name vads_cvv value 123 gt lt input type hidden name vads_expiry month value 5 gt lt input type hidden name vads_expiry year value 20
60. N ZAHLUNGSARTEN 3 1 Sofortige Barzahlung Eine Zahlung gilt als sofortige Barzahlung wenn e der Betrag auf einmal belastet wird e die Zeitspanne f r den Bank Kassenschnitt O Tage betr gt Es wird eine Autorisierungsanfrage f r den Gesamtbetrag ausgef hrt Der Bank Kassenschnitt f r die Zahlung erfolgt so schnell wie m glich 3 2 Zeitverz gerte Barzahlung Eine Zahlung gilt als zeitverz gerte Barzahlung wenn e der Betrag auf einmal belastet wird e die Zeitspanne f r den Bank Kassenschnitt mehr als O Tage betr gt Das Datum des Bank Kassenschnitts kann nicht sp ter als 12 Monate nach dem Erfassungsdatum der Zahlung liegen Es gibt zwei Arten von zeitverz gerten Barzahlungen e Zeitspanne f r den Kassenschnitt k rzer als die G ltigkeitsdauer der Autorisierung siehe Kapitel G ltigkeitsdauer einer Autorisierung weiter unten Es wird eine Autorisierungsanfrage f r den Gesamtbetrag ausgef hrt Ohne nderungen durch den H ndler erfolgt der Bank Kassenschnitt f r die Zahlung zum angefragten Vorlagedatum e Zeitspanne f r den Kassenschnitt l nger als die G ltigkeitsdauer der Autorisierung siehe Kapitel G ltigkeitsdauer einer Autorisierung weiter unten Eine Autorisierungsanfrage f r 11 euro Auskunftsanfrage wird zum Zeitpunkt der Erfassung der Zahlung ausgef hrt um die G ltigkeit der Karte sicherzustellen Wenn diese Autorisierung f r 1 1 euro angenommen wird wird die Zahlung erfasst An T 1 zum Da
61. POST action https secure payzen eu vads payment gt lt input lt input lt INPUT lt IHPUE lt input lt INPUT lt LNpPUT lt input lt 1NPUT lt inpuT lt LNPUT lt input lt form gt type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type submit name vads action mode value INTERACTIVE gt name vads amount value 1524 gt name vads ctx mode value TEST gt name vads currency value 978 gt name vads page action value PAYMENT gt name vads payment config value SINGLE gt name vads site id value 12345678 gt name vads trans date value 20090501193530 gt name vads trans id value 654321 gt name vads version value V2 gt name signature value 606b6369759fac4 0864144c803c73676cbe470ff gt name payer value Payer gt Dieses Formularbeispiel wird wie folgt analysiert 1 Sortieren Sie die Felder in alphabetischer Reihenfolge deren Name mit vads_ beginnt e vads_ action _mode e vads amount e vads_ctx_mode e vads_currency e vads_page_action e vads payment_config e vads_site_id e vads_trans_date e vads_trans_id e vads_version Verketten Sie die Werte dieser Felder mit dem Zeichen INTERACTIVE 1524 TEST 978 PAYMENT SINGLE 12345678 20090501193530 654321 V2 F gen Sie am Ende der Verkettung den Wert des Testzertifikats hinzu in
62. REGISTER_PAY_SUBSCRIBE SUBSCRIBE e ASK_REGISTER_PAY Technische Informationen PayZen 2 3 16 Datenlexikon 124 PayZen 2 3 16 Datenlexikon 125 E vads payment cards Beschreibung Enth lt die Liste der Kartentypen die dem K ufer anzubieten sind getrennt durch Semikolon Wenn die Liste nur einen Kartentyp enth lt wird die Dateneingabeseite f r dieses Zahlungsmittel direkt angezeigt Andernfalls wird die Seite f r die Auswahl der Zahlungsmittel angezeigt Wenn dieser Parameter leer ist empfohlen werden die f r den Shop zul ssigen Zahlungsmittel W hrung technische Beschr nkungen usw angeboten Format typ1 typ2 typ3 Fehlercode 08 In folgenden F llen wird das Formular abgelehnt e Der bermittelte Wert ist nicht in der nachfolgenden Liste vertreten e ALLE ALL sind keine g ltigen Werte Um alle Zahlungsmittel anzugeben darf dieser Parameter nicht oder lediglich leer abgesendet werden e Der bermittelte Wert entspricht nicht dem f r Ihren Shop verf gbaren Zahlungsmittel e IhreCommerce Vertrag wurde vor Ihrem Bankinstitut beendet Wenden Sie sich an den Kundenservice Ihrer Zahlungsplattform M gliche Werte VE 77 77 PayZen 2 3 16 Datenlexikon 126 Beschreibung SD Kategorie Informationen zur Transaktion E vads payment certificate Beschreibung In der Antwort zur ckgegebenes Feld Diese Feld wird von der Zahlungsplattform ausgef llt wenn die Autorisierung
63. STERCARD PREPAID DEBIT STANDARD TRAVEL MASTERCARD PREPAID DEBIT STANDARD TEEN MASTERCARD PREPAID DEBIT STANDARD VERNMENT DEBIT MASTERCARD BUSINESS CARD PREPAID WORK B2B MASTERCARD PREPAID DEBIT STANDARD FLEX BENEFIT MASTERCARD PREPAID DEB STANDARD EMPLOYEE INCENTIVE MASTERCARD PREPAID CARD MASTERCARD UNKNOWN PRODUCT PREPAID MASTERCARD BUSINESS CARD PREPAID MAESTRO CONSUMER RELOADABLE CARD MAESTRO CARD WORLD MASTERCARD FOR BUSINESS CARD WORLD ELITE MASTERCARD CARD Reserved DEBIT MASTERCARD CARD DELAYED DEBIT Visa Corporate T amp E MCB MASTERCARD BUSINESSCARD CARD Visa GSA Corporate T amp E MCC MASTERCARD CREDIT CARD MIXED BIN MVOIR MASTERCARD FLEET CARD LD MASTERCARD CARD MASTERCARD CORPORATE CARD MASTERCARD PURCHASING CARD STANDARD MASTERCARD CARD WORLD MASTERCARD CARD LD DEBIT MASTERCARD CARD WORLD DEBIT EMBOSSED MASTERCARD CARD PLATINUM DEBIT MASTERCARD CARD DEBIT MASTERCARD CARD DEBIT MASTERCARD UNEMBOSSED MASTERCARD WORLD CARD MASTERCARD UNKNOWN PRODUCT DEBIT MASTERCARD STANDARD PREPAID GENERAL SPEND PLATINUM MASTERCARD CARD MASTERCARD PREPAID CARD MASTERCARD PREPAID CARD MASTERCARD REWARDS ONLY PREPAID MASTERCARD BUSINESS CARD MAESTRO SMALL BUSINESS CARD MAESTRO CARD MAESTRO PREPAID OTHER CARD PREPAID MAESTRO CORPORATE CARD Visa Traditional Visa Traditional Rewards Visa Signature Visa Signature Preferred S Proprietary ATM s lt Visa Classic Visa Business G1 Visa Signa
64. Warnmeldung an die im Back Office angegebene Adresse gesendet siehe Kapitel Benachrichtigungseinstellungen Sie enth lt e den HTTP Code des aufgetretenen Fehlers e vom Fehler abh ngige Analyseelemente e Informationen ber das Verfahren das vom Back Office auszuf hren ist um die Benachrichtigung zur ckzusenden Einrichten des Bearbeitungsskripts Das Bearbeitungsskript muss mindestens die folgenden Schritte enthalten e Abrufen der Felder die in der per POST versendeten Antwort enthalten sind e Berechnen der Signatur e Vergleich der berechneten Signatur mit der empfangenen PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 76 e Analyse der Art der Benachrichtigung e Abfrage des Ergebnisses der Zahlung Das Skript kann z B den Status der Bestellung oder von Informationen Ihrer Wahl pr fen um sicherzustellen dass sie nicht aktualisiert wurde n Nachdem diese Schritte ausgef hrt wurden kann das Skript die Datenbank aktualisieren neuer Bestellungsstatus Aktualisierung des Lagerbestands Erfassung der Zahlungsinformationen usw PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 77 11 1 Abrufen der in der Antwort zur ckgegebenen Daten Welche Daten in der Antwort zur ckgegeben werden h ngt von den im Zahlungsformular gesendeten Parametern vom Typ der durchgef hrten Zahlung und von den Optionen Ihres Shops ab Diese Daten bilden eine Liste von Feldern Jedes Feld enth lt einen Antwortwert
65. Zahlungsseiten verkn pft sind Beschriftungen Bilder denen ein Wert zugeordnet wird Beispiel vads_theme_config SUCCESS_FOOTER_MSG_RETURN Zur ck zur Website CANCEL_FOOTER_MSG_RETURNSsStornieren und Zur ck zur Website Die Basisfunktionalit ten sind im Kapitel Personalisierung der Zahlungsseite im Implementierungsleitfaden f r das Zahlungsformular beschrieben Die erweiterten Funktionalit ten optional sind im Leitfaden zur erweiterten Personalisierung der Zahlungsseite beschrieben Format Code1 Wert1 Code2 Wert2 Fehlercode 32 Beschreibung SUCCESS_FOOTER_MSG_RETURN Beschriftung die Zur ck zum Shop im Fall einer erfolgreich durchgef hrten Zahlung ersetzt CANCEL_FOOTER_MSG_RETURN Beschriftung die L schen und zur ck zum Shop in Auswahlphasen und bei der Eingabe der Kartendaten sowie im Fall eines Fehlschlags der Zahlung ersetzt M gliche Werte SECURE_ MESSAGE Standardwerte Der URL Pr fix https dieser Seite bedeutet dass die Zahlungsseiten sicher sind und Sie Ihren Einkauf unbedenklich bezahlen k nnen SECURE_MESSAGE_REGISTER Standardwerte Der URL Pr fix https dieser Seite bedeutet dass die Zahlungsseiten sicher sind und Sie Ihre Bankdaten ausf llen k nnen SITE_ID_LABEL Standardwerte Kennnummer des H ndlers CSS_FOR_PAYMENT Siehe Leitfaden zur erweiterten Personalisierung der CSS_FOR_PAYMENT_MOBILE Zahlungsseite HEADER_FOR_MAIL FOOTER_FOR_MAIL SHOP_LOGO CTRL_RISK_CARD_NOT_ACC
66. Zen 2 3 7 Erzeugen eines zahlungsformulars 41 7 2 Erstellen einer zeitverz gerten Barzahlung Eine zeitverz gerte Barzahlung wird auf einmal belastet wobei die Zeitspanne f r den Bank Kassenschnitt strikt mehr als O Tage betr gt e F r den Gesamtbetrag wird eine Autorisierungsanfrage ausgef hrt wenn der G ltigkeitszeitraum der Autorisierung k rzer oder gleich dem G ltigkeitszeitraum einer Autorisierungsanfrage ist siehe Tabelle e Eine Autorisierungsanfrage von 1 wird ausgef hrt wenn die G ltigkeitsfrist der Autorisierung l nger als die G ltigkeitsdauer einer Autorisierungsanfrage ist siehe bersicht Die Autorisierungsanfrage f r den Gesamtbetrag wird automatisch zu T 1 vor dem Datum der Vorlage bei der Bank ausgel st 1 Verwenden Sie alle Felder in der folgenden Tabelle um Ihr Zahlungsformular zu erstellen Name desreldes Beschreibung ILL Te OoOO Tabelle 5 Liste der Felder zeitverz gerte Barzahlung 2 Setzen Sie das Feld vads_payment_config auf SINGLE 3 Geben Sie in das Feld vads_capture_delay einen Wert gr er als O ein 4 Setzen Sie das Feld vads_validation_mode auf 0 wenn Sie eine automatische Best tigung w nschen Bank Kassenschnitt f r die Zahlung erfolgt automatisch F r eine manuelle Best tigung setzen Sie das Feld auf 1 der Bank Kassenschnitt f r die Zahlung erfolgt nach manueller Best tigung im Back Office 5 Geben Sie in das Feld vads_currency den Code der gew nsch
67. _error value http demo com error php gt lt input lt input none type hidden type hidden type hidden name vads_url_refused value http demo com refused php gt name vads_url_success value http demo com success php gt menem ea er oa value iv i 7 PayZen 2 3 8 Verwenden von erg nzenden Funktionen 56 lt input type hidden name signature value 86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee gt lt input type submit name bezahlen value Bezahlen gt lt form gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 57 Festlegen einer einzelnen Back URL unabh ngig vom Ergebnis der Zahlung 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Verwenden Sie das optionale Feld vads_url_return um die URL f r die Weiterleitung bei Abschluss der Zahlung festzulegen Wenn im Formular keine URL angegeben ist wird der im Back Office konfigurierte Wert ber cksichtigt 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit Festlegung einer einzelnen Back URL unabh ngig vom Ergebnis der Zahlung lt form method POST action https secure payzen eu vads payment gt lt input lt input lt 1NPUT lt inpuT lt LNPUT Zaemone lt input l
68. _number auf 1 gesetzt 5 Rufen Sie den Wert des Feldes vads_trans_date ab um das Datum der Zahlung zu ermitteln 6 Rufen Sie den Wert des Feldes vads_capture_delay ab um die Anzahl von Tagen vor dem Bank Kassenschnitt zu ermitteln Auf diese Weise k nnen Sie feststellen ob es sich um eine sofortige oder zeitverz gerte Zahlung handelt 7 Rufen Sie den Betrag und die verwendete W hrung ab Bestimmen Sie dazu die Werte der folgenden Felder Name des Feldes Beschr Betrag der Zahlung in kleinster W hrungseinheit Code der W hrung die f r die Zahlung verwendet wird T a N H pi D FF eipun 5 vads_change_rate Wechselkurs der zur Berechnung des effektiven Betrags der Zahlung verwendet wird siehe vads_effective_amount vads_effective_amount Betrag der Zahlung in der W hrung die f r den Bank Kassenschnitt verwendet wird Tabelle 20 Analyse des Betrags und der verwendeten W hrung PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 83 8 Rufen Sie den Wert des Feldes vads_auth_result ab um das Ergebnis der Autorisierungsanfrage zu erfahren Die vollst ndige Liste der bermittelten Codes kann im Datenlexikon eingesehen werden Um Sie dabei zu unterst tzen den Grund der Zur ckweisung zu ermitteln finden Sie hier eine Liste von h ufig zur ckgegebenen Codes Beschreibung Akzeptant ung ltig Dieser Code wird von der Bank des K ufers ausgegeben Er weist auf ein Konfigurationsproblem auf den
69. _return_mode query string Die R ckgabefelder werden an die Back URL in Form eines HTTP POST Formulars bermittelt Sollte die R ckkehr zum Shop ber ein Nicht HTTPS Umfeld erfolgen wird dem K ufer im Browser ein Sicherheits Pop up Fenster angezeigt Kategorie Weiterleitung zum Shop PayZen 2 3 16 Datenlexikon 138 E vads_risk_analyzis_result Beschreibung In der Antwort zur ckgegebenes Feld Gibt das Ergebnis der Betrugskontrolle zur ck die durch ein externes System durchgef hrt wurde ClearSale CyberSource usw Zur ckgesendet in der URL der sofortigen Zahlungsbest tigung auch als IPN bezeichnet und in den R cksendungsparametern Format ans M gliche Werte CyberSource m SUCCESS Die Transaktion wurde erfolgreich durchgef hrt MISSING_FIELDS Die Transaktion wird verweigert Ein oder mehrere Felder fehlen 102 INVALID_FIELDS Die Transaktion wird verweigert Ein oder mehrere Felder enth lt ung ltige Daten SERVER_TIME_OUT Fehler Die Anforderung wurde empfangen die Frist ist jedoch abgelaufen Dieser Fehler beinhaltet keine Timeouts zwischen Client und Server 152 SERVICE_TIME_OUT Fehler Die Anforderung wurde empfangen ein Dienst wurde jedoch nicht rechtzeitig beendet 202 CARD_EXPIRED Verweigert Karte abgelaufen ACCOUNT_NUMBER_INVALID Verweigert Ung ltige Kontonummer ACCOUNT_PROBLEM Verweigert Bei der CyberSource Konfiguration des H ndlers ist ein Fehler aufgetreten
70. ads_extra_result Beschreibung In der Antwort zur ckgegebenes Feld Erg nzender Antwortcode Seine Bedeutung h ngt von dem Wert ab der in vads_result angegeben ist e Wenn vads_result gleich 30 Anforderungsfehler enth lt vads_extra_result den numerischen Code des Feldes das einen Wert oder Formatfehler enth lt Dieser Wert kann im Fall eines unbekannten Fehlers in der Anforderung mit 99 angegeben werden Beispiel Wenn vads_extra_result den Wert 09 enth lt bedeutet dies dass der in vads_amount angegebene Betrag falsch ist beispielsweise wenn der Betrag Dezimalzahlen enth lt weil er vorher nicht in Cents umgerechnet war e Nenn vads_result gleich 05 verweigert oder 00 angenommen ist enth lt vads_extra_result den numerischen Code des Ergebnisses der Risikokontrolle PayZen 2 3 16 Datenlexikon 121 vads_extra_result Beschreibung 04 Das Ausgabeland der Karte ist in der Blacklist des H ndlers aufgef hrt Die IP Adresse ist in der Blacklist des H ndlers aufgef hrt Erkennung einer e Carte Bleue Erkennung einer nationalen Gesch ftskarte Erkennung einer ausl ndischen Gesch ftskarte Erkennung einer Karte mit systematischer Autorisierung Der BIN Code ist in der Blacklist des H ndlers aufgef hrt Plausibilit tspr fung kein entsprechendes Land L nder IP Land der Karte Land des K ufers Das Land der IP Adresse ist in der Blacklist aufgef hrt Bei der Verarbeitung einer der lokale
71. age durchgef hrt wird string enum FULL entspricht einer Autorisierung des Gesamtbetrags der Transaktion Dieser Wert wird im Fall einer Barzahlung verwendet wenn die Zeitspanne zwischen dem Datum des angefragten Kassenschnitts und dem Tagesdatum strikt k rzer als die G ltigkeitsdauer der Autorisierung ist MARK entspricht einer Autorisierung von 1 Euro Antrag auf Auskunftserteilung Dieser Wert wird im Fall einer zeitverz gerten Zahlung verwendet wenn die Zeitspanne zwischen dem Datum des angefragten Kassenschnitts und dem Tagesdatum strikt l nger als die G ltigkeitsdauer der Autorisierung ist Informationen zur Transaktion E vads auth number Beschreibung Format Kategorie In der Antwort zur ckgegebenes Feld Vom Bankserver zur ckgegebene Autorisierungsnummer wenn verf gbar andernfalls leer an 6 Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 103 E vads auth result Beschreibung In der Antwort zur ckgegebenes Feld Von der ausgebenden Bank zur ckgegebener R ckgabecode der Autorisierungsanfrage falls verf gbar Format n2 M gliche Werte Wert Beschreibung Betrugsabsic Wert Beschreibung Betrugsabsic Genehmigte oder erfolgreich Verfalldatum der Karte verarbeitete Transaktion berschritten Wenden Sie sich an den Karte verloren Kartenaussteller oB o Akzeptant ung ltig 43 Karte Karte gestohlen 00000 Karte aufbewahren a 7 Deckung oder Verf gungsra
72. aid Karten Tabelle 22 Wert des Feldes vads_threeds_enrolled b Bestimmen Sie das Ergebnis der 3 D Secure Authentifizierung indem Sie den Wert des Feldes vads_threeds_status abrufen Wert Beschreibung 3 D Secure Authentifizierung nicht durchgef hrt 3 D Secure in der Anforderung deaktiviert Inhaber nicht registriert oder Zahlungsmittel f r 3 D Secure nicht zugelassen N Fehler bei der Authentzierung des Inhabers u LIST OOO OOOO A Autheninzierungsversuch Authenttizeruna jedoch nint durchgef hte Tabelle 23 Wert des Feldes vads_threeds_status 10 Rufen Sie das Ergebnis der Pr fungen f r den Betrugsschutz ab indem Sie den Wert des Feldes vads_risk_control ermitteln Dieses Feld wird nur gesendet wenn der H ndler e die Option Risikoverwaltung gew hlt hat e im Back Office mindestens eine Pr fung aktiviert hat Men Einstellung gt Risikokontrolle Das Feld enth lt als Wert eine Liste von Werten die durch ein Semikolon getrennt ist und folgende Syntax aufweist vads_risk_control control1 result1 control2 result2 Die m glichen Werte f r control sind Beschreibung CARD_FRAUD Pr fung auf Vorhandensein der Kartennummer in der Karten Blacklist SUSPECT_COUNTRY Pr fung auf Vorhandensein des Ausgabelandes der Karte des K ufers in der Liste der gesperrten L nder IP_FRAUD Pr fung auf Vorhandensein der IP Adresse des K ufers in der IP Blacklist CREDIT_LIMIT Pr fung der H ufigkeit und
73. atenlexikon 98 Name des Feldes Format 00 Beschreibung vads_validation_mode string enum Best tigungsmodus der Transaktion vads_warranty_result string enum Haftungs bergang im Fall einer angenommenen Zahlung Tabelle 34 Parameterliste Informationen zur Transaktion u 3 D Secure Authentifizierung Name des Feldes Format Beschreibung vads_threeds_cavv Gibt die berpr fung der Authentifizierung des Inhabers durch den ACS ein Das Feld wird durch den 3 D Secure Authentifizierungsserver ACS ausgef llt wenn der K ufer ordnungsgem authentifiziert wird vads_threeds_status gleich Y oder A vads_threeds_cavvAlgorithm Vom ACS verwendeter Algorithmus um den Wert des CAVV zu erzeugen Das Feld wird durch den 3 D Secure Authentifizierungsserver ACS ausgef llt wenn der K ufer ordnungsgem authentifiziert wird vads_threeds_status gleich Y oder A vads_threeds_eci Gibt den E Commerce Index ICE an Das Feld wird durch den 3 D Secure Authentifizierungsserver ACS ausgef llt wenn der K ufer ordnungsgem authentifiziert wird vads_threeds_status gleich Y oder A vads_threeds_enrolled al Gibt den Registrierungsstatus des Inhabers an Das Feld wird durch die VISA und MASTERCARD DS Server w hrend des 3 D Secure Prozesses ausgef llt vads_threeds_exit_status N 2 Gibt den abschlie enden Status des 3D Secure Prozesses an Das Feld wird von der Zahlungsplattform ausgef
74. atenzahlung ab und inkrementiert die Anzahl von Raten wenn die Zahlung angenommen wird PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 80 11 5 Angeben des Vorgangstyps Das Feld vads_operation_type erm glicht es zwischen Folgendem zu unterscheiden e einem Belastungsvorgang e einem Erstattungsvorgang DEBIT CREDIT Erstattungsvorgang Tabelle 16 Wert des Feldes vads_operation_type Beispiel Wenn bei vads_operation_type der Wert DEBIT eingegeben wird aktualisiert das Skript die Bestellung und speichert die Transaktionsinformationen Wenn bei vads_operation_type der Wert CREDIT eingegeben wird aktualisiert das Skript den bezahlten Betrag oder f gt eine neue Transaktionszeile zu der Bestellung hinzu PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 81 11 6 Verarbeiten der Daten der Antwort Nachstehend finden Sie ein Analysebeispiel als schrittweise Anleitung bei der Verarbeitung der Daten der Antwort 1 Identifizieren Sie die Bestellung indem Sie den Wert im Feld vads_order_id abrufen wenn Sie ihn im Zahlungsformular bermittelt haben Vergewissern Sie sich dass der Status der Bestellung nicht aktualisiert wurde 2 Rufen Sie das Ergebnis der Zahlung ab das im Feld vads_trans_status bermittelt wird Dieser Wert erm glicht Ihnen den Status der Bestellung zu bestimmen ABANDONED Die Zahlung wurde vom K ufer abgebrochen Die Zahlung wurde nicht erstellt und wird daher
75. b_amount n 12 Betrag der Raten der Ratenzahlung f r alle Raten au er den eventuell in folgender Einstellung definierten vads_sub_init_amount_number vads_sub_currency n3 Numerischer Code der f r die Ratenzahlung zu verwendenden W hrung gem Norm ISO 4217 vads_sub_desc Anzuwendende Rekursionsregel gem Spezifikation iCalendar RFC5545 In Datum des Beginns der Ratenzahlung vads_sub_init_amount Betrag der Raten der Ratenzahlung f r die ersten Raten dar Farmst FOTITIAL vads_sub_effect_date vads_sub_init_amount_number n 3 Anzahl von Raten auf die der Betrag vads_sub_init_amount anzuwenden ist vads_subscription Kennung der zu erstellenden Ratenzahlung Tabelle 39 Parameterliste Informationen zur Ratenzahlung PayZen 2 3 16 Datenlexikon 101 E signature Beschreibung Pflichtparameter Erm glicht die Integrit t der bermittelten Anforderungen zu berpr fen Der Wert wird berechnet e durch den Shop zum Zeitpunkt des Zahlungsauftrags e durch die Zahlungsplattform zum Zeitpunkt der Antwort Format an40 Fehlercode 00 signature wenn der Wert dieses Feldes nicht korrekt ist 70 empty params wenn das Feld nicht vorhanden oder als leer bermittelt wird H ufige Fehler e Die verschiedenen Felder des Formulars sind nicht in UTF 8 codiert e Der verwendete MODUS Test oder Produktion oder das verwendete ZERTIFIKAT ist ung ltig e R ckkehr zur Position und oder zum Einkaufskorb die im
76. cher Autorisierung handelt INCONSISTENT_COUNTRIES Pr fung ob das Land der IP Adresse das Ausgabeland der Zahlungskarte und das Land der Adresse des K ufers bereinstimmen NON_WARRANTY_PAYMENT Pr fung des Haftungs bergangs der Transaktion SUSPECT_IP_COUNTRY Pr fung auf Vorhandensein des Landes des K ufers das durch seine IP Adresse identifiziert wird in der Liste der gesperrten L nder Die m glichen Werte f r Ergebnis sind Beschreibung Informative Pr fung fehlgeschlagen ERROR Blockierende Pr fung fehlgeschlagen Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 140 u vads risk primary warranty Beschreibung Spezifisch f r Spenden oder Sekund rtransaktionen Erm glicht die Konfiguration der Risikokontrolle Pr fung des Haftungs bergangs bei der Prim rtransaktion zu ndern Format string enum Fehlercode 117 M gliche Werte reon DEFAULT oder leer Standardwert Verwendung der Konfiguration des Ziel Shops IGNORE Ignoriert den Wert des Haftungs bergangs der Prim rtransaktion vor Erstellung der Sekund rtransaktion CHECK Erzwingt die Pr fung des Haftungs bergangs der Prim rtransaktion vor Erstellung der Sekund rtransaktion Kategorie Informationen zu Spendenzahlungen E vads sequence number Beschreibung In der Antwort zur ckgegebenes Feld Enth lt die Ssequenznummer der Transaktion Dieses Feld wird bei Barzahlung immer auf 1 gesetzt vads_payment_conf
77. chiedene lokale Pr fungen die direkt durch die Zahlungsplattform durchgef hrt werden dazu z hlen potenziell die Pr fungen in Verbindung mit der Anmeldung beim zus tzlichen Dienst f r Betrugsschutzkontrollen e Eine Autorisierungsanfrage wird au erdem an die Bank des K ufers gesendet Dies erfolgt am Tag des Zahlungsdatums unabh ngig vom angefragten Datum des Bank Kassenschnitts Wenn eine dieser Pr fungen scheitert wird der Zahlungsauftrag abgelehnt Der K ufer wird dar ber auf dem Bildschirm informiert Im Back Office kann die Transaktion mit dem Status Verweigert abgerufen werden Im umgekehrten Fall erh lt die Transaktion den Status Wartet auf Kassenschnitt Der K ufer wird ber die Annahme seines Zahlungsauftrags informiert und erh lt eine Best tigungs E Mail Der Kassenschnitt f r die Zahlung erfolgt zu dem vom H ndler angefragten Tag automatisch PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 13 W hrend er auf diesen Kassenschnitt wartet kann der H ndler das Datum des Kassenschnitts sowie den Betrag ndern der Betrag kann nur reduziert werden was einer Teillieferung durch den H ndler entspricht Bei Bedarf kann er die Transaktion auch stornieren diese erh lt dann den Status Storniert PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 14 Lebenszyklus einer Transaktion f r zeitverz gerte Barzahlung Zeitspanne f r Kassenschnitt k rzer als die G ltigkeitsdauer der Autori
78. ction https secure payzen eu vads payment gt lt input type hidden name vads action mode value INTERACTIVE gt lt input type hidden name vads amount value 4000 gt lt input type hidden name vads capture delay value 0 gt lt input type hidden name vads ctx mode value TEST gt lt input type hidden name vads currency value 978 gt lt input type hidden name vads_cust_country value DE gt lt input type hidden name vads_cust email value Zettl Rainer example com gt lt input type hidden name vads_cust_first_name value Rainer gt lt input type hidden name vads_cust_last_name value Zettl gt lt input type hidden name vads_cust title value M gt lt input type hidden name vads page action value PAYMENT gt lt input type hidden name vads payment config value SINGLE gt lt input type hidden name vads site id value 12345678 gt lt input type hidden name vads trans date value 20140327133115 gt lt input type hidden name vads trans id value 522754 gt lt input type hidden name vads version value V2 gt lt input type hidden name signature value 7896adcaf7338930db9715afal23531 f42 gt lt input type submit name bezahlen value Bezahlen gt lt Gosem PayZen 2 3 8 Verwenden von erg nzenden Funktionen 50 8 3 bermittlung der Lieferdaten Der H ndler kann die Lieferdaten
79. d1704ee gt lt INPUT lt form gt type submit nemem tibezaNnllenunealNeEen REME gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 67 8 11 Erstellen einer Zahlung ohne Weiterleitung zur Zahlungsseite Diese Funktionalit t erfordert die Aktivierung der Option Erfassung der Bankdaten In diesem Modus erfolgt die Erfassung der Bankdaten auf der Site des H ndlers Diese Funktionalit t e ist verf gbar wenn Ihre Bank die Eingabe der Bankdaten im Shop gestattet e erfordert mindestens die Verwendung eines SSL Zertifikats im Shop e gestattet es nicht Zahlungen mit der 3 D Secure Authentifizierung durchzuf hren Diese Funktion kann f r Zahlungen mit Weiterleitung wie die nachfolgend genannten nicht verwendet werden e PayPal PayPal sandbox e Oney e V me by Visa Cetelem Aurore e 3xCB Cofinoga 1 Verwenden Sie die nachstehenden Felder um Ihr Zahlungsformular zu erstellen Tabelle 14 Liste der Felder Erstellen einer Zahlung ohne Weiterleitung zur Zahlungsseite 2 F llen Sie die Felder vads_payment_config und vads_capture_delay gem Ihren Anforderungen aus 3 Setzen Sie das Feld vads_action_mode auf SILENT 4 Geben Sie in das Feld vads_currency den Code der gew nschten W hrung gem der W hrungstabelle ein Beispiel 978 f r Euro 840 f r US Dollar 5 Geben Sie in die Felder vads_card_number vads_expiry_month vads_expiry_year vads_cvv die Kartendaten ein die vom
80. dem Sie ihn mit dem Zeichen trennen In diesem Beispiel ist der Wert des Testzertifikats 1122334455667788 INTERACTIVE 1524 TEST 9783 PAYMENT SINGLE 12345678 20090501193530 654321 V2 1122334455667783 4 Wenden Sie den Algorithmus SHA 1 auf die erhaltene Verkettung an PayZen 2 3 9 Berechnen der Signatur 71 Folgendes Ergebnis muss in das Signaturfeld bertragen werden 606b369759fac4f0864144c803cC73676cbe470ff PayZen 2 3 9 Berechnen der Signatur 72 9 1 Beispiel einer JAVA Implementierung Definition eine Utility Klasse Sha die die erforderliche Konfiguration zur Verarbeitung des SHAI Algorithmus enth lt import java security MessageDigest import java security SecureRandonm publ e elass ionam statice public final string SEPARATOR WPW Publie starcie Scring encode String sre q tey i MessageDigest md md MessageDigest getInstance SHA 1 byte bytes zZ sre getbytes TUTE 2 7 md update bytes 0 bytes length byte shalhash md digest return ceonvertrolex shalhash Meatch kxzeeption e throw new RuntimeException e private static String eonvertTolex byte shalhash StringBuilder builder new StringBuilder tor int 1 0 1 lt shalnash lengra p trt 4 byte c shalhash i addHex builder c gt gt 4 amp Oxf addHexz b lder amp OKE return builder toString h private static void addHex StringBuilder Builder int c
81. den name vads payment eonrig value STNerkl gt lt input type hidden name vads_return _mode value GET gt lt input type hidden nee Ude vanme PEAS 2 pae e deea a Baron a a 0 oa e O lt input type hidden name vads trans id value 2398487 gt lt mpur eype lhidden nem _VvadsPurlFrerurn value Vmerp deme eem return php 7 pussy pe uhidde nsnem u vcder 2 son zer u 2 lt input type hidden name signature value 86b2al7b9a5fcefb6c0120c57b25ec86ad1704ee gt lt input lt keorm gt type submit names bezanlenl ina meS RBE aE PayZen 2 3 8 Verwenden von erg nzenden Funktionen 59 8 8 Aktivierung der automatischen R ckleitung zum Shop Der H ndler kann in seinem Formular angeben dass der K ufer zum Abschluss der Zahlung automatisch zum Shop umgeleitet werden soll Wenn Sie einen Tracking Code Google AnalyticsTM oder andere auf Ihrer Site verwenden m ssen Sie diese Funktionalit t implementieren 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Verwenden Sie die nachstehenden optionalen Felder gem Ihrem Bedarf Name des Feldes Beschreibung Legt die Wartezeit vor der Umleitung nach einer erfolgreichen Zahlung fest Diese Zeitspanne wird in Sekunden angegeben und muss zwischen O und 300 Sekunden liegen vads_redirect_success_message Legt die Wartemeldung vor der Umleitung
82. der Lieferdaten Adresse usw bermitteln der Informationen zur Bestellung Bestellnummer Inhalt des Einkaufskorbs usw e Aktivieren oder Deaktivieren von 3 D Secure e Festlegen des f r die Zahlung zu verwendenden H ndlervertrags e Personalisierung der Elemente der Zahlungsseite berschreiben der URL der sofortigen Best tigung auch als IPN bezeichnet e Verwaltung der Back URL zum Shop e Aktivierung der automatischen R ckleitung zum Shop zum Abschluss der Zahlung e Durchf hrung einer Zahlung ohne Weiterleitung zur Zahlungsseite Diese Funktionalit ten werden in den folgenden Kapiteln beschrieben Diese Kapitel erm glichen es Ihnen Ihr Zahlungsformular schnell und einfach zu erstellen PayZen 2 3 8 Verwenden von erg nzenden Funktionen 47 8 1 Festlegen des Modus f r den Bank Kassenschnitt automatisch manuell Der H ndler kann im Back Office einstellen wie Zahlungen an die Bank gesendet werden Men Einstellung gt Shop gt Registerkarte Einstellungen F Einstellungen a Einstellung der MOTO Zahlung Fj Individuelle Gestaltung Ei Fortgeschrittene Personalisierung Zertifikate ie Vertr ge Tp Einzelheiten Shop ID 91335531 Name Lyra SMS URL http www Iyra sms com Zeitspanne vor Kassenschnitt 0 Tagle Best tigungsmodus Im Falle einer Zahlungsverweigerung Automatisch rsuchle autorisieren Manuell Appeler URL serweur chaque tentative refusee Abbildung 20
83. der Zahlungsseite und in den E Mails f r die Zahlungsbest tigung angezeigt wird Mit diesem Parameter k nnen Sie den Standardwert Ihres Shops ndern ans 127 73 Personalisierung der Zahlungsseite E vads site _id Beschreibung Format Fehlercode Kategorie E vads_subscription Beschreibung Format Fehlercode Kategorie PayZen 2 3 16 Datenlexikon 145 Pflichtparameter Bei der Registrierung an der Zahlungsplattform generierter Wert Der Wert kann von allen befugten Personen auf der Benutzeroberfl che des Back Office im Men Optionen gt Shop gt Zertifikate eingesehen werden Sollte der Wert nicht korrekt sein wird dem K ufer bei der Zahlung eine Fehlermeldung in seinem Browser angezeigt Die Zahlung kann dann nicht durchgef hrt werden und die Transaktion wird endg ltig abgebrochen In diesem Fall wird eine E Mail Warnmeldung an den administrativen Kontakt des Shops gesendet Sie enth lt das Formular das die Plattform mit dem Wert der Signatur nicht bearbeiten konnte n8 02 Technische Informationen Optionaler Parameter der bei der Erstellung einer Ratenzahlung verwendet wird Er gibt die Kennung der zu erstellenden Ratenzahlung an Zwei Optionen sind m glich e Die Verwaltung dieser Kennungen kann an die Plattform delegiert werden In diesem Fall braucht dieser Parameter nicht angegeben zu werden Wenn die Ratenzahlung erfolgreich erstellt wird enth lt die Antwort den von der
84. des K ufers E Mail Adresse Anrede Telefonnummer usw bermitteln Diese Daten werden im Back Office angezeigt indem die Einzelheiten der Transaktion abgerufen werden Registerkarte Lieferung 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Verwenden Sie die nachstehenden optionalen Felder gem Ihrem Bedarf Diese Felder werden in der Antwort mit dem Wert zur ckgegeben der im Formular bermittelt wurde Name des Feldes vads_ship_to_status vads_ship_to_name vads_ship_to_first_name vads_ship_to_last_name vads_ship_to_phone_num vads_ship_to_street_number vads_ship_to_street vads_ship_to_street2 vads_ship_to_district vads_ship_to_zip vads_ship_to_city vads_ship_to_state vads_ship_to_country Tabelle 10 Liste der Felder Details zur Lieferung 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit Informationen zur Lieferung lt form method POST action https secure payzen eu vads payment gt lt input type hidden name vads action mode value INTERACTIVE gt lt input type hidden name vads amount value 4000 gt lt input type hidden name vads capture delay value 0 gt lt input type hidden name vads ctx mode value TEST
85. dieser Parameter nicht angegeben zu werden e Alternativ kann diese Sitzungskennung vom Shop erzeugt werden In diesem Fall ist der Parameter mit dem gew nschten Wert der Kennung anzugeben Die Eindeutigkeit der Kennungen ist vom Shop sicherzustellen Alle Registrierungsanfragen die eine bereits vorhandene Kennung enthalten werden zur ckgewiesen und f hren zur Anzeige einer Fehlermeldung String Cod sur 128 octets peut tre compos de majuscules ou de minuscules chiffres ou tiret A Z a z 0 9 _ Informationen zum K ufer E vads ext info ship _address_complement Beschreibung Format Kategorie Spezifisch f r Brasilien und den Betrugsschutzanbieter ClearSale Erm glicht einen Adresszusatz f r die Lieferung anzugeben ans 250 Informationen zur Lieferung PayZen 2 3 16 Datenlexikon 119 E vads ext info_ship_date_of_birth Beschreibung Format Kategorie Spezifisch f r Brasilien und den Betrugsschutzanbieter ClearSale Erm glicht f r die Lieferung das Geburtsdatum des K ufers anzugeben Datetime Informationen zur Lieferung E vads ext info _ship_gender Beschreibung Format Kategorie Spezifisch f r Brasilien und den Betrugsschutzanbieter ClearSale Erm glicht f r die Lieferung das Geschlecht des K ufers anzugeben n1 Informationen zur Lieferung E vads ext info donation Beschreibung Format Kategorie Parameter wird nur im Fall einer Spende in d
86. ds_language einen der Werte aus der folgenden Tabelle ein Deutsch Englisch Chinesisch Spanisch Franz sisch Italienisch Japanisch Niederl ndisch Polnisch Portugiesisch Russisch Schwedisch T rkisch Sprache ISO 639 1 Codierung Ip IN Io SIol 5 gt eis u lt ec o EE Japanisch S P Niederl ndisch o O T rkish o E O e Wenn der Wert des Feldes vads_language fehlerhaft ist wird das Formular zur ckgewiesen e Wenn das Feld nicht gesendet oder leer gelassen wird wird die Zahlungsseite in der Sprache des Browsers des K ufers angezeigt e Der K ufer kann die Sprache jederzeit ndern indem er auf eine der Flaggen klickt die im unteren Bereich der Zahlungsseite angezeigt werden 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit einer Liste f r die Sprachenauswahl lt form method POST action https secure payzen eu vads payment gt lt impnt lt input lt input lt 1NPUT lt input lt input lt INPUT lt 1mputT lt input lt inp T lt input lt input lt input lt LMOuUT lt form gt type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type submit name vads action mode valu
87. e INTERACTIVE gt name vads amount value 3000 gt name vads capture delay value 0 gt name vads ctx mode value TEST gt name vads currency value 978 gt name vads language value fr en gt name vads page action value PAYMENT gt name vads payment config value SINGLE gt name vads site id value 12345678 gt name vads trans date value 20140526101407 gt name vads trans id value 239848 gt name vads version value V2 gt name signature value 86b2al7b9a5fcefb6c0120c57b25ec86ad1704ee gt name bezahlen value Bezahlen gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 63 ndern der Sprachen die dem K ufer angeboten werden Sie k nnen die Liste der Sprachen die dem K ufer angeboten werden personalisieren Die letzte vom K ufer ausgew hlte Sprache ist die Standardsprache der Zahlungsbest tigungs E Mail die an den K ufer gesendet wird 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 F llen Sie das Feld vads_available_languages anhand der folgenden Tabelle aus e mit nur einem Wert wenn Sie nicht w nschen dass der K ufer die Sprache ndert e mit einer durch ein Semikolon getrennten Liste von Werten um die verf gbaren Sprachen aufzulisten Sprache Wet _ Steandardm fiig angezeigte Flagge e S Po Deutsch Englisch
88. e setzen Sie das Feld auf 1 Der Best tigungsmodus gilt f r alle Raten Setzen Sie das Feld vads_validation_mode f r eine automatische Best tigung der Bank Kassenschnitt f r die Zahlung erfolgt automatisch auf 0 Geben Sie in das Feld vads_currency den Code der gew nschten W hrung gem der W hrungstabelle ein Beispiel 978 f r Euro 840 f r US Dollar F gen Sie optionale Felder gem Ihren Anforderungen hinzu siehe Kapitel Verwenden von erg nzenden Funktionen Berechnen Sie den Wert des Feldessignature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur iel eines Zahlungsformulars f r Ratenzahlun Feste Betr ge und Ratenf lligkeiten lt form method POST action https secure payzen eu vads payment gt lt input type hidden name vads action mode value INTERACTIVE gt lt input type hidden name vads amount value 3000 gt lt input type hidden name vads ctx mode value TEST gt lt input type hidden name vads currency value 978 gt lt input type hidden name vads page action value PAYMENT gt lt input type hidden name vads payment config value MULTI first 1000 count 3 period 30 gt lt input type hidden name vads site id value 12345678 gt lt input type hidden name vads trans date value 20140129180150 gt lt input type hidden name vads trans id value 180150 gt lt inp
89. e vads ctx mode value TEST gt name vads currency value 978 gt name vads order id value CD100000858 gt Dame a a e ae a E name vads payment config value SINGLE gt name vads site id value 12345678 gt name vads_ theme config MSG_ RETURN Stornieren SUCCESS_FOOTER _MSG RETURN Zur ck gt lt input Ee maaa E a value 20140331092024 gt lt input type hidden lt input type hidden lt input type hidden lt input type submit lt form gt name vads trans id value 408248 gt name vads version value V2 gt name signature value a88c7380d4165e49d5cb61c3408E20800c697b03fd gt name bezahlen value Bezahlen gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 66 8 10 ndern der URL zur sofortigen Zahlungsbest tigung IPN Sie k nnen die URL der sofortigen Best tigung auch als IPN bezeichnet im Formular berschreiben sofern Sie einen Shop f r verschiedene Verkaufskan le unterschiedliche Zahlungsmethoden unterschiedliche Sprachen usw verwenden Diese Funktionalit t ist nicht kompatibel mit der Ausf hrung der an die URL zur sofortigen Zahlungsbest tigung gesendeten Anforderung ber das Back Office Es wird die URL aufgerufen die in der Benachrichtigungsregel angegeben ist siehe Kapitel Benachrichtigungseinstellungen 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zah
90. e Aktivieren des automatischen Neuversuchs e Manueller Neuversuch zum Senden der Benachrichtigung Erg nzende Informationen zur Nutzung von i Frames Datenlexikon e Hinzuf gen von Feldern e vads_payment_seq e vads_cust_legal name e vads_ship_to_legal_ name e Hinzuf gen des Wertes E_CV in der Liste der Zahlungsmittel ANCV Netz e Erg nzende Erl uterung des Feldes vads_url_check 21 11 2014 Vollst ndige berarbeitung der Dokumentation Vertraulichkeit Alle Informationen in diesem Dokument gelten als vertraulich Die Nutzung dieser Informationen au erhalb dieser Beratung oder deren Weitergabe an Dritte erfordert die vorherige Zustimmung von Lyra Network PayZen 2 3 2 Kontaktieren des technischen supports 5 l2 KONTAKTIEREN DES TECHNISCHEN SUPPORTS Bei Problemen beim Einloggen in das Back Officeverwenden Sie den Link Passwort vergessen oder Konto blockiert F r technische Fragen oder Supportanfragen steht unser Kundendienst Ihnen montags bis freitags von 9 bis 18 Uhr zur Verf gung telefonisch unter 33 820 902 103 ou 49 0 69 59 77 17 27 pour joindre la Hotline per E Mail support payzen eu Um die Bearbeitung Ihrer Anfragen zu vereinfachen geben Sie bitte Ihre Shop ID an 8 stellige Nummer Diese Nummer finden Sie in der Anmeldungs E Mail f r Ihren Shop oder im Back Office Men Einstellung gt Shop gt Einstellungen PayZen 2 3 3 Die verschiedenen Zahlungsarten 6 3 DIE VERSCHIEDENE
91. e eine UTC Zeit erzeugen z B gmdate in PHP e Die Uhrzeit muss im 24 Stunden Format und nicht im 12 Stunden Format berechnet werden e Der K ufer hat zu lange gewartet bevor er auf die Schaltfl che Bezahlen geklickt hat e Der K ufer hat den Verlauf seines Browsers verwendet Kategorie Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 154 E vads_trans_id Beschreibung Dieser Wert besteht aus 6 numerischen Zeichen und muss f r jede Transaktion eindeutig sein die f r einen Shop an einem Tag durchgef hrt wird Es obliegt dem Shop die Eindeutigkeit ber den Tag hinweg zu gew hrleisten Der Wert muss zwischen 000000 und 899999 liegen Der Bereich von 900000 bis 999999 ist nicht zul ssig Format n6 Fehlercode 03 H ufige Fehler Das Formular wird abgelehnt e wenn der bermittelte Wert weniger als 6 Zahlen umfasst e wenn der Wert gleich Null ist e wenn das Feld nicht vorhanden ist e wenn am selben Tag bereits eine identische Transaktionsnummer gesendet wurde Wenn der K ufer auf die Schaltfl che L schen und zur ck zum Shop klickt wird f r den n chsten Versuch eine andere Transaktionsnummer verwendet da die vorherige als bereits verwendet gilt Andernfalls wird die Meldung Die Transaktion wurde storniert angezeigt Kategorie Informationen zur Transaktion E vads trans status Beschreibung Format M gliche Werte Kategorie PayZen 2 3 16 Datenlexikon 1
92. ebseite in einer anderen Webseite anzuzeigen In der Standardeinstellung ist die Nutzung von i Frames zur Anzeige der Zahlungsseite aus Sicherheitsgr nden nicht aktiviert Es ist jedoch m glich die Nutzung von i Frames zu aktivieren Sollten Sie i Frames nutzen wollen wenden Sie sich bitte an den f r Ihre Zahlungsplattform zust ndigen Ansprechpartner Code Beispiele lt FRAMESET gt lt FRAME SRC https secure payzen eu vads payment gt lt FRAMESET gt lt iframe src https secure payzen eu vads payment gt lt iframe gt PayZen 2 3 5 Einrichten des Dialogs mit der Zahlungsplattform 27 5 6 Verwalten der Parameter Ihres Shops mit einer Konfigurationsdatei Mit einer Konfigurationsdatei wird vermieden dass Werte hart in den Code eingef gt werden Konfigurationsdateien k nnen folgende Elemente enthalten e URL der Zahlungsseite e Wert des Zertifikats e Wert der Kennung des Shops e USW Die Dateien erm glichen die Typisierung der zu speichernden Daten Das Programm in dem das Zahlungsformular erzeugt wird ruft die Konfigurationsdatei mit dem Parameter zur Verwendung des Wertes auf Der H ndler muss Folgendes tun e die mit der Datei verbundenen Rechte festlegen damit nicht von au en auf die Datei zugegriffen werden kann e die Besonderheiten der verwendeten Programmiersprache ber cksichtigen Beispiel f r eine Konfigurationsdatei conf txt vads site ic 11111111 TEO TI kO E T PROP
93. egisterkarte Einkaufskorb 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Verwenden Sie die nachstehenden optionalen Felder gem Ihrem Bedarf Diese Felder werden in der Antwort mit dem Wert zur ckgegeben der im Formular bermittelt wurde vads_product_labelN Name des Artikels N entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw vads_product_amountN Betrag des Artikels N entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw vads_product_typeN Typ des Artikels N entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw vads_product_refN Bestellnummer des Artikels N entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw vads_product_qtyN Menge des Artikels N entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw Tabelle 11 Liste der Felder Details zur Bestellung 3 Geben Sie in das Feld vads_nb_product die Anzahl der Artikel im Einkaufskorb ein Dieses Feld ist ein Pflichtfeld damit der Einkaufskorb ber cksichtigt wird 4 Geben Sie in das Feld vads_product_amountN den Betrag f r die verschiedenen Artikel im Einkaufskorb in der kleinsten Einheit der W hrung ein 0 entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw 5 Geben Sie in das Feld vads_prod
94. eitspanne in Sekunden vor der Weiterleitung zum Shop zum Abschluss einer angenommenen Zahlung Der Wert betr gt von O bis 600 s vads_return_mode GET POST Erm glicht die Angabe der Methode zur bertragung von Daten an NONE die URLs die bei der R ckkehr zum Shop verwendet werden vads_url_cancel ans 127 URL an die der K ufer weitergeleitet wird wenn er auf L schen und zur ck zum Shop klickt bevor er die Zahlung get tigt hat vads_url_check ans 127 URL der nach Abschluss der Zahlung zu benachrichtigenden Site ndert den in den Einstellungen f r die Benachrichtigungsregeln eingegebenen Wert vads_url_check_src string enum Dieser Parameter legt das ausl sende Ereignis f r die sofortige Zahlungsbest tigung fest auch als IPN oder URL der Benachrichtigung bezeichnet vads_url_error ans 127 URL an die der K ufer im Fall eines internen Verarbeitungsfehlers weitergeleitet wird vads_url_refused ans 127 URL an die der K ufer im Fall einer Verweigerung weitergeleitet wird vads_url_return ans 127 Standard URL zu der der K ufer weitergeleitet wird wenn er auf Zur ck zum Shop klickt URL an die der K ufer im Erfolgsfall weitergeleitet wird Tabelle 38 Parameterliste Weiterleitung zum Shop PayZen 2 3 16 Datenlexikon 100 E Informationen zur Ratenzahlung u nn L vads_identifier_status Erfassungsstatus des Mandats vads_recurrence_status Status der Einrichtung einer Rekursion vads_su
95. en Beispiel Bei einem Betrag von 10 Euro und 28 Cent ist der Wert des Parameters 1028 Format n 12 Fehlercode 66 Kategorie Informationen zur Ratenzahlung E vads sub_init amount number Beschreibung Optionaler Parameter der bei der Erstellung einer Ratenzahlung verwendet wird Gibt die Anzahl von Raten an auf die der Betrag vads_sub_init_amount anzuwenden ist Wenn diese Anzahl von Raten berschritten ist wird der Betrag vads_sub_amount verwendet Beispiel Um eine Ratenzahlung mit drei Raten von 25 Euro und weiteren Raten von 30 Euro festzulegen werden die folgenden Werte verwendet e vads_sub_currency 978 e vads_sub_init_amount_number 3 e vads_sub_init_amount 2500 e vads_sub_amount 3000 Format N 3 Code erreur 68 Kategorie Informationen zur Ratenzahlung PayZen 2 3 16 Datenlexikon 149 E vads tax amount Beschreibung Parameter der es erm glicht den Betrag der Steuern f r die gesamte Bestellung festzulegen Der Wert muss in der kleinsten W hrungseinheit ausgedr ckt werden Cent im Fall des Euro Spezifisch f r das Zahlungsmittel PayPal Format n 12 Kategorie Informationen zur Bestellung u vads theme_config Beschreibung Erm glicht bestimmte Elemente der Zahlungsseite zu personalisieren Logos Banner und bestimmte Meldungen Einige Funktionalit ten erfordern die kommerzielle Option Dieser Parameter enth lt eine Liste von Schl sselw rtern Codes die mit Elementen der
96. enthaltenen Artikel festzulegen N entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw Format an 127 Kategorie Informationen zur Bestellung E vads product qtyN Beschreibung Erm glicht die Menge f r jeden der Artikel im Einkaufskorb festzulegen N entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw Format n 12 Kategorie Informationen zur Bestellung E vads product _refN Beschreibung Erm glicht eine Bestellnummer f r jeden der Artikel im Einkaufskorb anzugeben N entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw Format an b4 Kategorie Informationen zur Bestellung PayZen 2 3 16 Datenlexikon 135 E vads product _typeN Beschreibung Erm glicht den Typ des im Einkaufskorb enthaltenen Artikels anzugeben N entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw Format string enum M gliche Werte wa TBeschreibung Tabelle 41 Werte in Verbindung mit vads_product typeO Kategorie Informationen zur Transaktion E vads recurrence status Beschreibung In der Antwort zur ckgegebenes Feld Status der Ratenzahlung Nur vorhanden wenn die angeforderte Aktion der Erstellung einer Ratenzahlung entspricht REGISTER_SUBSCRIBE SUBSCRIBE REGISTER_PAY_SUBSCRIBE Format string MED ON Die Einzelheiten der Ratenzahlung werden im Back Office angezeigt angezeigt ABANDONED Die Anford
97. er CANCELED IPN nach Aktion im Back Office a AUTHORIZED_TO_VALIDATE Antwort auf die Autorisierungsanfrage AUTHORIZED REFUSED IPN am Ende der Zahlung Tabelle 1 Benachrichtigungsregeln die bei einer sofortigen Barzahlung zu aktivieren sind PayZen 2 3 6 Benachrichtigungseinstellungen 29 6 2 Benachrichtigungen ber die verschiedenen Statuswerte bei einer zeitverz gerten Barzahlung hr sazcasenensnn Aufgabe ABANDONED Durchf hrung der Zahlung Autorisierung f r 1 Anfrage angenommen Anfrage verweigert CANCELED A Wstomieru ng WAITING_ AUTHORIZATION_ CANCELED TO_VALIDATE WAITING_ AUTHORIZATION T x vor dem angefragten T x vor demangefragten Datum des Datum des Bank Kassenschnitts Bank Kassenschnitts Zahlung verweigert Autorisierungsanfrage Automatische Best tigung JA Stornierung CANCELED AUTHORIZED_ TO_VALIDATE AUTHORIZED Zahlung angenommen Stornierung CANCELED Best tigung des H ndlers Bank Kassenschnitt der Zahlung JA R ckerstattu ng NEIN Verfall der Zahlung AUTHORIZED Neue Transaktion Abbildung 13 Flussdiagramm Zeitverz gerte Barzahlung A G ltigkeitsdauer der Autorisierung Ereignis bermittelter Status Name der zu konfigurierenden Regel Abbruch durch den K ufer ABANDONED IPN bei Stornierung Stornierung durch den H ndler CANCELED IPN nach Aktion im
98. er R ckleitung zum Shop Zum Abschluss der Zahlung hat der K ufer die M glichkeit auf eine Seite des Shops zur ckzukehren die als Back URL bezeichnet wird Diese sollte nicht mit der URL der sofortigen Best tigung auch als IPN bezeichnet verwechselt werden siehe Kapitel Verwalten des Dialogs mit der H ndler Website Festlegen der Back URL Im Zahlungsformular kann der H ndler die Einstellungen aus dem Back Office ndern Zu diesem Zweck kann er e 4Averschiedene URL abh ngig vom Ergebnis der Zahlung verwenden e Zahlung angenommen e Zahlung verweigert e Zahlung abgebrochen e Irrt mliche Zahlung e Verwenden Sie unabh ngig vom Ergebnis der Zahlung immer nur eine URL Festlegen der Back URL abh ngig vom Ergebnis der Zahlung 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Verwenden Sie die optionalen Felder in der nachstehenden Tabelle um das Zahlungsformular nach Ihren Erfordernissen zu entwerfen Wenn im Formular keine URL angegeben ist wird der im Back Office konfigurierte Wert ber cksichtigt Name des Feldes Beschreibung vads_url_success vads_url_refused URL an die der K ufer im Fall einer erfolgreichen Zahlung weitergeleitet wird nachdem er auf Zur ck zum Shop geklickt hat URL an die der K ufer im Fall einer Ablehnung der Zahlung weitergeleitet wird nachdem er auf Zur
99. er sofortigen Zahlungsbest tigung auch als IPN bezeichnet zur ckgesendet Spendenbetrag in der kleinsten W hrungseinheit Cent beim Euro n 12 Informationen zu Spendenzahlungen E vads ext info donation recipient Beschreibung Format Kategorie Parameter wird nur im Fall einer Spende in der sofortigen Zahlungsbest tigung auch als IPN bezeichnet zur ckgesendet HelloAsso Kennung der Organisation die die Spende erhalten hat n 20 Informationen zu Spendenzahlungen PayZen 2 3 16 Datenlexikon 120 E vads ext info donation recipient name Beschreibung Format Kategorie Parameter wird nur im Fall einer Spende in der sofortigen Zahlungsbest tigung auch als IPN bezeichnet zur ckgesendet Name der Organisation die die Spende erhalten hat string Informationen zu Spendenzahlungen E vads ext info donation merchant Beschreibung Format Kategorie Parameter wird nur im Fall einer Spende in der sofortigen Zahlungsbest tigung auch als IPN bezeichnet zur ckgesendet Kennung des Shops in dem die Spende erfolgt n8 Informationen zu Spendenzahlungen E vads ext info donation contribution Beschreibung Format Kategorie Parameter wird nur im Fall einer Spende in der sofortigen Zahlungsbest tigung auch als IPN bezeichnet zur ckgesendet Betrag in Cent des Betrags in der kleinsten W hrungseinheit Cent beim Euro n 12 Informationen zu Spendenzahlungen E v
100. erfolgreich durchgef hrt wurde Format an40 Kategorie Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 127 E vads payment config Beschreibung Bezeichnet die Zahlungsart bar oder Ratenzahlung e F r eine einzelne Zahlung muss der Wert SINGLE sein e F r eine Ratenzahlung mit festen Betr gen und Daten muss der Wert MULTI sein gefolgt von Schl sselpaaren durch Semikolon getrennte Werte Die Parameter sind wie folgt e first gibt den Betrag der ersten Zahlung an in der kleinsten W hrungseinheit e count gibt die Gesamtzahl der Raten an e period gibt das Intervall als Anzahl von Tagen zwischen 2 Zahlungen an Die Reihenfolge der Felder f r MULTI ist festgelegt e F r eine Ratenzahlung mit personalisierten Raten muss der Wert MULTI_EXT sein gefolgt von Schl sselpaaren durch Semikolon getrennte Werte Die Daten d rfen nicht in der Vergangenheit liegen Die Verwendung des Wertes MULTI_EXT erfordert die Aktivierung der Option Erweiterte Ratenzahlung Format string enum Fehlercode 07 M gliche Werte e SINGLE e MULTI first erster_Betrag Anzahl Anz_Raten Zeitraum Intervall_in_Tagen e MULTI_EXT Datumi Betragl1 Datum2 Betrag2 Datum3 Betrag3 Beispiel 1 MULTI erm glicht die Festlegung einer Zahlung in mehreren Raten Der Betrag jeder Rate entspricht dem Gesamtbetrag geteilt durch die Anzahl von Raten Der Wert des ersten Betrages kann abweichen und
101. ertrauen des K ufers bei der Weiterleitung zur Zahlungsabwicklung N here Informationen finden Sie im Benutzerhandbuch f r die erweiterte Personalisierung das Sie auf der Dokumentationswebsite unter https www de payzen eu payzen dokumente finden Verwalten der Zahlungsmittel die dem K ufer angeboten werden Sie k nnen die Zahlungsmittel personalisieren die dem K ufer angeboten werden 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 F llen Sie das Feld vads_payment_cards anhand der folgenden Tabelle aus e mit nur einem Wert wenn die Seite f r die Auswahl der Zahlungsmittel nicht angezeigt werden soll e miteiner Liste von Werten die durch ein Semikolon getrennt sind um die Seite f r die Auswahl der Zahlungsmittel anzuzeigen CDGP Privilege Karte CB PayZen 2 3 8 Verwenden von erg nzenden Funktionen 61 IDEAL ILLICADO ILLICADO_SB JCB JOUECLUB_CDX JOUECLUB_CDX_SB JULES_CDX JULES_CDX_SB MAESTRO MASTERCARD ONEY ONEY_SANDBOX PAYLIB PAYPAL PAYPAL_SB PAYSAFECARD POSTFINANCE POSTFINANCE_EFIN S MONEY SCT SDD SOFORT_BANKING TRUFFAUT _CDX V_ME VISA VISA_ELECTRON ECCARD IDEAL 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit e
102. erung f r die Einrichtung der Ratenzahlung wurde vom K ufer abgebrochen Debitor Die Ratenzahlung wurde nicht erstellt und wird nicht im Back Office angezeigt Kategorie Informationen zur Ratenzahlung PayZen 2 3 16 Datenlexikon 136 u vads redirect_error_ message Beschreibung Erm glicht die Festlegung der Meldung im Fall einer verweigerten Zahlung bei einer automatischen Weiterleitung zum Shop Format ans 255 Fehlercode 37 Kategorie Weiterleitung zum Shop E vads redirect _error timeout Beschreibung Erm glicht die Festlegung einer Zeitspanne in Sekunden vor der Weiterleitung zum Shop beim Abschluss einer verweigerten Zahlung Der Wert betr gt von 0 bis 600s Nach Ablauf dieser Zeitspanne wird der K ufer zu der im Feld vads_url_refusal angegebenen URL weitergeleitet Ist das Feld nicht ausgef llt wird der K ufer zu der im Feld vads_url_return angegebenen Back URL oder zu der im Back Office angegebenen URL weitergeleitet Ist keine Back URL definiert wird er zur URL des Shops weitergeleitet Format n 3 Fehlercode 36 Kategorie Weiterleitung zum Shop E vads redirect _success_message Beschreibung Erm glicht die Festlegung der Meldung im Fall einer angenommenen Zahlung bei einer automatischen Weiterleitung zum Shop Format ans 255 Fehlercode 35 Kategorie Weiterleitung zum Shop E vads redirect _success_timeout Beschreibung Erm glicht die Festlegung einer Zeitspanne in Sekunden vor der Weiterle
103. ge zur ckweisen Die Best tigung der 1 Rate gilt f r alle folgenden Raten Die Stornierung einer Rate hingegen f hrt nicht zur Stornierung der folgenden Raten Wartet auf Zu autorisieren f Best tigung Best tigung und Stornierung Storniert Autorisierung T xvor dem T xvor dem angefragten Datum angefragten Datum des Bank Kassenschnitts des Bank Kassenschnitts Autorisierungs KO Verweigert KO Autorisierungs anfrage anfrage OK Autorisierung angenommen Frist Verfallen abgelaufen Zu best tigen Stornierung OK Autorisierung angenommen Vaesistigung Stornierung Wartet auf Kassenschnitt Am Tag des angefragten Bank Kassenschnitts Vorgelegt PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 20 Besonderheiten in Verbindung mit Autorisierungen im Voraus Um Autorisierungen im Voraus zu aktivieren wenden Sie sich an den Kundendienst der Zahlungsplattform Dieser Prozess gilt nur f r Autorisierungsanfragen e f r eine zeitverz gerte Barzahlung e f r andere Raten als die erste bei Ratenzahlungen Die Ausl sung der Autorisierung erfolgt an T A siehe Tabelle zur G ltigkeit einer Autorisierung f r jedes Zahlungsmittel vor dem gew nschten Datum des Bank Kassenschnitts Im Fall einer Zur ckweisung durch den Autorisierungsserver der Bank des K ufers ausschlie lich aus Gr nden ohne Betrugsabsicht siehe Tabelle wiederholt ein Prozess automatisch die Autorisie
104. hmen berschritten Nicht honorieren Verfalldatum der Karte berschritten 07 Karte aufbewahren besondere JA Falscher PIN Code Bedingungen os Nach Identifizierung genehmigen o CH Karte nicht in Datei 12 Ung ltige Transaktion JA 57 Transaktion f r diesen Inhaber nicht JA zul ssig Ung ltiger Betrag Transaktion f r diesen Inhaber nicht zul ssig 114 Ung ltige Inhabernummer Inhabernummer 59 Betrugsverdacht 000000 e preiti haberme unbekannt ge gg muss den Acquirer kontaktieren Stornierung durch K ufer Abhebungsbetrag au erhalb des Limits Transaktion sp ter wiederholen CE Sicherheitsregeln nicht eingehalten Fehlerhafte Antwort Fehler in Antwort nicht erfolgt oder zu sp t Serverdom ne empfangen Dateiaktualisierung nicht unterst tzt 75 Anzahl von Eingabeversuchen f r PIN Code berschritten Registrierung kann in Datei nicht 76 Inhaber bereits gesperrt alte JA gefunden werden Registrierung beibehalten Doppelte Registrierung alte Vor bergehender Systemausfall Registrierung ersetzt 27 edit Fehler in Feld in aktueller 91 Kartenaussteller nicht zug nglich Dateiliste 28 0 Zugriff auf Datei untersagt a Du Doppelte Transaktion nn 29 Aktualisierung nicht m glich He Fehlfunktion des Systems nn 30 Formatfehler 197 Ablauf der globalen berwachung EN LEE ee Acquirer Organisation EL nicht verf gbar unbekannt Netzwerkrouting erneut angefordert Verfallda
105. i der Erstattung dieser Transaktion ist ein Fehler aufgetreten wi Ung ltiger Kartentyp F r diesen Vertrag wurde keine Zahlungsoption aktiviert F r diese Zahlung wurde kein Vertrag gefunden Bei der Berechnung des Zahlungskanals ist ein ndern Sie die Daten oder wenden Sie sich Fehler aufgetreten an Ihren Projektmanager wenn das Problem fortbesteht 22 Shop nicht gefunden 93 Bei der R ckleitung des K ufers zur Zahlungsabschlussseite ist ein Fehler aufgetreten Vertrag nicht eindeutig Ein technischer Fehler ist aufgetreten 24 Ung ltiger Vertrag 95 Aufgrund einer technischen St rung k nnen wir Ihre Anforderung nicht verarbeiten 25 Aufgrund einer technischen St rung k nnen wir Beim Kassenschnitt f r diese Transaktion ist ein Ihre Anforderung nicht verarbeiten Fehler aufgetreten Ung ltige Kartennummer Datum des Kassenschnitts zu weit entfernt PayZen 2 3 16 Datenlexikon 130 Fehlerco Fehlermeldung Fehlerco Fehlermeldung Ung ltige Kartennummer 98 Ung ltiges Transaktionsdatum 28 Ung ltige Kartennummer Bei der Berechnung der Herkunft der Zahlung ist ein Fehler aufgetreten Ung ltige Kartennummer Kontrolle der Firmenkarte fehlgeschlagen Ung ltige Kartennummer Luhn Verweigert da erste Rate verweigert Ung ltige Kartennummer L nge Der Vorgang wurde von Buyster verweigert 32 Ung ltige Kartennummer nicht gefunden 103 Der Status der Transaktion konnte nicht mit dem externen Syste
106. icher und Sie k nnen mit der Analyse fortfahren e andernfalls muss das Skript einen Ausnahmefehler ausgeben und den H ndler ber die Anomalie informieren siehe Kapitel Fehlerbehandlung Die Signaturen stimmen in folgenden F llen nicht berein e bei Implementierungsfehlern Fehler in Ihrer Berechnung Problem mit UTF8 Codierung usw PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 78 e bei Fehlern in Bezug auf den Wert des verwendeten Zertifikats oder des Feldes vads_ctx_mode h ufiges Problem beim Wechsel in die Produktion e bei versuchter Besch digung der Daten PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 79 11 4 Analyse der Art der Benachrichtigung Im Feld vads_url_check_sre k nnen die Benachrichtigungen abh ngig vom ausl senden Ereignis differenziert werden e Erstellung einer Transaktion e R cksendung der Benachrichtigung durch den H ndler vom Back Office aus Es gibt die angewendete Benachrichtigungsregel an Angewendete Regel PAY Der Wert PAY wird in den folgenden F llen versendet e Sofortige Zahlung Barzahlung oder erste Rate einer Ratenzahlung e Zeitverz gerte Zahlung in weniger als 7 Tagen nur wenn der H ndler die Regel URL der Benachrichtigung bei Abschluss der Zahlung konfiguriert hat Zahlung durch den K ufer abgebrochen oder storniert nur wenn der H ndler die Regel URL der Benachrichtigung bei Stornierung konfiguriert hat Ausf hrung der Benachrichtigung
107. ie en Abbildung 18 Konfigurieren der Benachrichtigung bei Stapelautorisierung 6 F llen Sie das Feld E Mailadresse n zur Fehlermeldung aus 7 Um mehrere E Mail Adressen anzugeben trennen Sie sie durch ein Semikolon 8 Konfigurieren Sie den Automatischen Neuversuch im Falle eines Scheiterns Mit dieser Option wird die Benachrichtigung im Falle eines Scheiterns automatisch bis zu vier Mal an den Shop gesendet PayZen 2 3 6 Benachrichtigungseinstellungen 34 Ausf hrlichere Informationen entnehmen Sie bitte dem Kapitel Aktivieren des automatischen Neuversuchs 9 Speichern Sie Ihre nderungen 10 Aktivieren Sie die Regel indem Sie mit der rechten Maustaste auf IPN bei Autorisierung durch batchn und w hlen Sie Aktivieren Wenn die Plattform die URL Ihrer Seite nicht erreichen kann wird eine E Mail an die in Schritt 6 angegebene Adresse gesendet Sie enth lt den HTTP Code des aufgetretenen Fehlers e vom Fehler abh ngige Analyseelemente e Informationen ber das Verfahren das vom Back Office auszuf hren ist um die Anfrage wieder auf die in Schritt 5 definierte URL zur ckzuleiten PayZen 2 3 6 Benachrichtigungseinstellungen 35 6 6 Konfigurieren der Benachrichtigung im Fall eines Abbruchs einer Stornierung Die Zahlungsplattform kann den Shop systematisch informieren e Im Fall eines Abbruchs einer Stornierung durch den K ufer ber die Schaltfl che L schen und zur ck zum Shop e Wenn der K
108. ig SINGLE F r Ratenzahlung erh lt das Feld den Wert 1 f r die erste Rate den Wert 2 f r die zweite Rate den Wert 3 f r die dritte Rate usw Kategorie Informationen zur Transaktion E vads ship_to_city Beschreibung Erm glicht die Stadt des K ufers anzugeben Format an 128 Fehlercode 83 Kategorie Informationen zur Lieferung PayZen 2 3 16 Datenlexikon 141 E vads ship to country Beschreibung Erm glicht die Angabe des L ndercodes des K uferlands gem Norm ISO 3166 Format a2 Fehlercode 86 M gliche Werte BRASILIEN KORSIKA FRANKREICH GUADELOUPE MARTINIQUE NEUKALEDONIEN ST PIERRE UND MIQUELON FRANZ SISCH POLYNESIEN Kategorie Informationen zur Lieferung E vads ship to delivery_company_ name Beschreibung Erm glicht den Namen des Versandunternehmens anzugeben Format ans 127 Fehlercode 96 Kategorie Informationen zur Lieferung E vads ship to district Beschreibung Erm glicht den Bezirk anzugeben Format ans 127 Fehlercode 115 Kategorie Informationen zur Lieferung E vads ship to first name Beschreibung Erm glicht den Vornamen des K ufers anzugeben Format ans 63 Fehlercode 106 Kategorie Informationen zur Lieferung E vads ship to last name Beschreibung Erm glicht den Namen des K ufers anzugeben Format ans 63 Fehlercode 107 Kategorie Informationen zur Lieferung E vads ship to legal name Beschreibung Firmenname des Lieferorts Format an 1
109. ikats um die Signatur zu berechnen Sie finden diesen Wert im Men Einstellung gt Shop gt Registerkarte Zertifikate 3 Geben Sie den Wert der Benachrichtigungs URL auch als IPN en mode PRODUCTION im Modus PRODUCTION ber das Men Einstellung gt Regeln der Benachrichtigungen ein 14 3 Durchf hrung einer ersten Zahlung im Produktionsumfeld Es wird empfohlen zwei Dinge zu berpr fen e Die ordnungsgem e Funktion des gesamten Produktionsumfeldes Eine reale Transaktion durchf hren Diese Transaktion kann anschlie end im Back Office ber das Men Verwaltung gt Transaktion gt Registerkarte Laufende Zahlungen storniert werden F r diese Transaktion erfolgt dann kein Bank Kassenschnitt e Die ordnungsgem e Funktion der Benachrichtigungs URL auch als IPN die im Back Office angegeben ist Ohne auf die Schaltfl che Zur ck zum Shop zu klicken Sehen Sie sich die Details der Transaktion im Back Office und berpr fen Sie den Status des Instant Notification URL Status Notification URL gesendet wird PayZen 2 3 14 Aktivieren des Shops im Produktionsmodus 91 14 4 Erneutes Erstellen des Produktionszertifikats Im Fall eines Verlusts oder der Korruption des Produktionszertifikats kann der H ndler ber sein Back Office ein neues Zertifikat erstellen Gehen Sie wie folgt vor 1 W hlen Sie im Back Office Einstellung gt Shop gt Registerkarte Zertifikate 2 Klicken Sie auf Erneut erstellen
110. iner Liste f r die Auswahl des Zahlungsmittels lt form method POST action https secure payzen eu vads payment gt lt input type hidden name vads action mode value INTERACTIVE gt lt input type hidden name vads amount value 30000 gt lt input type hidden name vads capture delay value 0 gt lt input type hidden name vads ctx mode value TEST gt lt input type hidden name vads currency value 978 gt lt input type hidden name vads page action value PAYMENT gt lt input type hidden name vads_payment_cards value VISA MASTERCARD gt lt input type hidden name vads payment config value SINGLE gt lt input type hidden name vads site id value 12345678 gt lt input type hidden name vads trans date value 20140526101407 gt lt input type hidden name vads trans id value 239848 gt lt input type hidden name vads version value V2 gt lt input type hidden name signature value gt lt input type submit name bezahlen value Bezahlen gt lt form gt ndern der Sprache PayZen 2 3 8 Verwenden von erg nzenden Funktionen 62 Sie k nnen die Sprache personalisieren die auf den Zahlungsseiten verwendet wird 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Geben Sie in das Feld va
111. iner sofortigen Barzahlung senennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnenn 40 71 2 Erstellen einer zeitverz gerten Barzahlung e erasian enei u aaa 41 1 3 Erstellen einer Ratenzahlung 222022020000nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnenennennnnennnnsnnnnsnnnnnssnnnn 43 7 4 Erstellen einer Autorisierung ohne Weiterleitung u000000eennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennenneneennnn 45 8 VERWENDEN VON ERG NZENDEN FUNKTIONEN unssusesesennnenennnnnnnnnnnnnnnnnnnnnnunnnnnnnnnnnnnnnn 46 8 1 Festlegen des Modus f r den Bank Kassenschnitt automatisch manuell 000 een 47 8 2 Ubermittlung der Ku nee ee ee 49 8 3 bermittlung der Lieferdaten uunneenesnsennnnennennnnnnnnnnnnnennnnennnnnnnnnnennnnnnnennennnnnnnennennenennnnennennennnnen 50 8 4 bermittlung der Bestellungsdaten unnseeeeenennsnneennnnennnnnnnnnennnnennnnennnnnnnnnnnnnnnnnennnnennnnennnnenennnen 5I 8 5 Aktivieren Deaktivieren von 3 D Secure uesssssssssnsnnnnnennennnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnsnnnnnnnnnnsssnsssnsssnnnnnn 53 8 6 Festlegen des Handlervertt ss as a 54 8 7 Einrichten der R ckleitung zum Shop nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnennnnnnn 35 8 8 Aktivierung der automatischen R ckleitung zum Shop nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnenn 59 8 9 Personalisierung der
112. ird durch den 3 D Secure Authentifizierungsserver ACS w hrend des 3 D Secure Prozesses ausgef llt Format al Fehlercode 56 Beschreibung Authentifizierung erfolgreich M gliche Werte N Fehler bei Authentifizierung Authentifizierung nicht m glich Authentifizierungsversuch Kategorie 3 D Secure Authentifizierung PayZen 2 3 16 Datenlexikon 153 E vads threeds xid Beschreibung Gibt die eindeutige Referenz der 3 D Secure Transaktion an Das Feld wird durch den Authentifizierungsserver ACS w hrend des 3 D Secure Prozesses ausgef llt Format ans 28 Fehlercode 54 Kategorie 3 D Secure Authentifizierung E vads trans date Beschreibung Pflichtparameter Entspricht dem Zeitstempel im Format JJJMMTTHHMMSS Der Zeitstempel muss dem aktuellen Datum und der Uhrzeit in der Zeitzone GMT 0 oder UTC im 24 Stunden Format entsprechen Hinweis Wenn Sie die WebServices verwenden entspricht die Variable vads_trans_date dem Feld transmissionDate Wir empfehlen daher diesen Wert zu erfassen um den Wert f r das Feld transmissionDate bei Ihren Aufrufen ber die WebServices ordnungsgem anzugeben Format n14 Fehlercode 04 H ufige Fehler e Das Datum wird nicht im Format JJJMMTTHHMMSS Jahr Monat Tag Stunde Minute Sekunde gesendet e Das Datum basiert nicht auf der Zeitzone UTC Universal Time Coordinated Denken Sie daran in Ihrer Programmiersprache die Datumsfunktionen zu verwenden di
113. itung zum Shop beim Abschluss einer angenommenen Zahlung Der Wert betr gt von 0 bis 600 s Nach Ablauf dieser Zeitspanne wird der K ufer zu der im Feld vads_url_success angegebenen URL weitergeleitet Ist das Feld nicht ausgef llt wird der K ufer zu der im Feld vads_url_return angegebenen Back URL oder zu der im Back Office angegebenen URL weitergeleitet Ist keine Back URL definiert wird er zur URL des Shops weitergeleitet Format n 3 Fehlercode 34 Kategorie Weiterleitung zum Shop PayZen 2 3 16 Datenlexikon 137 E vads result Beschreibung In der Antwort zur ckgegebenes Feld R ckgabecode der angeforderten Aktion Format n2 M gliche Werte f D Dacrhraihinao Beschreibung o o o Aktion erfolgreich durchgef hrt j Der H ndler muss die Bank des Inhabers kontaktieren Obsolet Stornierung durch den K ufer 30 Fehler beim Anforderungsformat In Beziehung zum Wert des Feldes vads_extra_result zu setzen En Technischer Fehler Kategorie Technische Informationen E vads return mode Beschreibung Erm glicht die Angabe der Methode zur bertragung von Daten die bei der R ckkehr zum Shop verwendet wird Format string enum Fehlercode 48 M gliche Werte I Ze I abwesend leer An die Back URL zum Shop wird kein Parameter oder NONE bermittelt GET Die R ckgabefelder werden an die Back URL in Form eines HTTP GET Formulars bermittelt d h im query string vads
114. ld wird durch den 3 D Secure Authentifizierungsserver ACS ausgef llt wenn der K ufer ordnungsgem authentifiziert wird vads_threeds_status gleich Y oder A Format n 2 Fehlercode 53 Kategorie 3 D Secure Authentifizierung PayZen 2 3 16 Datenlexikon 151 E vads_threeds_enrolled Beschreibung Gibt den Registrierungsstatus des Inhabers an Das Feld wird durch die VISA und MASTERCARD DS Server w hrend des 3 D Secure Prozesses ausgef llt Format al Fehlercode 51 M gliche Werte Met 18 Inhaber registriert 3 D Secure m glich Registrierungsstatus kann nicht berpr ft werden Kategorie 3 D Secure Authentifizierung u vads threeds_exit_status Beschreibung In der Antwort zur ckgegebenes Feld Abschlie ender Status des 3D Secure Prozesses Das Feld wird von der Zahlungsplattform ausgef llt Format n 2 M gliche Werte Met peme OOOO CHEN 1777777 a 2ohlungohne 30 Secure Zahlung per Alias PayPal Cetelem usw 15 Zahlungskanal f r den 3 D Secure nicht verf gbar ist Zahlung mit Datei usw 16 Kartentyp und Netz sind 3 D Secure f hig nicht aber die mit der Karte verbundene Marke reine CB En Initialisierung des Der 3 D Secure Prozesses OK Ei Unbekannter Status Diese Statuswerte betreffen Zahlungen f r die 3 D Secure stattgefunden hat ohne aber die Karte zu erfassen per Alias Kategorie 3 D Secure Authentifizierung PayZen 2 3 16 Datenlexikon
115. lichen Konfiguration des H ndlers 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel f r Aktivierung von 3 D Secure abh ngig vom Betrag it vacs emounrt lt 300 euro i Sasa e e a 7 777 aa else vads_threeds_mpi 0 3DS enabled Beispiel f r Aktivierung von 3 D Secure abh ngig von der Lieferregion sa LE vacie Cust zip 92 then vads threeds mpi elce nado threcdo mpi or vacs CUSt Z1 0 3DS enabled 2 3DS disabled Beispiel eines Zahlungsformulars mit deaktiviertem 3 D Secure lt form method POST action https secure payzen eu vads payment gt lt input lt 1mpuT type hidden type hidden name vads action mode value INTERACTIVE gt name vads amount value 4000 gt lt input type hidden name vads capture delay value 0 gt lt input type hidden name vads ctx mode value TEST gt lt input type hidden name vads currency value 978 gt lt input type hidden name vads page action value PAYMENT gt lt input type hidden name vads payment config value SINGLE gt lt input type hidden name vads site id value 12345678 gt lt input type hidden name vads_threeds_mpi value 2 gt lt input type hidden name vads trans date value 20140327145218 gt lt input type hidden name vads trans id value 5
116. ltiple 90 Euro dreimal vads amount 9000 vads_currency 978 vads_payment_config MULTI_EXT date1 3000 date2 2000 date3 4000 vads amount 9000 vads_currency 978 vads_effective_amount 3000 vads amount 9000 vads_currency 840 vads_payment_config MULTI_EXT date1 3000 date2 2000 date3 4000 vads amount 9000 vads_currency 840 vads_change_rate 1 3118 verwendeter Wechselkurs vads_effective_amount 2287 Betrag der ersten Rate 30 vads_change_rate Kategorie Informationen zur Transaktion u vads_effective_creation_date Beschreibung In der Antwort zur ckgegebenes Feld Datum der Erfassung der Transaktion in der Zeitzone UTC oder GMT 0 im 24 Stunden Format JJJJIMMTTHHMMISS Format n14 Kategorie Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 117 E vads_expiry_month Beschreibung Format Fehlercode Kategorie u vads_expiry_year Beschreibung Format Fehlercode Kategorie u vads_ext_info Beschreibung Format Fehlercode Kategorie Verfallmonat der Karte die f r die Zahlung verwendet wird N 2 41 Informationen zum Zahlungsmittel Verfalljahr der Karte die f r die Zahlung verwendet wird n4 42 Informationen zum Zahlungsmittel Erm glicht die Hinzuf gung eines zus tzlichen Feldes in der E Mail zur Zahlungsbest tigung an den H ndler Diese Information wird im Back Office in den Transaktionsdetails angezeigt Registerkarte Extras De
117. lungsformular zu erstellen Verwenden Sie das Feld vads_url_check um die URL der zu benachrichtigenden Seite zu ndern Wenn der Wert des Feldes vads_url_check fehlerhaft ist wird das Formular zur ckgewiesen Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars das die URL zur sofortigen Zahlungsbest tigung ndert lt form method POST action https secure payzen eu vads payment gt lt input lt LNPUT lt 1NPUT lt input lt input lt 1NPUT lt IHPUE lt input lt anoNEe type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden name vads action mode value INTERACTIVE gt name vads amount value 3000 gt name vads capture delay value 0 gt name vads ctx mode value TEST gt name vads currency value 978 gt name vads page action value PAYMENT gt name vads payment config value SINGLE gt name vads site id value 12345678 gt name vads trans date value 20140526101407 gt lt input type hidden name vads trans id value 239848 gt lt input type hidden name vads_url_check value http www myshop com check gt lt input type hidden name vads version value V2 gt lt input type hidden name signature value 86b2al17b9a5fcefb6c0120c57b25ec86a
118. m synchronisiert werden 33 Ung ltige Kartennummer nicht gefunden 104 Beim Kassenschnitt f r diese Transaktion ist ein Fehler aufgetreten 34 Kartenpr fung mit systematischer Autorisierung 105 Bei der 3DS Prozess dieser Transaktion ist ein fehlgeschlagen Fehler aufgetreten 35 Pr fung der e Carte Bleue fehlgeschlagen 106 W hrung wird f r diesen Vertrag und oder diesen Shop nicht unterst tzt 36 Die Risikokontrolle hat zur Ablehnung dieser 107 Die mit dem Alias verkn pfte Karte ist nicht mehr Transaktion gef hrt g ltig 37 Nicht verwaltete Unterbrechung w hrend des 108 Aufgrund einer technischen St rung k nnen wir Zahlungsprozesses Ihre Anforderung nicht verarbeiten 38 Aufgrund einer technischen St rung k nnen wir 109 Wartezeit nach Weiterleitung des K ufers Ihre Anforderung nicht verarbeiten abgelaufen Ablehnung von 3 D Secure f r die Transaktion Zahlungskarte vom Vertrag nicht unterst tzt 40 Aufgrund einer technischen St rung k nnen wir 111 Ablehnung von Transaktionen ohne Ihre Anforderung nicht verarbeiten Haftungs bergang 41 Aufgrund einer technischen St rung k nnen wir 112 Die Stornierung ist nicht zul ssig Ihre Anforderung nicht verarbeiten 42 Beim Abruf der Kartennummer ist ein interner 113 Das Kopieren ist nicht zul ssig Fehler aufgetreten 43 Beim Abruf der Kartennummer ist ein interner 114 Die Erzwingung ist nicht zul ssig Fehler aufgetreten 44 Es ist nicht m glich eine Autorisierung von 1 Euro 11
119. mit einer Zeitspanne f r den Kassenschnitt von 60 Tagen erfolgt die Autorisierungsanfrage nicht zum Zeitpunkt der Zahlung Der Shop wird bei der Autorisierungsanfrage durch die Regel IPN bei Autorisierung durch batch kontaktiert Diese Regel ist standardm ig deaktiviert So konfigurieren Sie diese Benachrichtigung 1 Wechseln Sie zu https de payzen eu vads merchant 2 Gehen Sie zum Men Einstellung gt Regeln der Benachrichtigungen 3 Klicken Sie mit der rechten Maustaste auf IPN bei Autorisierung durch batch D IPN Aufruf H ndler E Mail Aktiviert Name x IPN bei Stornierung x IPN nach Aktion im Backoffice x IPN bei Autorisierung durch batch x IPN bei nderung durch batch s IPN am Ende der Zahlung Abbildung 17 Konfigurieren der IPN bei Autorisierung durch batch 4 W hlen Sie Regelverwaltung 5 Geben Sie die URL Ihrer Seite in die Felder Aufzurufende URL im Testumfeld und Aufzurufende URL im Produktionsumfeld ein 4 Test DE Regelverwaltung CHECKURL_EXT IPN bei Autorisierung durch batch x b Einstellungen z Regelbedingungen Q Informationen Allgemeine Einstellungen Name der Regel IPN bei Autorisierung durch batch IPN Einstellungen Die URL m ssen von unserem Server aus erreichbar sein Die URL zur Weiterleitung sind verboten Aufzurufende URL im Produktionsumfeld E Mailadresse zur Fehlermeldung luu mm nom Automatischer Neuversuch im Falle eines F Scheiterns X Schl
120. mular bermittelt werden m ssen e Das Datum vads_ctx_mode mit dem Wert TEST enthalten e Das zuvor f r die Berechnung der Signatur abgerufene Testzertifikat verwenden In der Testphase kann der H ndler die 3 D Secure Einstellungen testen wenn er f r 3 D Secure registriert ist und die Option 3DS nicht deaktiviert wurde Mithilfe der auf der Zahlungsseite angegebenen Test Kartennummern k nnen verschiedene Zahlungsf lle simuliert werden Alle im Testmodus durchgef hrten Transaktionen k nnen von Personen die zur Verwendung desBack Office berechtigt sind unter der folgenden Adresse abgerufen werden httos de payzen eu vads merchant Diese Transaktionen k nnen ber das Men Verwaltung gt Test Zahlungen abgerufen werden das sich oben rechts im Back Office befindet 13 2 Testen der URL zur sofortigen Zahlungsbest tigung IPN berpr fen Sie zun chst den Status der URL zur sofortigen Zahlungsbest tigung auch als IPN im Back Office Gehen Sie folgenderma en vor 1 Rechtsklicken Sie auf eine Transaktion 2 W hlen Sie Transaktionsdetails anzeigen 3 berpr fen Sie den Status der URL zur sofortigen Zahlungsbest tigung IPN e Wenn der StatusURL nicht definiert cela signifie que vous avez correctement renseign l URL dans le Back Office e Dans le cas o le statut appara t en URL non d finie angezeigt wird haben Sie die URL im Back Office nicht angegeben 1 berpr fen Sie die Adresse der URL zur
121. n value V2 gt name vads validation_mode value 1 gt name bezahlen value bezahlen gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 49 8 2 bermittlung der K uferdaten Der H ndler kann Informationen zum K ufer bermitteln E Mail Adresse Anrede Telefonnummer usw Aus diesen Daten werden die Abrechnungsdaten abgeleitet Diese Daten werden im Back Office angezeigt indem die Einzelheiten der Transaktion abgerufen werden Registerkarte K ufer 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Verwenden Sie die nachstehenden optionalen Felder gem Ihrem Bedarf Diese Felder werden in der Antwort mit dem Wert zur ckgegeben der im Formular bermittelt wurde Name des Feldes Beschreibung E Mail Adresse des K ufers vads_cust_id vads_cust_title vads_cust_status vads_cust_name vads_cust_first_name vads_cust_last_name vads_cust_cell_phone vads_cust_phone vads_cust_address_number vads_cust_address vads_cust_district vads_cust_zip vads_cust_city vads_cust_state vads_cust_country Tabelle 9 Liste der Felder Details zum K ufer 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit Informationen zum K ufer lt form method POST a
122. n 2 3 7 Erzeugen eines zahlungsformulars 39 7 ERZEUGEN EINES ZAHLUNGSFORMULARS Um einen Zahlungsauftrag zu erzeugen k nnen Sie ein HTML Formular wie folgt erstellen lt form method POST action https secure payzen eu vads payment gt lt input type hidden name Parameter1 value Wert1 gt lt input type hidden name Parameter2 value Wert2 gt lt input type hidden name Parameter3 value Wert3 gt lt input type hidden name Signature value Signatur gt lt input type submit name bezahlen value bezahlen gt lt form gt Es enth lt Die folgenden technischen Elemente e Die Tags lt form gt und lt form gt mit denen ein HTML Formular erstellt werden kann Das Attribut method post welches die Methode f r die bermittlung der Daten festlegt e Das Attribu action https secure payzen eu vads payment das festlegt wohin die Daten des Formulars gesendet werden sollen Die Daten des Formulars e Die Kennung des Shops e Die Eigenschaften der Zahlung gem dem Anwendungsfall siehe folgende Kapite e Die erg nzenden Informationen gem Ihren Anforderungen siehe Kapitel Verwenden von erg nzenden Funktionen e Die Signatur die die Integrit t des Formulars sicherstellt siehe Kapitel Berechnen der Signatur Diese Daten werden dem Formular mit dem Tag lt input gt lt input type hidden name parameter1 value Wert1 gt Zur Festlegung der Werte f r
123. n 80 11 6 Verarbeiten der Daten der AI WO aa ee 81 MER e e eE E E N EA E E A INNEREN EE HENDRIK E E E E N 87 12 BEARBEITEN DER R CKLEITUNG ZUM SHOP ssssssssssssnnseunnnuneunnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnns 88 13 DURCHF HREN DER TESTPHASE ussssesensnenennnnnnnnnnnnnnnnnnununnnunnnnnnannnnnnnnnunnnnnnnnnnnnnnnnnnnnnnunnnnnnn 89 13 1 Durchf hrung der Test Zahlung nee a E 89 13 2 Testen der URL zur sofortigen Zahlungsbest tigung IPN uu0ssssssseeeeeeeeeennnnnnnnnnnnnnnn 89 14 AKTIVIEREN DES SHOPS IM PRODUKTIONSMODUS 22220222000000000n2000nnnn0nnnunnnnnnn 90 14 1 Erzeugung des Produktionszertifikats sessssssnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnneneennnnnnennnnnn 90 14 2 Umstellung des Shops auf das Produktionsumfeld u uus0sssssseeeeennnnnnnnnnnnnnnnnnnnn nenn 90 14 3 Durchf hrung einer ersten Zahlung im Produktionsumfeld 0nnnnnnnnnnnnnnnnnnnnnn en 90 14 4 Erneutes Erstellen des Prod ktionszertifik ts u unnececanseseane ea a a a a 91 15 H UFIG GESTELLTE FRAGEN FAQ uuunuseseenoununenznnnanunnunnnununuunnnnnununuunnnnnununnunnnnnununnunnnnnnnnnnn 92 To DATENLEATRON a En RU a EL ER LEE 93 PayZen 2 3 1 Versionsverlauf des Dokuments 4 1 VERSIONSVERLAUF DES DOKUMENTS ers on nommentar 1 02 03 2015 Erg nzende Kapitel e Verwalten der Parameter Ihres Shops mit einer Konfigurationsdatei
124. n Pr fungen ist ein technisches Problem auf dem Server aufgetreten Kategorie Technische Informationen E vads _ hash Beschreibung Eindeutiger Schl ssel der ausschlie lich an die URL zur Zahlungsbest tigung IPN zur ckgesendet wird Format an64 Kategorie Technische Informationen E vads identifier Beschreibung Eindeutige Kennung Alias oder eindeutige Mandatnummer die einem Zahlungsmittel zugeordnet ist e Diese Kennung kann von der Plattform erzeugt werden In diesem Fall braucht dieser Parameter nicht angegeben zu werden e Alternativ kann diese Kennung vom Shop erzeugt werden In diesem Fall ist der Parameter mit dem gew nschten Wert der Kennung anzugeben Die Eindeutigkeit der Kennungen ist vom Shop sicherzustellen Alle Registrierungsanfragen die eine bereits vorhandene Kennung enthalten werden zur ckgewiesen und f hren zur Anzeige einer Fehlermeldung Format ans 50 Kategorie Informationen zur Ratenzahlung PayZen 2 3 16 Datenlexikon 122 u vads identifier_status Beschreibung In der Antwort zur ckgegebenes Feld Nur vorhanden wenn die angeforderte Aktion der Erstellung oder Aktualisierung von Folgendem entspricht e Alias Ratenzahlung e UMR oder eindeutige Mandatnummer SEPA Format string M gliche Werte Beschreibung Der Alias oder die UMR wurde erfolgreich erstellt NOT_CREATED Die Autorisierungsanfrage wurde verweigert Der Alias oder die UMR wurde nicht erstellt und wird nicht
125. n Sie das Feld E Mailadresse n zur Fehlermeldung aus 7 Um mehrere E Mail Adressen anzugeben trennen Sie sie durch ein Semikolon PayZen 2 3 6 Benachrichtigungseinstellungen 32 8 Konfigurieren Sie den Automatischen Neuversuch im Falle eines Scheiterns Mit dieser Option wird die Benachrichtigung im Falle eines Scheiterns automatisch bis zu vier Mal an den Shop gesendet Ausf hrlichere Informationen entnehmen Sie bitte dem Kapitel Aktivieren des automatischen Neuversuchs 9 Speichern Sie Ihre nderungen Sollte die Plattform keine Verbindung zur URL Ihrer Seite herstellen k nnen wird eine E Mail an die in Schritt 6 angegebene Adresse gesendet Sie enth lt e den HTTP Code des aufgetretenen Fehlers e Elemente zur Analyse abh ngig von dem betreffenden Fehler e Informationen ber die Folgen des Fehlers e Informationen ber das Verfahren das vom Back Office aus auszuf hren ist um die Anfrage wieder auf die in Schritt 5 definierte URL zur ckzuleiten PayZen 2 3 6 Benachrichtigungseinstellungen 33 6 5 Konfigurieren der Benachrichtigung f r das Endergebnis einer zeitverz gerten Zahlung Diese Benachrichtigung ist unerl sslich um das Ergebnis einer zeitverz gerten Zahlung zu melden e Im Fall einer angenommenen Zahlung e Im Fall einer verweigerten Zahlung Sie erm glicht es dem Shop benachrichtigt zu werden wenn eine Autorisierungsanfrage erfolgt Beispiel F r eine zeitverz gerte Zahlung
126. n des Test oder Produktionsmodus 00000ssssssssssssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnsnnsnnnnnsnnnnnnn 22 5 4 Einrichten des Dialogs mit dem SE op an a a 23 3 3 Verwalten der S1Cherhe een er ee 25 5 6 Verwalten der Parameter Ihres Shops mit einer Konfigurationsdatei uussssssnnnseenennnnnnnnnnnnnn nenn 21 6 BENACHRICHTIGUNGSEINSTELLUNGEN use a a 28 6 1 Benachrichtigungen ber die verschiedenen Statuswerte bei einer sofortigen Barzahlung 28 6 2 Benachrichtigungen ber die verschiedenen Statuswerte bei einer zeitverz gerten Barzahlung 29 6 3 Benachrichtigungen ber die verschiedenen Statuswerte f r die Raten von Ratenzahlungen 30 6 4 Konfigurieren der Benachrichtigung bei Abschluss der Zahlung 2200000000esseeeeeeeeenen 31 6 5 Konfigurieren der Benachrichtigung f r das Endergebnis einer zeitverz gerten Zahlung 33 6 6 Konfigurieren der Benachrichtigung im Fall eines Abbruchs einer Stornierung nennnennnenn 35 6 7 Aktivieren des automatischen Neuversuchs uusssssssssssessssssssensssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnsnnnnnnsnnenn 36 6 8 Manueller Neuversuch zum Senden der Benachrichtigung uussssnnnnnnnnnnnnnnnnn nn 38 7 ERZEUGEN EINES ZAHLUNGSFORMULARS 222220n02000uu00n0nnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 39 7 1 Erstellen e
127. nach der G ltigkeitsdauer einer Autorisierungsanfrage Eine Autorisierung f r einen euro Auskunftsanfrage wurde angenommen Der H ndler muss die Transaktion manuell best tigen um die Autorisierungsanfrage und den Bank Kassenschnitt auszul sen UNDER_VERIFICATION Spezifisch f r PayPal Wartet auf berpr fung durch PayPal Dieser Wert bedeutet dass PayPal die Transaktion wegen Betrugsverdachts zur ckh lt Die Zahlung befindet sich daher auf der Registerkarte Laufende Zahlungen NOT_CREATED Die Transaktion wird nicht erstellt und nicht im Back Office angezeigt Tabelle 17 Werte des Feldes vads_trans_status 3 Rufen Sie die Referenz der Zahlung ab die im Feld vads_trans_id bermittelt wird PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 82 4 Pr fen Sie das Feld vads_payment_config um zu ermitteln ob es sich um eine Barzahlung einmalig oder um eine Ratenzahlung handelt Dieses Feld kann folgende Werte haben Wert f r eine Barzahlur g vads_payment_config SINGLE MULTI dont la systaxe exacte est MULTI first X count Y period Z Tabelle 18 Analyse des Feldes vads_payment_config Wenn es sich um eine Ratenzahlung handelt identifizieren Sie die Nummer der Rate anhand des Wertes im Feld vads_sequence_number roih al f DU 5S Wert Bescl zn Rate DT TE Tabelle 19 Analyse des Feldes vads_sequence_number F r eine Barzahlung einmalig wird das Feld vads_sequence
128. nden Funktionen 53 8 5 Aktivieren Deaktivieren von 3 D Secure Diese Funktionalit t erfordert die Aktivierung der Option 3 D Secure mit Auswahlm glichkeit Der H ndler kann in seinem Zahlungsformular angeben ob er den 3 D Secure Prozess aktivieren oder deaktivieren m chte Der H ndler muss Kriterien seiner Wahl festlegen Betrag Land Lieferregion usw die es erm glichen zu entscheiden ob f r die Transaktion 3 D Secure Prozess verwendet werden soll 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Verwenden Sie das Feld vads_threeds_mpi um 3 D Secure zu aktivieren oder zu deaktivieren nicht vorhanden 3 D Secure Authentifizierung von der Zahlungsplattform verwaltet Konfiguration des H ndlers oder leer 3 D Secure Authentifizierung von der Zahlungsplattform verwaltet Konfiguration des H ndlers 3 D Secure Authentifizierung vollst ndig vom H ndler verwaltet wenn vads_card_number angegeben ist Eingabe der Kartendaten beim H ndler Die sich aus der vom MPI des H ndlers ergebenden Daten der 3 D Secure Authentifizierung m ssen dann in die entsprechenden Felder des Formulars bertragen werden vads_threeds_enrolled vads_threeds_cavv vads_threeds_eci vads_threeds_xid vads_threeds_ cavvAlgorithm vads_threeds_status 3 D Secure Authentifizierung f r die Transaktion deaktiviert unabh ngig von der b
129. ne Problem e Elemente zur Analyse abh ngig von dem betreffenden Fehler e Informationen ber die Folgen des Fehlers e Informationen ber das Verfahren das vom Back Office aus auszuf hren ist um die Anfrage wieder auf die in Schritt 5 definierte URL zur ckzuleiten Hinweis Nach dem vierten Versuch ist immer noch ein Neuversuch m glich um die URL der Benachrichtigung zu senden Dies kann manuell von Ihrem Back Office aus erfolgen Beachten Sie dass w hrend des Zeitraums der automatischen Neuversuche jedes manuelle Senden der URL der Benachrichtigung die Anzahl der automatischen Versuche beeinflusst 8 Speichern Sie Ihre nderungen Hinweis Beim automatischen Neuversuch werden bestimmte Informationen nicht in der Datenbank gespeichert oder ver ndert Beispiele f r nicht verf gbare nicht gespeicherte Felder in der Datenbank e vads_page_action e vads_payment_config e vads_action_mode Beispiele f r Felder die mit anderen Werten gesendet werden e vads_url_check_src auf RETRY eingestellt e vads_trans_status Der Status der Transaktion im Anschluss an diesen Vorgang variiert abh ngig von ihrem Status beim Senden der URL siehe Kapitel Lebenszyklus der Transaktionen e vads_hash unter Ber cksichtigung der neuen Werte anders eingestellt signature unter Ber cksichtigung der neuen Werte anders eingestellt PayZen 2 3 6 Benachrichtigungseinstellungen 38 6 8 Manueller Neuversuch zum Senden der Benach
130. ne Weiterleitung Diese Zahlungsart erm glicht es die G ltigkeit der Daten der Karte des K ufers sicherzustellen ohne sie zu belasten Bei Bedarf kann der H ndler diese Karte mit dem gew nschten Betrag belasten indem er die Funktion Kopieren im Back Office verwendet Zu diesem Zweck e wird der manuelle Best tigungsmodus verwendet e darf der H ndler die Transaktionen nicht manuell best tigen Verwenden Sie alle Felder in der folgenden Tabelle um Ihr Zahlungsformular zu erstellen vads_site_id vads_ctx_mode vads_trans_id vads_trans_date vads amount vads_currency vads_action_mode vads_page_action vads_version vads_payment_config vads_capture_delay vads_validation_mode Zeitspanne vor Bank Kassensehn fo o Tabelle 7 Liste der Felder Autorisierung ohne Kassenschnitt Geben Sie in das Feld vads_amount einen geringen Betrag ein Er wirkt sich nicht auf den Verf gungsrahmen der Karte aus Setzen Sie das Feld vads_validation_mode auf 1 Geben Sie in das Feld vads_currency den Code der gew nschten W hrung gem der W hrungstabelle ein Beispiel 978 f r Euro 840 f r US Dollar F gen Sie optionale Felder gem Ihren Anforderungen hinzu siehe Kapitel Verwenden von erg nzenden Funktionen Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Formular
131. ng an string enum vs Die Zahlung ist garantiert NO Die Zahlung ist nicht garantiert UNKNOW Aufgrund eines technischen Fehlers kann die Zahlung nicht garantiert werden Nicht Zahlungsgarantie nicht anwendbar angegeben Informationen zur Transaktion
132. nicht mehr erfolgen Sobald eine Transaktion best tigt wurde erh lt sie den Status Wartet auf Kassenschnitt Bei Bedarf kann er die Transaktion auch stornieren Die Transaktion erh lt dann den Status Storniert PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 17 Durchf hrung der Zahlung 3 D Secure Authentifizierung Lokale Kontrollen Autorisierungs anfrage OK Autorisierung angenommen Versendung von E Mail an K ufer Frist abgelaufen Zuk gen Stornierung Stornierung Am Tag des angefragten Bank Kassenschnitts PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 18 Lebenszyklus einer Transaktion f r zeitverz gerte Barzahlung Zeitspanne f r Kassenschnitt k rzer als die G ltigkeitsdauer der Autorisierung siehe Schema Lebenszyklus einer Transaktion f r sofortige Barzahlung Zeitspanne f r Kassenschnitt l nger als die G ltigkeitsdauer der Autorisierung Jede Transaktion f r eine zeitverz gerte Barzahlung die im Modus f r manuelle Barzahlung durchgef hrt wird und f r die die Autorisierungsanfrage f r 1 euro Auskunftsanfrage erfolgreich durchgef hrt wurde kann im Back Officemit dem Status Zu best tigen und zu autorisieren abgerufen werden Die Autorisierungsanfrage wird automatisch am angefragten Tag des Bank Kassenschnitts durchgef hrt sofern der H ndler die Transaktion zuvor best tigt hat W hrend er auf den Kassenschnitt
133. nput lt input lt input lt LNPUT lt input lt input lt input lt INPUT lt TOMS type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type submit name vads action mode value INTERACTIVE gt name vads amount value 3000 gt name vads capture delay value 0 gt name vads ctx mode value TEST gt name vads currency value 978 gt name vads page action value PAYMENT gt name vads payment config value SINGLE gt name vads_shop_name value My shop gt name vads_shop_url value http www myshop com gt name vads site id value 12345678 gt name vads trans date value 20140526101407 gt name vads trans id value 239848 gt name vads version value V2 gt name signature value 86b2al7b9a5fcefb6c0120c57b25ec86ad1704ee gt name bezahlen value Bezahlen gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 65 ndern der Beschriftung der Schaltfl che Zur ck zum Shop Sie k nnen den Text Zur ck zum Shop personalisieren 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen Verwenden Sie das Feld vads_theme_config um die Beschriftung der Schaltfl che Zur ck zum Shop
134. ns_status gegeben Kategorie Informationen zur Transaktion E vads payment src Beschreibung Erm glicht die Herkunft der Zahlung anzugeben Format string enum Fehlercode 60 M gliche Werte E Commerce ber die Zahlungsseite durchgef hrte Zahlung MOTO MAIL OR TELEPHONE ORDER von einem Sachbearbeiter nach einer telefonisch oder per E Mail bermittelten Bestellung durchgef hrte Zahlung Call center ber ein Call Center durchgef hrte Zahlung OTHER Sonstige Zahlung ber eine andere Quelle z B das Back Office Kategorie Informationen zur Transaktion E vads pays_ip Beschreibung In der Antwort zur ckgegebenes Feld Erm glicht die Angabe der IP Adresse des K ufers gem Norm ISO 3166 Format a2 Kategorie Informationen zum K ufer u vads presentation date Beschreibung In der Antwort zur ckgegebenes Feld Angefragtes Datum des Bank Kassenschnitts Format n14 Kategorie Informationen zur Transaktion E vads product amountN Beschreibung Erm glicht den Betrag f r die verschiedenen im Einkaufskorb enthaltenen Artikel festzulegen N entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw Der Betrag wird in der kleinsten Einheit der W hrung angegeben Cent beim Euro Format n 12 Kategorie Informationen zur Bestellung PayZen 2 3 16 Datenlexikon 134 E vads product labelN Beschreibung Erm glicht die Bezeichnung f r jeden der im Einkaufskorb
135. nsaktion bereits in Verwendung Karte nicht m glich CH Die CVV ist f r diese Karte erforderlich 80 Kennung der Transaktion abgelaufen 10 Der Erstattungsbetrag bersteigt den 81 Inhalt des config Schemas ung ltig urspr nglichen Betrag 11 Die Summe der durchgef hrten Erstattungen 82 Die Erstattung ist nicht zul ssig bersteigt den urspr nglichen Betrag 12 Die Verdoppelung einer Gutschrift Erstattung ist 83 Der Transaktionsbetrag liegt au erhalb der nicht zul ssig zul ssigen Werte 13 Aufgrund einer technischen St rung k nnen wir 84 Aufgrund einer technischen St rung k nnen wir Ihre Anforderung nicht verarbeiten Ihre Anforderung nicht verarbeiten 14 Aufgrund einer technischen St rung k nnen wir 85 Aufgrund einer technischen St rung k nnen wir Ihre Anforderung nicht verarbeiten Ihre Anforderung nicht verarbeiten 15 Aufgrund einer technischen St rung k nnen wir Aufgrund einer technischen St rung k nnen wir Ihre Anforderung nicht verarbeiten Ihre Anforderung nicht verarbeiten 16 Aufgrund einer technischen St rung k nnen wir 87 Aufgrund einer technischen St rung k nnen wir Ihre Anforderung nicht verarbeiten Ihre Anforderung nicht verarbeiten 17 Die Einstellung des Aurore Vertrags ist 88 Aufgrund einer technischen St rung k nnen wir fehlgeschlagen Ihre Anforderung nicht verarbeiten 18 Die Analyse der Antwort von Cetelem ist Die nderung ist nicht zul ssig fehlgeschlagen 19 Unbekannte W hrung Be
136. nzeichnung wird dieser Parameter auf CB eingestellt card_number Nummer des Zahlungsmittels e Beieiner Zahlung mit e Urlaubsgutscheinen wird dieser Parameter durch Verkn pfung der Gutscheinnummer Nummer der Einheit Ausstellungsjahr angegeben die durch das Zeichen getrennt werden e Beieiner Zahlung mit Bankkarte ist die Nummer verborgen expiry_month Monat in dem die Bankkarte abl uft Parameter bei Zahlung mit e Urlaubsgutscheinen nicht vorhanden expiry_year Jahr in dem die Bankkarte abl uft Parameter bei Zahlung mit e Urlaubsgutscheinen nicht vorhanden payment_certificate Zertifikat der Zahlung r i a Piesentation AAE Bei einer Zahlung mit Bankkarte entspricht dieser Parameter dem gew nschten Datum des Bank Kassenschnitts im Format ISO 8601 Bei einer Zahlung mit e Urlaubsgutscheinen entspricht dieser Parameter dem Datum der Bestellung e Urlaubsgutscheine werden in Echtzeit beim Server der Titel von ANCV berpr ft trans_id Transaktionsnummer ext_trans_id Parameter bei Zahlung mit Bankkarte nicht vorhanden Bei einer Zahlung mit e Urlaubsgutscheinen ist dieser Parameter eine technische Kennung die von der Zahlungsplattform erzeugt wird Referenz der Transaktion Status der Transaktion Tabelle 40 Inhalts des Objekts JSON PayZen 2 3 16 Datenlexikon 133 Anmerkung Stornierte Transaktionen werden ebenfalls in der bersicht angezeigt Information im Parameter JSON tra
137. ode zur bertragung der Daten an den Shop anzugeben Absent vide ou NONE An die Back URL werden keinerlei Daten gegeben Die Daten werden an die URL der R ckleitungsseite bermittelt Die Daten werden an die R ckleitungsseite in Form eines POST HTTP Formulars bermittelt Die Methode GET erm glicht die Anzeige einer Fehlermeldung zu vermeiden wenn die R ckleitung ber eine unsichere Umgebung HTTP erfolgt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 58 Obwohl diese Seite verschl sselt ist werden die von Ihnen eingegebenen Informationen ber eine 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit 1 unverschl sselte Verbindung gesendet und k nnen leicht von Dritten gelesen werden Sollen diese Informationen wirklich gesendet werden Athen vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit Festlegung der Methode f r die Daten bertragung lt form method POST action https secure payzen eu vads payment gt lt input type hidden name vads aetion mode value TNTERACTTVE gt E E Zuhidde ns nme vodsS menmerszelue 00 lt inpue type hidden name vads eapture delay value W0N gt lt input type hidden name vads ot mode value TESTYT gt np pe Zuhidd nanem ud Beten never non gt lt input type hidden name vads page aet on value PAYMENT gt lt inpur type hid
138. omatisch zu T 1 vor dem Datum des Bank Kassenschnitts ausgel st Die Zahlung kann angenommen oder verweigert werden Der Bank Kassenschnitt erfolgt automatisch WAITING_AUTHORISATION_TO Zu best tigen und zu autorisieren _VALIDATE Das angefragte Datum des Kassenschnitts liegt nach der G ltigkeitsdauer einer Autorisierungsanfrage Eine Autorisierung f r einen euro Auskunftsanfrage wurde angenommen Der H ndler muss die Transaktion manuell best tigen um die Autorisierungsanfrage und den Bank Kassenschnitt auszul sen UNDER_VERIFICATION Spezifisch f r PayPal Wartet auf berpr fung durch PayPal Dieser Wert bedeutet dass PayPal die Transaktion wegen Betrugsverdachts zur ckh lt Die Zahlung befindet sich daher auf der Registerkarte Laufende Zahlungen NOT_CREATED Die Transaktion wird nicht erstellt und nicht im Back Office angezeigt Tabelle 43 Werte des Feldes vads_trans_status Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 156 E vads url cancel Beschreibung URL zu der der K ufer weitergeleitet wird wenn er vor der Ausf hrung der Zahlung auf Stornieren und zur ck zum Shop klickt Format ans 127 Fehlercode 27 Kategorie Weiterleitung zum Shop E vads_ur l check Beschreibung URL der nach Abschluss der Zahlung zu benachrichtigenden Site ndert den in den Einstellungen f r die Benachrichtigungsregeln eingegebenen Wert Inkompatibel mit der Ausf hrung der Anforderung die vom Back Office au
139. onen zur Lieferung E vads ship to type Beschreibung Erm glicht die Lieferart anzugeben Format string enum Fehlercode 94 M gliche Werte RECLAIM_IN_SHOP RELAY_POINT RECLAIM_IN_STATION PACKAGE_DELIVERY_COMPANY ETICKET Kategorie Informationen zur Lieferung E vads ship _to_user_info Beschreibung Information zum Benutzer der die Zahlung veranlasst Die Verwendung des Betrugsschutzmoduls ClearSale erfordert dass dieses Feld mit CPF CNPJ ausgef llt wird Steuernummer im numerischen Format mit 11 bis 20 Stellen Dieser Parameter wird in der Antwort mit dem Wert zur ckgegeben der im Formular bermittelt wurde Format ans 255 Fehlercode 116 Kategorie u vads_ship_to_zip Beschreibung Format Fehlercode Kategorie PayZen 2 3 16 Datenlexikon 144 Informationen zur Lieferung Erm glicht die Postleitzahl des K ufers anzugeben an 64 85 Informationen zur Lieferung E vads shipping amount Beschreibung Format Kategorie E vads shop_name Beschreibung Format Fehlercode Kategorie E vads shop_url Beschreibung Format Fehlercode Kategorie Erm glicht den Betrag der Lieferkosten f r die gesamte Bestellung festzulegen n 12 Informationen zur Bestellung Erm glicht den Namen des Shops zu definieren der in den E Mails f r die Zahlungsbest tigung angezeigt wird ans 127 72 Personalisierung der Zahlungsseite Die URL des Shops die auf
140. ops w hrend des Datenaustauschs Ihr Wert wird im Feld vads_site_id bertragen e Das Zertifikat Erm glicht die Berechnung der digitalen Signatur die im Feld signature bertragen wird So rufen Sie diese Werte ab 1 Wechseln Sie zu https de payzen eu vads merchant 2 Klicken Sie auf Einstellung gt Shop 3 W hlen Sie die Registerkarte Zertifikate aus ge Einstellungen AR Einstellung der MOTO Zahlung Individuelle Gestaltung Fi Fortgeschrittene Personalisierung Zertifikate Inf Vertr ge Zertifikat Shop ID 91335531 Produktionszertifikat Ausgeblendet aus Sicherheitsgr nde Testzertifikat 8627912856153542 Datum der Umstellung auf Produktionsmodus 09 10 2009 16 56 58 Letztes Erstellungsdatum des 04 12 2008 12 25 38 Produktionszertifikats Erneut erstellen Abbildung 7 Anzeigen der Shop ID und des Zertifikats Es stehen zwei Arten von Zertifikaten zur Verf gung e Das Testzertifikat mit dem Sie die Signatur eines Formulars im Testmodus erzeugen k nnen PayZen 2 3 5 Einrichten des Dialogs mit der Zahlungsplattform 22 e Das Produktionszertifikat mit dem Sie die Signatur eines Formulars im Produktionsmodus erzeugen k nnen 5 3 Ausw hlen des Test oder Produktionsmodus Die Auswahl des Test oder Produktionsmodus erfolgt ber das Feld vads_ctx_mode siehe Kapitel Erzeugen eines Zahlungsformulars e Der Testmodus erm glicht es Testzahlungen durchzuf hren Er ist immer verf gbar auch nach de
141. orisierung Nachstehend finden Sie die Liste der Zahlungsmittel deren Autorisierung l nger als O Tage g ltig ist G ltigkeitsdauer einer Autorisierung in Tagen 7 Kartentypen vads_payment_cards AMEX AURORE MULTI CORA_BLANCHE CORA_PREM CORA_VISA Zahlungsmittel AMEX AURORE AURORE AURORE AURORE American Express N WO Aurore Karte N WO Cora Karte N WO Cora Premium Karte N WO Cora Visa Karte CB O oO O J O J VISA MASTERCARD MAESTRO VISA_ELECTRON E CARTEBLEUE S MONEY CDGP TRUFFAUT_CDX COF3XCB COFINOGA SOFICARTE SYGMA COFINOGA Diners Club Karte DINERS GATECONEX JCB Karte JCB JCB Paylib PAYLIB PAYLIB PayPal PAYPAL PAYPAL POSTFINANCE POSTFINANCE POSTFINANCE SEPA berweisung SCT SEPA SEPA Lastschrift SDD SEPA V_ME V_ME ECCARD WIRECARD O J Visa MasterCard Maestro O J Visa Electron O J E carte bleue S MONEY Privil ge Karte Truffaut Geschenkkarte 3 Mal CB Cofinoga Be Smart Karte O J go O CDGP CERIDIAN COF3XCB COFINOGA COFINOGA U9 O N r O Soficarte Karte O Sygma Karte w V me by Visa m e w Eccard Karte me w PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 8 4 BERBLICK BER DEN ABLAUF EINER ZAHLUNG Das Verfahren f r Online Zahlung gestaltet sich aus der Sicht des K ufers und des H ndlers unterschiedlich 4 1 Festlegen der Schritte f r eine Zahlung aus K ufer
142. r Erzeugung des Produktionszertifikats Wenn Sie einen neuen Shop erstellen oder ber eine Validierungsumgebung verf gen k nnen Sie Ihre Tests durchf hren ohne dass sie sich auf die gegenw rtig in der Produktion befindliche Site auswirken Die Test Transaktionen k nnen im Back Office ber das Men Verwaltung gt Test Zahlungen angezeigt werden Verwaltung Einstellung Hilfe E Zahlungen Zahlungsangebot p Abonnements CJ Test Zahlungen Test Zahlungsangebot p3 Test Abonnements uma Test Einstellung der Internetseiten p Abbildung 8 Anzeigen der Test Transaktionen e Der Produktionsmodus ist erst verf gbar nachdem das Produktionszertifikat erzeugt wurde siehe Kapitel Aktivieren des Shops im Produktionsmodus Er erm glicht reale Zahlungen durchzuf hren Die Produktions Transaktionen k nnen im Back Office ber das Men Verwaltung gt Zahlungen aufgerufen werden Verwaltung Einstellung Hilfe GJ Zahlungen Zahlungsangebot p Abonnements GJ Test Zahlungen E Test Zahlungsangebot N Test Abonnements sau Testi Einstellung der Internetseiten p Abbildung 9 Anzeigen der Produktions Transaktionen PayZen 2 3 5 Einrichten des Dialogs mit der Zahlungsplattform 23 5 4 Einrichten des Dialogs mit dem Shop Die Einrichtung des Dialogs mit dem Shop erfolgt ber zwei Arten von URLs e URL der sofortigen Zahlungsbest tigung auch als IPN Instant Payment Notification be
143. r Name muss mit vads_ext_info beginnen damit der ber cksichtigt wird vads_ext_info_namedesfeldes Wert ans 91 Informationen zur Bestellung E vads ext info bil address_complement Beschreibung Format Kategorie Spezifisch f r Brasilien und den Betrugsschutzanbieter ClearSale Erm glicht einen Adresszusatz f r die Rechnungsstellung anzugeben ans 250 Informationen zum K ufer E vads ext info deadline Beschreibung Format Kategorie Spezifisch f r Brasilien und den Betrugsschutzanbieter ClearSale Erm glicht die Angabe der Lieferfrist in Tagen N Tage n Informationen zur Lieferung PayZen 2 3 16 Datenlexikon 118 u vads ext info_bil_date_of_birth Beschreibung Format Kategorie Spezifisch f r Brasilien und den Betrugsschutzanbieter ClearSale Erm glicht auf der Rechnung das Geburtsdatum des K ufers anzugeben Format JJJJ MM ttZhh mm ss Datetime Informationen zum K ufer E vads _ext_info bil gender Beschreibung Format Kategorie Spezifisch f r Brasilien und den Betrugsschutzanbieter ClearSale Erm glicht auf der Rechnung das Geschlecht des K ufers anzugeben n1 Informationen zum K ufer E vads _ext_info fingerprint id Beschreibung Format Kategorie Spezifisch f r Brasilien und den Betrugsschutzanbieter ClearSale Eindeutige Sitzungskennung e Diese Sitzungskennung kann von der Zahlungsplattform erzeugt werden In diesem Fall braucht
144. r R ckleitung zum Shop 88 12 BEARBEITEN DER R CKLEITUNG ZUM SHOP Bei der R ckleitung des K ufers zum Shop werden durch den Browser standardm ig keine Parameter bermittelt Wenn jedoch das Feld vads_return_mode im Zahlungsformular gesendet wurde siehe Kapitel Einrichten der R ckleitung zum Shop k nnen die Daten abgerufen werden e entweder im GET Modus Daten in der URL in der Form paraml1 werti amp param2 wert2 e oder in POST in einem POST Formular gesendet Daten Die an den Browser bermittelten Daten sind dieselben wie bei den Benachrichtigungen IPN Nur die Felder vads_url_check_src und vads_hash werden nur in der sofortigen Best tigung gesendet Zur Analyse dieser Daten siehe Kapitel Analyse der Art der Benachrichtigung Hinweis Die R ckleitung zum Shop soll es Ihnen nur erm glichen dem K ufer einen visuellen Kontext anzuzeigen Verwenden Sie die empfangenen Daten nicht um die Verarbeitung in der Datenbank vorzunehmen PayZen 2 3 13 Durchf hren der Testphase 89 13 DURCHF HREN DER TESTPHASE Vor der Umstellung des Shops auf das Produktionsumfeld m ssen Tests durchgef hrt werden um die ordnungsgem e Interaktion zwischen dem Shop und der Zahlungsplattform sicherzustellen Diese Tests m ssen durchgef hrt werden bevor die Umstellung auf das Produktionsumfeld beantragt wird 13 1 Durchf hrung der Test Zahlungen Zahlungsauftr ge f r Test Zahlungen die ber das HTTP POST For
145. r Regel URL der Benachrichtigung bei Abschluss der Zahlung IPN wird auf diesem Bildschirm angezeigt Sollte diese Regel nicht eingestellt sein melden Sie dies bitte siehe Kapitel Benachrichtigungsoptionen einstellen PayZen 2 3 5 Einrichten des Dialogs mit der Zahlungsplattform 25 5 5 Verwalten der Sicherheit Die Sicherheit der Transaktionen f r Online Zahlungen wird durch mehrere Schutzmechanismen gew hrleistet Verwalten der Sicherheit mittels der Signatur Die Integrit t der ausgetauschten Informationen wird durch den Austausch von digitalen Signaturen zwischen der Zahlungsplattform und dem Shop sichergestellt Der Dialog zwischen der Zahlungsplattform und dem Shop erfolgt durch bermittlung von HTMLFormularen Ein Formular enth lt eine Liste von spezifischen Feldern siehe Erzeugen eines Zahlungsformulars die zur Berechnung seiner digitalen Signatur verwendet werden siehe Kapitel Berechnen der Signatur Das Ergebnis dieser Berechnung muss an das Feld signature gesendet werden Wir verwenden zur Verschl sselung der Signatur die Hashing Funktion SHA 1 SHA 1 ist in der Mehrzahl der Sprachen verf gbar die f r die Entwicklung von Webanwendungen verwendet werden Je nach der gew hlten Sprache m ssen Sie m glicherweise die SHA 1 Hashing Funktionen selbst codieren wie z B in ASP Als Hilfe sehen Sie nachstehend das Ergebnis des SHA 1 Hashings f r das Zeichen a SHA1 a 86f7e
146. ransaktion zur ckgewiesen 5 Alias vorhanden Der verwendete Kartentyp ist f r die anforderte Zahlungsart nicht zul ssig PayZen 2 3 16 Datenlexikon 131 Fehlercof Fehlermeldung Fehlercof Fehlermeldung 14 1 Ung ltiger Alias Aufgrund einer technischen St rung k nnen wir Ihre Anforderung nicht verarbeiten Aliaserstellung verweigert 4 Eine Transaktion im Produktionsmodus wurde beim Acquirer f r den Testmodus gekennzeichnet Ratenzahlung bereits vorhanden 145 Eine Transaktion im Testmodus wurde beim Acquirer f r den Produktionsmodus gekennzeichnet Diese Ratenzahlung ist bereits gek ndigt Ung ltiger SMS Code 1 1 Aufgrund einer technischen St rung k nnen wir Ihre Anforderung nicht verarbeiten Die Transaktion wurde nicht erstellt Die Rekursionsregel ist ung ltig 148 Diese Ratenzahlung ist ung ltig 4 Das Betrugsverwaltungsmodul hat die Ablehnung dieser Transaktion verlangt 4 Erstellung der Ratenzahlung verweigert 1 Die Zahlungssitzung ist abgelaufen Fall eines K ufers der zum ACS weitergeleitet wird und die 3 D Secure Authentifizierung nicht abschlie t 3 4 6 7 9 Aufgrund einer technischen St rung k nnen wir Aufgrund einer technischen St rung k nnen Ihre Anforderung nicht verarbeiten wir Ihre Anforderung nicht verarbeiten Die Transaktion wurde nicht erstellt Kategorie Technische Informationen E vads payment option _ code Beschreibung Erm glicht den Code der ve
147. rdacht Dieser Code wird von der Bank ausgegeben die die Karte ausgestellt hat Er tritt in der Regel nach einer wiederholten falschen Eingabe der CVV oder des Ablaufdatums auf Um den genauen Grund der Zur ckweisung zu erfahren muss der K ufer sich an seine Bank wenden Der Kartenakzeptant muss den Acquirer kontaktieren Dieser Code wird von der Bank des K ufers ausgegeben Er weist auf ein Konfigurationsproblem auf den Autorisierungsservern hin Er wird in der Regel ausgegeben wenn der Gesch ftsvertrag nicht mehr dem verwendeten Verkaufskanal bereinstimmt Bsp eine eCommerce Transaktion mit einem Vertrag des Typs VAD manuelle Eingabe Kontaktieren Sie den Kundenservice um den Fehler beheben zu lassen Tabelle 21 Mit dem Feld vads_auth_result verbundene Werte PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 84 9 Rufen Sie das Ergebnis der 3 D Secure Authentifizierung ab Gehen Sie folgenderma en vor a Rufen Sie den Wert des Feldes vads_threeds_enrolled ab um den Status der Kartenregistrierung zu ermitteln wert Beschreibung 3 D Secure Prozess nicht durchgef hrt 3 D Secure in der Anforderung deaktiviert H ndler nicht registriert oder Zahlungsmittel f r 3 D Secure nicht zugelassen Authentifizierung verf gbar Inhaber registriert Inhaber nicht registriert Identifizierung des Inhabers nicht m glich oder Karte f r Authentifizierungsversuche nicht zugelassen z B Gesch ftskarten oder Prep
148. rderung im Formular ver ffentlichen ans 150 15 Informationen zum K ufer E vads cust first name Beschreibung Format Fehlercode Hinweis Kategorie E vads cust id Beschreibung Format Fehlercode Kategorie Vorname des K ufers an 63 104 Pflichtfeld f r 3xCB Cofinoga Informationen zum K ufer Kunden ID beim H ndler an 63 16 Informationen zum K ufer E vads _ cust last_ name Beschreibung Format Fehlercode Hinweis Kategorie Name des K ufers an 63 105 Pflichtfeld f r 3xCB Cofinoga Informationen zum K ufer E vads cust legal name Beschreibung Format Kategorie Firmenname des K ufers an 100 Informationen zum K ufer E vads_cust_ name Beschreibung Format Fehlercode Kategorie E vads cust phone Beschreibung Format Fehlercode Hinweis Kategorie E vads cust state Beschreibung Format Fehlercode Kategorie E vads cust status Beschreibung Format Fehlercode M gliche Werte Kategorie E vads cust title Beschreibung Format Fehlercode Hinweis Kategorie Name des K ufers PayZen 2 3 16 Datenlexikon 114 Dieses Feld ist obsolet Es wird durch die Felder vads_cust_first_name und vads_cust_last_name ersetzt an 127 18 Informationen zum K ufer Telefonnummer des K ufers an 32 23 Pflichtfeld f r 3xCB Cofinoga Informationen zum K ufer Land Region des K ufers an 127 88 Informationen z
149. richtigung Mit dieser Option k nnen Sie die URL der Benachrichtigung vom Back Office aus manuell neu ausf hren wenn bei einer Transaktion ein Fehler aufgetreten ist 1 Wechseln Sie zu https de payzen eu vads merchant 2 Suchen Sie die Transaktion f r die Sie die Benachrichtigung erneut manuell senden m chten 3 Klicken Sie mit der rechten Maustaste auf die Transaktion und w hlen Sie URL der Benachrichtigung ausf hren Eine Nachricht zeigt Ihnen an dass der Befehl ordnungsgem ausgef hrt wurde wenn die Anwendung erneut verf gbar ist Sie k nnen das Ergebnis des Vorgangs in allen F llen im Ereignisverlauf der Transaktion anzeigen und die Fehlernachrichten analysieren falls das Problem weiter besteht Wird der Neuversuch manuell aus dem Back Office ausgef hrt werden bestimmte Informationen nicht in der Datenbank gespeichert oder ver ndert Beispiele f r nicht verf gbare nicht gespeicherte Felder in der Datenbank e vads_page_action e vads_payment_config e vads_action_mode Beispiele f r Felder die mit anderen Werten gesendet werden e vads_url_check_src auf BO eingestellt e vads_trans_status Der Status der Transaktion im Anschluss an diesen Vorgang variiert abh ngig von ihrem Status beim Senden der URL siehe Kapitel Lebenszyklus der Transaktionen e vads_hash unter Ber cksichtigung der neuen Werte anders eingestellt e signature unter Ber cksichtigung der neuen Werte anders eingestellt PayZe
150. rm erzeugt wird Referenz der Transaktion Status der Transaktion Tabelle 27 Inhalts des Objekts JSON Anmerkung Stornierte Transaktionen werden ebenfalls in der bersicht angezeigt Beispiel f r eine Zahlung die mit einer Prepaid Karte und erg nzend mit einer VISA Karte erfolgte cranes 10 599495 vrransactions e TW amount s YL0O00OY Voperarion Type e DEBLIH capture delay s 0 Ucar branci g STLLICADO SBH Yearc mumoer 3 2230NUDISOPOSOSAII GLE 7 Ppaymemeseerertie ee SAONE r se ooeec cderebbebaa b2 u VoresentartLon darte YzZ0L5 01 26T14 393 1027 erano Pr us 21957 Ter a aS aA e 107 sequence number s YLW trang startus s CAPTURED Ir 2 meoume 3 9000 operacion Type e DEBLIH auth nunoer s orseza capture delay 3 0 cearc branci g YESA card number 497010XXXXXX0000 expiry Month g 07 expiry year zols payment Certiricats s 7696aeeo7 644459526027 Tra050aa66577641706 Moresentation darte g 20L5 01 260T1l4 3 393 302 erano Tae ES So eur ne NUMOS g 7 Peranski catie A UTBORTSEDZ 1 12 Rufen Sie alle Informationen zu den Bestelldaten den K uferdaten und den Lieferdaten ab Diese Daten sind nur in der Antwort enthalten wenn sie im Zahlungsformular gesendet wurden Ihr Wert entspricht dem im Formular bermittelten Wert 13 Fahren Sie mit der Aktualisierung der Bestellung fort PayZen 2 3 11 Analysieren des Ergebnis
151. rungsanfragen bis zu T 2 Im Fall einer Zur ckweisung wegen Betrugsabsicht gilt die Transaktion als endg ltig verweigert PayZen 2 3 5 Einrichten des Dialogs mit der Zahlungsplattform 21 5 EINRICHTEN DES DIALOGS MIT DER ZAHLUNGSPLATTFORM Der Dialog zwischen dem Shop und der Zahlungsplattform erfolgt per Datenaustausch Um eine Zahlung zu erstellen werden diese Daten ber den Browser des K ufers mit einem HTML Formular bermittelt Nach Abschluss der Zahlung wird das Ergebnis mit zwei Verfahren an den Shop bermittelt e automatisch mittels Benachrichtigungen die als URL zur sofortigen Zahlungsbest tigung bezeichnet werden auch als IPN f r Instant Payment Notification bezeichnet siehe Kapitel Benachrichtigungseinstellungen e durch den Browser wenn der K ufer auf die Schaltfl che f r die R ckkehr zum Shop klickt siehe Kapitel Einrichten der R ckleitung zum Shop Um die Sicherheit der Kommunikation zu gew hrleisten werden die Daten mithilfe eines Zertifikats signiert das ausschlie lich dem H ndler und der Zahlungsplattform bekannt ist 5 1 Festlegen der URL der Zahlungsseite Der Shop kommuniziert mit der Zahlungsplattform indem der K ufer an folgende Seite weitergeleitet wird httos secure payzen eu vads payment 5 2 Identifizierung beim Datenaustausch Um mit der Zahlungsplattform zu kommunizieren ben tigt der H ndler zwei Informationen e Die Shop ID Dient zur Identifizierung des Sh
152. rursache z B HTTP Fehler und eine Anleitung zum erneuten Senden der Benachrichtigung vom Back Office aus Back URL zum Shop Der H ndler kann im Back Office die Standard Back URL ber das Men Einstellung gt Shop gt Registerkarte Einstellungen konfigurieren Back URL Back URL des Shops in Testumgebung Back URL des Shops in Produktionsumgebung Status de Regel IPN am Ende der Zahlung Nicht eingestellt Die Back URL wird aufgerufen wenn der K ufer am Ende der Zahlung auf die Schaltfl che Zur ck zum Shop klickt Diese URL darf nicht mit der IPN verwechselt werden Um das Ergebnis dieser Transaktion zu analysieren m ssen Sie sich auf die IPN st tzen die auf diesem Bildschirm eingestellt werden kann Regeln der Benachrichtigungen Testen Sie IMMER indem Sie Ihren Browser am Ende der Zahlung schliessen ohne zum Shop weitergeleitet zu werden Abbildung 10 Festlegen der Back URL Er kann eine Back URL zum Shop konfigurieren Standardm ig wird der K ufer unabh ngig vom Ergebnis der Zahlung zur Back URL geleitet PayZen 2 3 5 Einrichten des Dialogs mit der Zahlungsplattform 24 Wenn jedoch auf dieser Ebene keine URL konfiguriert ist verwendet die Weiterleitung die Haupt URL des Shops Parameter URL im Bereich Einzelheiten des Shops Der H ndler hat die M glichkeit diese Konfiguration in seinem Zahlungsformular zu berschreiben siehe Kapitel Back URLs definieren Hinweis Der Status de
153. rwendeten Option zu definieren Format n 2 Kategorie Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 132 E vads payment seq Beschreibung Details der ausgef hrten Transaktionen Format json vads_payment_seq json Format beschreibt die Abfolge einer fraktionierten Zahlung Sie enth lt folgende Elemente e trans_id ID der globalen Transaktion mit der Zahlungsabfolge e transaction bersicht der Transaktionen der Sequenz Sie enth lt folgende Elemente Parameters Betrag der Abfolge der Zahlung Belastungsvorgang auth_number Autorisierungsnummer die vom Bankserver zur ckgegeben wurde falls verf gbar ansonsten leer Dieser Parameter wird bei einer Zahlung mit e Urlaubsgutscheinen leer zur ckgegeben Der Server der Titel von ANCV gibt sie nicht an capture_delay Frist bis Kassenschnitt in Tagen e Beieiner Zahlung mit e Urlaubsgutscheinen wird f r diesen Parameter 0 eingestellt e Urlaubsgutscheine werden in Echtzeit gepr ft Bei einer Zahlung mit Bankkarte ber cksichtigt der Parameter die Frist bis zum Kassenschnitt in Anzahl von Tagen Wird dieser Parameter im Zahlungsformular nicht bertragen wird der im Back Office festgelegte Standardwert verwendet card_brand Verwendetes Zahlungsmittel e Beieiner Zahlung mit e Urlaubsgutscheinen wird f r diesen Parameter E_CV eingestellt Bei einer Zahlung mit Bankkarte beispielsweise CB oder CB mit Visa oder MasterCard Markenken
154. s an die URL der sofortigen Best tigung gesendet wurde Die gesendete URL wird in der Benachrichtigungsregel konfiguriert siehe Kapitel Benachrichtigungsoptionen einstellen im Handbuch f r die Implementierung des Zahlungsformulars Format ans 127 Fehlercode 33 Kategorie Weiterleitung zum Shop E vads url check src Beschreibung In der Antwort zur ckgegebenes Feld Dieser Parameter definiert die Herkunft der Benachrichtigung auch als IPN bezeichnet Format string enum 1 Beschreibung M gliche Werte 5 PAY Erstellung einer Zahlung ber ein Formular Ausf hrung der IPN aus dem Back Office BATCH_AUTO Autorisierungsanfrage f r eine Zahlung deren Autorisierung aussteht REC Zahlung im Rahmen einer Ratenzahlung MERCH_BO Vom Back Office ausgef hrter Vorgang RETRY Automatischer Neuversuch zum Senden der URL der Benachrichtigung Kategorie Weiterleitung zum Shop E vads_ url error Beschreibung URL an die der K ufer im Fall eines internen Verarbeitungsfehlers weitergeleitet wird Format ans 127 Fehlercode 29 Kategorie Weiterleitung zum Shop E vads url referral Beschreibung Format Fehlercode Kategorie E vads url refused Beschreibung Format Fehlercode Kategorie E vads_ url return Beschreibung Format Fehlercode Kategorie PayZen 2 3 16 Datenlexikon 157 Obsoletes Feld Verwenden Sie vads_url_refused URL zu der der K ufer weitergeleitet wird wenn die Autorisier
155. s payment config value SINGLE gt name vads site id value 12345678 gt name vads trans date value 20140526101407 gt name vads trans id value 362812 gt name vads validation mode value 0 gt name vads version value V2 gt name signature value 86b2al7b9a5fcefb6c0120c57b25ec86ad1704ee gt name payer value Payer gt lt form gt 10 2 Verwaltung von Fehlern Wenn die Plattform beim Empfang des Formulars eine Anomalie erkennt wird eine Fehlermeldung angezeigt und der K ufer kann nicht mit der Zahlung fortfahren Im Testmodus Die Meldung gibt die Ursache des Fehlers an und enth lt einen Link zu den FAQ um Sie bei der Behebung zu unterst tzen Im Produktionsmodus Die Meldung gibt dem K ufer nur an dass ein technisches Problem aufgetreten ist In beiden F llen erh lt der H ndler eine Fehlermeldung per E Mail Sie enth lt e die Ursache des Fehlers e einen Link zu den FAQ um eine Diagnose zu erm glichen e alle im Formular enthaltenen Felder Die FAQ sind unter folgender Adresse verf gbar https www de payzen eu haufige fragen fag PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 75 11 ANALYSIEREN DES ERGEBNISSES DER ZAHLUNG Um die Ergebnisse der Zahlung zu verarbeiten muss der Shop ber ein Skript auf einer dedizierten Seite verf gen Beispiel Zahlungsanalyse php Diese Seite wird automatisch nach jeder Zahlung angenommen oder verweigert aufgerufen
156. s zur Autorisierung ohne Kassenschnitt lt form method POST action https secure payzen eu vads payment gt lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type submit lt ETOrm gt name vads action mode value INTERACTIVE gt name vads amount value 100 gt name vads capture delay value 0 gt name vads ctx mode value TEST gt name vads currency value 978 gt name vads page action value PAYMENT gt name vads validation_mode value 1 gt name vads site id value 12345678 gt name vads trans date value 20141008073753 gt name vads trans id value 346738 gt nee Nwade weres ion wealne ini j2 name signature value 95338e879ea543a4dadal2107a0c1c4d95ed3239 gt name bezahlen value bezahlen gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 46 8 VERWENDEN VON ERG NZENDEN FUNKTIONEN Um ein personalisiertes und an Ihre Bed rfnisse angepasstes Formular zu erhalten k nnen Sie erg nzende Funktionen aus der nachstehenden Liste verwenden e Festlegen des Modus f r den Bank Kassenschnitt Pr fungsmodus e bermitteln der Informationen zum K ufer Anrede E Mail Adresse usw bermitteln
157. s_product_typeN Details des Einkaufskorbs Typ des Artikels N enum Tabelle 30 Parameterliste Details zur Bestellung s Informationen zum K ufer ame desreldes romat Theschremung OOOO Tabelle 31 Liste der Felder Details zum K ufer E Informationen zur Lieferung ame des Feldes froma Taescnabung o vads_ship_to_street2 ans 255 PayZen 2 3 16 Datenlexikon 96 vads_ship_to_user_info Informationen zum K ufer Steuernummer CPF CNPJ vads_ship_to_zip an Postleitzahl Tabelle 32 Parameterliste Details zur Lieferung PayZen 2 3 16 Datenlexikon 97 E Informationen zum Zahlungsmittel vads _banksode fn vads bank produt fan _birth_ n _bi n 5 3 2 3 4 2 4 Kartenpr fnummer mit 3 oder 4 Ziffern vads_expiry_month Verfallmonat der Karte die f r die Zahlung verwendet wird vads_expiry_year n Verfalljahr der Karte die f r die Zahlung verwendet wird Tabelle 33 Parameterliste Informationen zum Zahlungsmittel n 36 Verdeckte Kartennummer n u Informationen zur Transaktion Name des Feldes Beschreibung vads_amount n 12 Transaktionsbetrag in der kleinsten W hrungseinheit Cent beim Euro vads_auth_mode string enum Legt fest auf welche Weise die Autorisierungsanfrage durchgef hrt wird vads_auth_number Vom Bankserver zur ckgegebene Autorisierungsnummer n2 vads_auth_result Von der ausgebenden Bank zur ckgegebener R ckgabecode der Autori
158. samtsumme der Betr ge muss dem Wert im Feld vads_amount entsprechen Das Datum der letzten Rate darf nicht mehr als 12 Monate nach bermittlung des Formulars liegen Wenn das Datum der letzten Ratet nach dem Verfalldatum der Karte liegt wird keine Rate erfasst und der K ufer wird in einer Meldung ber dieses Problem informiert Kategorie Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 129 E vads payment error Beschreibung In der Antwort zur ckgegebenes Feld Fehlercodes die bei einer verweigerten Zahlung angezeigt werden k nnen Format N 3 M gliche Werte Fehlerco Fehlermeldung Fehlermeldung Die Transaktion wurde nicht gefunden Die Autorisierung wurde von Cofinoga verweigert Die Transaktion wurde nicht gefunden Ablehnung der Autorisierung von 1 Euro 3 Diese Aktion ist f r Transaktionen mit dem Status 74 Ung ltige Zahlungskonfiguration 0 nicht zul ssig 4 Diese Transaktion ist in diesem Kontext nicht 75 Der Vorgang wurde von PayPal verweigert zul ssig 5 Die Transaktion ist bereits vorhanden 76 Aufgrund einer technischen St rung k nnen wir Ihre Anforderung nicht verarbeiten Ung ltiger Transaktionsbetrag Aufgrund einer technischen St rung k nnen wir Ihre Anforderung nicht verarbeiten Diese Aktion ist f r eine zu diesem Datum erstellte 78 Kennung der Transaktion nicht definiert Transaktion nicht mehr m glich Diese Aktion ist aufgrund des Verfalldatums der 79 Kennung der Tra
159. scher Dollar 124 608 Hongkong Dollar 344 710 Singapur Dollar 702 986 Neuseel ndischer Dollar 554 458 Ungarischer Forint 348 360 CFP Franc 953 410 Schweizer Franken 756 Yen 392 Indische Rupie 356 985 Fehlercode 67 Kategorie Informationen zur Ratenzahlung PayZen 2 3 16 Datenlexikon 147 E vads sub_desc Beschreibung Pflichtparameter der bei der Erstellung einer Ratenzahlung verwendet wird Er definiert die anzuwendende Regel f r die Ratenzahlung Der in diesem Parameter erwartete Wert ist eine Zeichenkette gem der Spezifikation iCalendar oder Internet Calendar die in RFC5545 beschrieben ist siehe http tools ietf org html rfc5545 Diese Spezifikation erm glicht es unter anderem ber die Eigenschaft RRULE komplexe Regeln f r Ratenzahlungen festzulegen Aus technischen Gr nden ist es nicht m glich Ratenzahlungszeitr ume von unter einem Tag zu definieren Die Schl sselw rter SECONDLY MINUTELY HOURLY werden nicht ber cksichtigt Beispiele e Um Ratenf lligkeiten am letzten Tag des Monats f r 12 Monate festzulegen lautet die Regel wie folgt RRULE FREQ MONTHLY BYMONTHDAY 28 29 30 31 BYSETPOS 1 COUNT 12 Diese Regel bedeutet dass wenn der laufende Monat keinen 31 enth lt die Engine den 30 verwendet Wenn der 30 nicht vorhanden ist wird der 29 verwendet usw bis zum 28 e Um Ratenf lligkeiten zum 10 jedes Monats f r 12 Monate festzulegen lautet die Ratenzahlungsregel
160. ses der Zahlung 87 11 7 Fehlerbehandlung Einrichtung einer Protokolldatei W hrend der Implementierungsphase kann es insbesondere im Fall von Schwierigkeiten bei der Berechnung der Signatur von Nutzen sein ber Protokolle zu verf gen Wir empfehlen jedoch auch nach der bertragung des Shops in die Produktionsumgebung eine t gliche Protokolldatei vorzusehen Dies erm glicht es Ihnen im Fall von Problemen die Daten zu analysieren Idealerweise enth lt die Protokolldatei die gesendeten oder empfangenen Daten sowie die bei der Berechnung der Signatur erhaltene Zeichenkette vor der Berechnung des SHA 1 Algorithmus HTTP Fehlercode Bei Fehlern w hrend der Benachrichtigungen gibt die versendete E Mail Warnmeldung den R ckgabecode des HTTP Protokolls an Es gibt 5 Kategorien von R ckgabecodes Codekategorie Beschreibung Erfolg Weiterleitung Client Fehler Server Fehler Die am h ufigsten zur ckgegebenen Fehlercodes sind in den FAQ beschrieben https secure payzen eu htmi server_url_error H ufiger Fehler Eine htaccess Datei kann den Aufruf der URL zur sofortigen Zahlungsbest tigung blockieren Die htaccess Dateien sind Konfigurationsdateien der Web Apache Server Sie k nnen in einem beliebigen Verzeichnis des Shops platziert werden die Konfiguration gilt f r das Verzeichnis und alle darin befindlichen Verzeichnisse die keine solche Datei enthalten PayZen 2 3 12 Bearbeiten de
161. sicht Das folgende Schema zeigt einen berblick ber die Interaktionen aus K ufersicht Best tigt den W hlt das Gibt die Daten Gibt den 3 D Secure Ruft das Ergebnis Einkaufskorb Zahlungsmittel aus seiner Karte ein und Authentifizierungscode der Zahlung ab best tigt sie ein und best tigt ihn 4 4 ROHR OHIO ELITE WC CELESTES TR XEELEE TIER IT HEN ELEELE ELELE CEECEE ELAEEELI LAEE Re DENE ER EEE ARD BEREIT ROH TERROR RUN TORRENT HORCECH NO TO TLICHERCECHL NT OR ET EEE IE 4 4 i Wird zum Shop Leitet zn weitergeleitet weiter Zeigt J f r Zeigt die Seite f r Leitet Zur 3 D Analysiert die Antwort Zeigt die Antwort und die Auswahl des die Eingabe der Secure Seite weiter und f hrt eine die Ergebnisseite f r Zahlungsmittels an Kartendaten an Autorisierungsanfrage die Zahlung an durch Zeigt die Seite 3 D Versendung der 3 D Versendet die Antwort Secure Secure Antwort an auf die Authentifizierungscode PayZen Autorisierungsanfrage Abbildung 1 berblick ber die Interaktionen aus K ufersicht 1 Der K ufer best tigt seinen Einkaufskorb 2 Der Shop leitet den K ufer zur Zahlungsplattform weiter Diese Weiterleitung erfolgt mithilfe eines HTML POST Formulars ber HTTPS Die Parameter aus denen es sich zusammensetzt sind im Kapitel Erzeugen eines Zahlungsauftrags beschrieben PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 9 3 Die Zahlungsplattform zeigt nach berpr fung der Parameter und
162. sierung siehe Schema Lebenszyklus einer Transaktion f r sofortige Barzahlung Zeitspanne f r Kassenschnitt l nger als die G ltigkeitsdauer der Autorisierung Jede Transaktion f r eine zeitverz gerte Barzahlung die im Modus f r automatische Barzahlung durchgef hrt wird und f r die die Autorisierungsanfrage f r 1 euro Auskunftsanfrage erfolgreich durchgef hrt wurde kann im Back Officemit dem Status Wartet auf Autorisierung abgerufen werden Die Autorisierungsanfrage wird automatisch durchgef hrt e Standardverfahren am Tag des gew nschten Datums f r den Bank Kassenschnitt e Verfahren mit Autorisierung im Voraus abh ngig vom gew hlten Zahlungsmittel an T A siehe Tabelle zur G ltigkeit einer Autorisierung vor dem gew nschten Datum des Bank Kassenschnitts Das Verfahren mit Autorisierung im Voraus ist beim Kundendienst zu beantragen Im Fall einer Zur ckweisung aus nicht betrugsbezogenen Gr nden siehe Tabelle werden die Autorisierungsanfragen bis zum Tag T2 vor dem Datum des Bank Kassenschnitts wiederholt W hrend er auf den Kassenschnitt wartet kann der H ndler die Transaktion stornieren oder deren Betrag nur reduzieren und oder das Datum des Kassenschnitts ndern Das folgende Schema zeigt die m glichen Statuswerte f r diesen Transaktionstyp Fall einer nicht wiederholten Autorisierungsanfrage Durchf hrung der Zahlung nnnnnnnnnnbnnnnnnnnnnnnnnnnnn ag 3 D Secure Authentifizierung
163. sierungsanfrage vads_capture_delay Zeitspanne in Tagen vor dem Bank Kassenschnitt vads_contract_used Verwendeter H ndlervertrag vads_contracts NETZ1 Vertrag1 Zu verwendender H ndlervertrag NETZ2 Vertrag2 vads_currency Numerischer Code der W hrung die f r die Zahlung zu verwenden ist n3 vads_effective_amount n 12 Zahlungsbetrag in der kleinsten W hrunsgseinheit die bei der Ausf hrung des Bank Kassenschnitts verwendet wird Cent beim Euro vads_effective_creation_date n14 Datum der Erfassung der Transaktion in der Zeitzone UTC oder GMT 0 im 24 Stunden Format JJJJMMTTHHMMSS vads_operation_type string enum Erm glicht einen Belastungs und Gutschriftvorgang Erstattung zu unterscheiden vads_payment_cards typel type2 Liste der Zahlungsmittel die dem K ufer anzubieten sind vads_payment_certificate an40 Von der Zahlungsplattform ausgef lltes Feld wenn die Autorisierung erfolgreich durchgef hrt wurde vads_payment_config string enum Zahlungsart bar oder in Raten vads_payment_option_code Erm glicht den Code der verwendeten Option zu definieren vads_payment_seq Beschreibt die Abfolge einer fraktionierten Zahlung vads_payment_src string enum Herkunft der Zahlung ans vads_risk_analyzer_result Gibt das Ergebnis der Betrugskontrolle zur ck die durch ein externes System durchgef hrt wurde ClearSale CyberSource USW Pr fung2 Ergebnis2 Stunden Format JJJJIMMTTHHMMSS PayZen 2 3 16 D
164. smittel e Beieiner Zahlung mit e Urlaubsgutscheinen wird f r diesen Parameter E_CV eingestellt e Beieiner Zahlung mit Bankkarte beispielsweise CB oder CB mit Visa oder MasterCard Markenkennzeichnung wird dieser Parameter auf CB eingestellt card_number Nummer des Zahlungsmittels e Beieiner Zahlung mit e Urlaubsgutscheinen wird dieser Parameter durch Verkn pfung der Gutscheinnummer Nummer der Einheit Ausstellungsjahr angegeben die durch das Zeichen getrennt werden PayZen 2 3 11 Analysieren des Ergebnisses der Zahlung 86 Name des Parameters Beschreibung PFrRER e Bei einer Zahlung mit Bankkarte ist die Nummer verborgen expiry_month Monat in dem die Bankkarte abl uft Parameter bei Zahlung mit e Urlaubsgutscheinen nicht vorhanden expiry_year Jahr in dem die Bankkarte abl uft Parameter bei Zahlung mit e Urlaubsgutscheinen nicht vorhanden Zertifikat der Zahlung presematon aate e Beieiner Zahlung mit Bankkarte entspricht dieser Parameter dem gew nschten Datum des Bank Kassenschnitts im Format ISO 8601 Bei einer Zahlung mit e Urlaubsgutscheinen entspricht dieser Parameter dem Datum der Bestellung e Urlaubsgutscheine werden in Echtzeit beim Server der Titel von ANCV berpr ft trans_id Transaktionsnummer ext_trans_id Parameter bei Zahlung mit Bankkarte nicht vorhanden Bei einer Zahlung mit e Urlaubsgutscheinen ist dieser Parameter eine technische Kennung die von der Zahlungsplattfo
165. t input lt INPUT lt input lt input lt input lt LNPUT type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden name vads action mode value INTERACTIVE gt name vads amount value 3000 gt name vads capture delay value 0 gt name vads ctx mode value TEST gt name vads currency value 978 gt neme lveiedsipaer Kaee ton zehn Sa name vads payment config value SINGLE gt name vads site id value 12345678 gt name vads trans date value 20140526101407 gt name vads trans id value 239848 gt name vads_url_return value http demo com return php gt name vadskyersion value v7 name signature value 86b2al7b9a5fcefb6c0120c57b25ec86ad1704ee gt lt input name bezahlen value Bezahlen gt lt or gt type submit Festlegen der Methode f r den Datenempfang Standardm ig erh lt der Shop keinerlei Parameter Um Informationen zur R ckleitungsseite abzurufen Tracking Statistiken Personalisierung der Meldungen f r den K ufer usw kann der H ndler diese Einstellung in seinem Zahlungsformular ndern 1 Verwenden Sie alle erforderlichen Felder f r Ihren Anwendungsfall siehe Kapitel Erzeugen eines Zahlungsformulars um Ihr Zahlungsformular zu erstellen 2 Verwenden Sie das optionale Feld vads_return_mode um die Meth
166. te 3 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit Festlegung des Modus f r den Bank Kassenschnitt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 48 lt form method POST action https secure payzen eu vads payment gt lt input lt input lt input lt input lt LMDUT lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt LOS type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type submit name vads action mode value SILENT gt name vads amount value 4000 gt name vads capture delay value 0 gt name vads card number value 4970100000000000 gt name vads ctx mode value TEST gt name vads currency value 978 gt name vads cvv value 123 gt name vadsrexpiry month value 5 gt name vadstexpiry year value 2017W gt name vads page action value PAYMENT gt name vads payment config value SINGLE gt name vads site id value 12345678 gt name vads trans date value 20140326164147 gt name vads trans id value 164147 gt name vads versio
167. ten Sandbox Modus AURORE Cetelem Aurore Netz Firmenkarten und universelle Aurore Karte GATECONEX Gateconex Netz Visa Mastercard CB Maestro Visa Electron Diners Beispiel vads_contracts GICC_VISA 12312312 AMEX 949400444000 Anmerkung Dieser Parameter ist optional und lediglich dann n tzlich wenn Sie mehrere VAD Vertr ge auf demselben Netz haben und diese abh ngig von der Zahlung dynamisch ndern m chten Wenn dieser Parameter nicht angegeben wird oder nicht vorhanden ist wird die Zahlung f r Ihren Standard MOTO H ndlervertrag erfasst Kategorie Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 109 E vads contract used Beschreibung Format Kategorie E vads _ contrib Beschreibung Format Fehlercode Kategorie In der Antwort zur ckgegebenes Feld Dieses Feld legt den Wert des Vertrags fest der der Transaktion zugeordnet ist Es wird mit dem standardm ig in Ihrem Shop registrierten Vertrag ausgef llt oder erh lt den Wert vads_contracts der beim Zahlungsauftrag bermittelt wurde ans 250 Informationen zur Transaktion Optionale erg nzende Information um den Namen des bei der Zahlung verwendeten Beitrags anzugeben Joomla osCommerce usw Wenn Sie eine propriet re Implementierung verwenden kann dieses Feld z B Ihre interne Versionsnummer des Moduls aufnehmen das Sie entwickelt haben ans 128 31 Technische Informationen PayZen 2 3 16 Datenle
168. ten W hrung gem der W hrungstabelle ein Beispiel 978 f r Euro 840 f r US Dollar 6 F gen Sie optionale Felder gem Ihren Anforderungen hinzu siehe Kapitel Verwenden von erg nzenden Funktionen 7 Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur PayZen 2 3 7 Erzeugen eines zahlungsformulars 42 Beispiel eines Zahlungsformulars f r zeitverz gerte Barzahlung lt form method POST action https secure payzen eu vads payment gt lt input lt input lt input lt input lt LMDUT lt input lt input lt input lt input lt input lt input lt input lt input lt EONS type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type submit name nads action mode value TTNTERACTIVEN gt name vads ameune value 1 000i w a I y a VW mame e E ae a e a I 2 Deme vads Curren a ale Sy 7 gt name vads page actioni value PAYMENT gt name N vadeSreymeneseon ie velue a name vads site id value 2 gt 3456783 7 gt name vade trane ate ze rue 7207207257 200 25772 name vad Errme Bid vu O gt name vads version value v2W gt 2 name signature value 86b2al7b9a5fcefb6c0120c57b25ec86ad1704ee gt name bezahlen value bezahlen gt PayZen 2 3 7
169. tum der Karte Vorfall in initialisierender Dom ne berschritten 34 0 Betrugsverdacht Kategorie Informationen zur Transaktion PayZen 2 3 16 Datenlexikon 104 E vads available languages Beschreibung Erm glicht die auf der Zahlungsseite verf gbaren Sprachen in Form einer Liste anzugeben Jedes Element in der Liste ist durch ein Semikolon zu trennen Die Sprachauswahl erfolgt ber L nderflaggen die auf der Zahlungsseite angezeigt werden Format Sprache1 Sprache2 Sprache3 Fehlercode 71 M gliche Werte Deutsch Englisch Chinesisch Spanisch Franz sisch Italienisch Japanisch Niederl ndisch Polnisch Portugiesisch Russisch Schwedisch T rkisch Beispiel Um die L nderflaggen f r Franz sisch und Englisch anzuzeigen m ssen Sie vads_available_languages fr en eingeben Kategorie Personalisierung der Zahlungsseite E vads _ bank code Beschreibung In der Antwort zur ckgegebenes Feld Bankencode der ausgebenden Bank Format n5 Kategorie Informationen zum Zahlungsmittel PayZen 2 3 16 Datenlexikon 105 E vads bank product Beschreibung In der Antwort zur ckgegebenes Feld Produktcode der Karte die f r die Zahlung verwendet wird F r reine CB Karten ist dieses Feld leer Format an 3 M gliche Werte MASTER VI 5 CARD Beschreibung Beschreibung MASTERCARD PREPAID DEBIT STANDARD INSURANCE MASTERCARD PREPAID DEBIT STANDARD OTHER MASTERCARD PREPAID CARD MA
170. tum der angefragten Vorlage wird eine Autorisierungsanfrage f r den Gesamtbetrag ausgef hrt Die Zahlung kann angenommen oder verweigert werden Der H ndler muss daher bei dieser Zahlungsart sehr wachsam sein bevor er eine Ware an den K ufer liefert bzw eine Dienstleistung f r den K ufer erbringt 3 3 Ratenzahlung Eine Zahlung gilt als Ratenzahlung wenn der K ufer mit dem Betrag f r den Kauf in mehreren Raten belastet wird Die erste Rate wird auf dieselbe Art und Weise gezahlt wie eine sofortige Barzahlung Die folgende n Rate n wird werden wie eine zeitverz gerte Barzahlung en ausgef hrt PayZen 2 3 3 Die verschiedenen Zahlungsarten 7 F r den H ndler kann nur die erste Rate garantiert werden sofern das angefragte Vorlagedatum abh ngig vom jeweiligen Zahlungsmittel vor dem G ltigkeitsdatum der Autorisierung liegt siehe Abschnitt G ltigkeit einer Autorisierung weiter unten 3 4 Autorisierungsanfrage Von der Zahlungsplattform an den Aussteller der Karte gerichtete Nachricht um seine Zustimmung f r die Zahlung der Transaktion zu erhalten Allgemein ist die Belastung erst wirksam nachdem die Transaktion bei der Bank eingereicht wurde Bestimmte Aussteller von Prepaid Karten bzw von spanischen oder kanadischen Karten belasten den Betrag der Autorisierung in Echtzeit und schreiben ihn erst wieder gut wenn die Autorisierung fehlgeschlagen ist siehe nachstehende Tabelle G ltigkeit einer Aut
171. ture Business s gt Reserved Visa Business Enhanced Reserved Visa Infinite Reserved Reserved _ pa Reserved Visa Healthcare O rm 0a a Electron s O Visa Platinium a us s O Visa Gold Private Label Ss s zs OLAolO 192 Reserved W D m Proprietary Visa Purchasing 1 Visa Purchasing Visa Purchasing Visa Purchasing Government Services Loan Commercial Transport EBT MOC Business Loan s 7 Visa Distribution L Reserved Visa TravelMoney Visa VPay Reserved Reserved Reserved Reserved PayZen 2 3 16 Datenlexikon 106 MASTER CARD Beschreibung Beschreibung wee _ mSTERCARD UNKNOWN PRODUCT Kategorie Informationen zum Zahlungsmittel E vads birth_day Beschreibung Geburtstag des Inhabers Format n 2 Fehlercode 76 Kategorie Informationen zum Zahlungsmittel E vads_birth_month Beschreibung Geburtsmonat des Inhabers Format n 2 Fehlercode 77 Kategorie Informationen zum Zahlungsmittel E vads_birth_year Beschreibung Geburtsjahr des Inhabers Format n4 Fehlercode 78 Kategorie Informationen zum Zahlungsmittel E vads capture delay Beschreibung Gibt die Zeitspanne in Tagen vor dem Bank Kassenschnitt an Wenn dieser Parameter nicht bermittelt wird verwendet das System den im Back Office festgelegten Standardwert Dieser kann im Back Office durch alle Personen mit entsprechenden Berechtigungen festgelegt werden
172. uct_typeN den Wert f r den Artikeltyp ein O entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw we ooo o ee Wert HOME_AUDIO_PHOTO_VIDEO PayZen 2 3 8 Verwenden von erg nzenden Funktionen 52 Beschreibung Ton Bild und Video Artikel ein O entspricht dem Index des Artikels O f r den ersten 1 f r den zweiten usw ein Tabelle 12 Werte in Verbindung mit vads_product typeO Geben Sie in das Feld vads_product_labelN die Bezeichnung f r jeden im Einkaufskorb enthaltenen Geben Sie in das Feld vads_product_qtyN die Menge f r jeden im Einkaufskorb enthaltenen Artikel O entspricht dem Index des Artikels 0 f r den ersten 1 f r den zweiten usw Artikel ein O entspricht dem Index des Artikels O f r den ersten 1 f r den zweiten usw Geben Sie in das Feld vads_product_refN die Bestellnummer f r jeden im Einkaufskorb enthaltenen Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Beispiel eines Zahlungsformulars mit Beschreibung des Einkaufskorbs lt form method POST action https secure payzen eu vads payment gt lt LNPUT lt 1NPuT lt input lt input lt INPUT lt INPUT lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt INPUT lt LNPUT Zeemone lt input Sei non ke lt INPUT lt LNPUT
173. um K ufer Typ des K ufers string enum 92 PRIVATE COMPANY Informationen zum K ufer Anrede des K ufers z B Herr Frau an 63 17 Pflichtfeld f r 3xCB Cofinoga Informationen zum K ufer E vads cust zip Beschreibung Format Fehlercode Hinweis Kategorie E vads_cvv Beschreibung Format Fehlercode Kategorie PLZ des K ufers an 64 20 Pflichtfeld f r 3xCB Cofinoga Informationen zum K ufer Im Zahlungsauftrag Kartenpr fnummer bei stiller Zahlung In der Antwort Maskierte Kartenpr fnummer Die L nge kann je nach Karte 3 oder 4 Ziffern betragen n A 43 Informationen zum Zahlungsmittel u vads_effective_ amount Beschreibung Format Beispiele In der Antwort zur ckgegebenes Feld PayZen 2 3 16 Datenlexikon 115 Betrag der Zahlung in der W hrung die f r den Bank Kassenschnitt verwendet wird n 12 BEISPIEL F R EINEN SHOP BEI DEM DER KASSENSCHNITT IN EURO ERFOLGT Zahlung von 10 Euro Im Zahlungsformular gesendete Parameter vads_amount 1000 vads_currency 978 vads_amount 1000 vads_currency 978 vads_effective_amount 1000 PayZen 2 3 16 Datenlexikon 116 Zahlung von 10 US Dollar e vads _ amount 1000 e vads_currency 840 e vads amount 1000 e vads_currency 840 e vads_change_rate 1 3118 verwendeter Wechselkurs vads_effective_amount 762 vads_amount vads_change_rate Zahlungsmu
174. ung abgelehnt wird Code 02 Kartenherausgeber kontaktieren nachdem er auf Zur ck zum Shop geklickt hat ans 127 26 Weiterleitung zum Shop URL zu der der K ufer bei einer Ablehnung weitergeleitet wird nachdem er auf Zur ck zum Shop geklickt hat ans 127 25 Weiterleitung zum Shop URL zu der der K ufer standardm ig weitergeleitet wird nachdem er auf Zur ck zum Shop geklickt hat wenn die URLs vads_url_error vads_url_refused vads_url_success oder vads_url_cancel nicht ausgef llt sind Wenn das Feld nicht bermittelt wird ber cksichtigt das System die Konfiguration aus dem Back Office Es k nnen Back URL im Modus TEST und im Modus PRODUCTION konfiguriert werden Diese Felder sind als URL der R ckkehr zum Shop im Testmodus und URL der R ckkehr zum Shop im Produktionsmodus bezeichnet und k nnen ber das Men Optionen gt Shop gt Registerkarte Konfiguration aufgerufen werden Wird im Back Office oder im Formular keine URL festgelegt leitet die Schaltfl che Zur ck zum Shop den K ufer zur URL des Shops weiter Feld URL in der Konfiguration des Shops ans 127 28 Weiterleitung zum Shop PayZen 2 3 16 Datenlexikon 158 E vads url success Beschreibung URL zu der der K ufer bei einer erfolgreich ausgef hrten Zahlung weitergeleitet wird nachdem er auf die Schaltfl che Zur ck zum Shop geklickt hat Format ans 127 Fehlercode 24 Kategorie Weiterleitung zum Shop E vads_user_info
175. ut type hidden name vads version value V2 gt lt input type hidden name signature value 180b93e173b616490647099482ce9ed05325b33bb gt lt input type submit name bezahlen value bezahlen gt lt form gt Beispiel eines Zahlungsformulars f r Ratenzahlung Personalisierte Betr ge und Ratenf lligkeiten lt form method POST action https secure payzen eu vads payment gt lt input type hidden name vads action mode value INTERACTIVE gt lt input type hidden name vads amount value 3000 gt lt input type hidden name vads capture delay value 0 gt lt input type hidden name vads ctx mode value TEST gt lt input type hidden name vads currency value 978 gt mot lt input type hidden type hidden name vads page action value PAYMENT gt name vads payment config value eae T e te 20020 00 20a TE a a E gt lt input type hidden name vads site id value 12345678 gt lt input type hidden name vads trans date value 20140129130025 gt lt input type hidden name vads trans id value 130025 gt lt input type hidden name vads version value V2 gt lt input type hidden name signature value 86b2al7b9a5fcefb6c0120c57b25ec86ad1704ee gt lt LNPUT lt form gt type submit Dame Be onen value bezahlen gt PayZen 2 3 7 Erzeugen eines zahlungsformulars 45 7 4 Erstellen einer Autorisierung oh
176. vom Back Office aus Rechtsklick auf eine Transaktion gt URL der Benachrichtigung ausf hren BATCH_AUTO Der Wert BATCH_AUTO wird in den folgenden F llen versendet e Zeitverz gerte Zahlung in mehr als 7 Tagen e Raten einer Ratenzahlung au er der ersten Rate nur wenn der H ndler die Regel URL der Benachrichtigung bei Batch Autorisierung konfiguriert hat Die Benachrichtigung wird bei der Autorisierungsanfrage f r eine Zahlung versendet deren Status Wartet auf Autorisierung ist Der Wert REC wird bei Ratenzahlungen nur gesendet wenn der H ndler die Regel URL der Benachrichtigung zur Erstellung einer wiederkehrenden Zahlung konfiguriert hat MERCH_BO Der Wert MERCH_BO wird versendet e wenn ein Vorgang im Back Office ausgef hrt wird Erstattung nderung Best tigung Kopieren wenn der H ndler folgende Regel konfiguriert hat URL der Benachrichtigung bei einem Vorgang aus dem Back Office bei einer Stornierung im Back Office wenn der H ndler folgende Regel konfiguriert hat URL der Benachrichtigung bei Stornierung Tabelle 15 Mit dem Feld vads_url_check_src verbundene Werte Indem der Wert getestet wird kann das Skript abh ngig von der Art der Benachrichtigung eine spezifische Verarbeitung durchf hren Beispiel Wenn bei vads_url_check_src PAY oder BATCH_AUTO eingestellt ist aktualisiert das Skript den Status des Auftrags Wenn vads_url_check_src auf REC gesetzt ist ruft das Skript die Referenz der R
177. wartet kann der H ndler die Transaktion stornieren oder deren Betrag und oder das Datum des Bank Kassenschnitts ndern Diese Transaktionen erfolgen nach dem folgenden Statusschema Durchf hrung der Zahlung LET EE EEE L SEES ag 3 D Secure KO s e Authentifizierung y OK KO Lokale Kontrollen Fi Versendung von E Mail an K ufer Stornierung Wartet auf Best tigung und Autorisierung Best tigung Zu autorisieren T x vor dem angefragten T x vor dem angefragten Datum des Datum des Bank Kassenschnitts Autorisierungs anfrage OK Autorisierung angenommen Autorisierung angenommen Verfallen Bank Kassenschnitts Frist abgelaufen Stornierung Wartet auf l Stornierung Kassenschnitt Am Tag des angefragten Bank Kassenschnitts Vorgelegt PayZen 2 3 4 berblick ber den Ablauf einer Zahlung 19 Lebenszyklus einer Transaktion f r Ratenzahlung Die erste Rate einer Ratenzahlung verh lt sich zum angefragten Datum ihres Bank Kassenschnitts exakt wie eine Transaktion f r sofortige Barzahlung oder eine Transaktion f r zeitverz gerte Barzahlung Die folgenden Raten haben standardm ig den Status Zu best tigen und zu autorisieren solange die erste Rate vom H ndler nicht best tigt wurde Ihre Zahlung ist f r den H ndler nicht garantiert Die Bank des K ufers kann die Autorisierungsanfra
178. wie folgt RRULE FREQ MONTHLY COUNT 12 BYMONTHDAY 10 e Um Ratenf lligkeiten zu jedem Quartal bis zum 31 12 2016 festzulegen RRULE FREO YEARLY BYMONTHDAY 1 BYMONTH gt 1 4 7 10 UNTIL 20161231 Die Raten sind jeden 1 Januar April Juli und Oktober f llig Ihre Gesamtanzahl h ngt vom G ltigkeitsdatum der Ratenzahlung ab siehe Parameter vads_sub_effect_date Format string Fehlercode 64 Kategorie Informationen zur Ratenzahlung PayZen 2 3 16 Datenlexikon 148 u vads sub_effect_date Beschreibung Pflichtparameter bei der Erstellung von Ratenzahlungen mit dem ein Anfangsdatum f r die Ratenzahlung definiert werden kann Dieser Parameter entspricht nicht systematisch dem F lligkeitsdatum der ersten Rate das ausschlie lich vom Parameter vads_sub_desc abh ngt Das G ltigkeitsdatum gibt an wann die Ratenzahlung beginnt Das Format dieses Datums lautet AAAAMMJ Beispiel Verwenden Sie f r den 1 Februar 2015 den Wert 20150201 Format n8 Fehlercode 69 Kategorie Informationen zur Ratenzahlung E vads sub_init amount Beschreibung Optionaler Parameter der bei der Erstellung einer Ratenzahlung verwendet wird Sie stellt den Betrag der Raten der Ratenzahlung f r die ersten Raten dar Die Anzahl dieser ersten Raten wird durch den Parameter vads_sub_init_amount_number festgelegt Dieser Betrag ist in der im Parameter vads_sub_currency festgelegten W hrung und in ihrer unteilbaren Einheit Cent beim Euro angegeb
179. xikon 110 E vads_ctx_mode Beschreibung Pflichtparameter Gibt den Modus f r den Aufruf der Zahlungsplattform an Wirkt sich auf die Auswahl des Zertifikats aus Testzertifikat oder Produktionszertifikat das f r die Berechnung der Signatur verwendet wird Der Testmodus ist immer verf gbar auch nach der Erzeugung des Produktionszertifikats Wenn Sie einen neuen Shop erstellen oder ber eine Validierungsumgebung verf gen k nnen Sie Ihre Tests durchf hren ohne dass sie sich auf die gegenw rtig in der Produktion befindliche Site auswirken Format string enum Fehlercode 11 H ufige Fehler e Der Modus wurde nicht an die Zahlungsplattform gesendet e Verwenden Sie nicht den Code PROD anstelle von PRODUKTION e Geben Sie den Wert nicht in Kleinschreibung an test oder produktion Dieses Feld erwartet ausschlie lich Werte in Gro schreibung und keine Abk rzungen M gliche Werte TEST PRODUCTION Kategorie Technische Informationen PayZen 2 3 16 Datenlexikon 111 E vads currency Beschreibung Numerischer Code der f r die Zahlung zu verwendenden W hrung gem Norm ISO 4217 Um eine andere W hrung als den Euro 978 zu verwenden m ssen Sie die Aktivierung der Option Mehrere W hrungen beantragen Format n3 Fehlercode 10 a ISO 4217 ISO 4217 M gliche Werte W hrung W hrung Codierung Codierung Prod sen Jans a Kategorie Informationen zur Transaktion
180. xikon 99 u Personalisierung der Zahlungsseite Name des Feldes Format Beschreibung vads_available_languages Sprache1 Sprache2 Sprache3 Erm glicht die auf der Zahlungsseite verf gbaren Sprachen in Form einer Liste anzugeben vads_language a2 Legt die Sprache fest in der die Zahlungsseite angezeigt wird Norm ISO 639 1 vads_shop_name ans 127 Erm glicht den Namen des Shops zu definieren der in den E Mails f r die Zahlungsbest tigung angezeigt wird vads_shop_url ans 127 Erm glicht die URL des Shops zu ndern die auf der Zahlungsseite und in den E Mails f r die Zahlungsbest tigung angezeigt wird vads_theme_config Code1 Wert1 Code2 Wert2 Erm glicht die Personalisierung bestimmter Elemente der Zahlungsseite Tabelle 37 Parameterliste Personalisierung der Zahlungsseite u Weiterleitung zum Shop Name des Feldes Format Beschreibung vads_redirect_error_message ans 255 Automatische Weiterleitung Nachricht wird bei einer abgelehnten akzeptierten Zahlung vor der Weiterleitung zum Shop auf der Zahlungsseite angezeigt vads_redirect_error_timeout A Automatische Weiterleitung Frist in Sekunden vor der Weiterleitung zum Shop nach einer abgelehnten akzeptierten Zahlung vads_redirect_success_message ans 255 Automatische Weiterleitung Legt die Meldung im Fall einer angenommenen Zahlung bei einer automatischen Weiterleitung zum Shop fest vads_redirect_success_timeout n 3 Automatische Weiterleitung Z
181. zeichnet e Back URL zum Shop URL der sofortigen Zahlungsbest tigung IPN Instant Payment Notification Die Zahlungsplattform teilt dem Shop das Ergebnis der Zahlung automatisch mit Die Daten werden im Modus POST gesendet Die Plattform kann mit dem Shop unabh ngig von dessen genutztem Protokoll HTTP oder HTTPS eine Verbindung herstellen Zur Bearbeitung der Benachrichtigungen muss der Verk ufer auf seiner Website eine Seite mit den folgenden Funktionen einrichten e Analyse der im Modus POST empfangenen Daten e Integrit tspr fung der empfangenen Daten anhand der Signatur e Pr fung auf doppelte Benachrichtigungen z B erneute Versendung einer Benachrichtigung vom Back Office e Automatische Aktualisierung der H ndlerdatenbank Auftragsstatus Lagerbestand usw e Versand von E Mails an den K ufer Rechnung Auftragsverfolgung usw Die Bearbeitungszeit hat direkte Auswirkungen auf die Anzeigegeschwindigkeit der bersichtsseite zur Zahlung Je l nger die Bearbeitung dauert umso sp ter erfolgt die Anzeige Zum Empfangen der Benachrichtigungen angenommene oder abgelehnte Zahlung muss der Verk ufer die Benachrichtigungsregeln von seinem Back Office aus konfigurieren siehe Kapitel Benachrichtigungseinstellungen Im Falle eines Kommunikationsproblems auf H ndlerseite wird von der Zahlungsplattform automatisch eine E Mail an den Administrator des Gesch fts gesendet Diese enth lt Informationen ber die Fehle
182. zu ndern Verwenden Sie das Schl sselwort SUCCESS_FOOTER_MSG_RETURN um die Beschriftung der Schaltfl che Zur ck zum Shop zu ndern die im Fall einer angenommenen Zahlung angezeigt wird Verwenden Sie das Schl sselwort CANCEL_FOOTER_MSG_RETURN um die Beschriftung der Schaltfl che L schen und Zur ck zum Shop zu ndern die auf den verschiedenen Zahlungsseiten angezeigt wird Berechnen Sie den Wert des Feldes signature anhand aller Felder Ihres Formulars deren Name mit vads_ beginnt siehe Kapitel Berechnen der Signatur Mit der Option Fortgeschrittene Personalisierung k nnen Sie die Beschriftungen bearbeiten Beispiel Shop die auf der Zahlungsseite angezeigt wird N here Informationen finden Sie im Benutzerhandbuch f r die erweiterte Personalisierung das Sie auf der Dokumentationswebsite unter https www de payzen eu payzen dokumente finden Beispiel eines Zahlungsformulars das die Beschriftung der Schaltfl che Zur ck zum Shop ndert lt form method POST action https secure payzen eu vads payment gt lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden value CANCEL FOOTER name ado aet on mode va ue T NTERACTI ET name vads amount value 4000 gt name vads capture delay value 0 gt nam
183. zwei AMEX Vertr ge 949400444000 und 949400444001 Zur Angabe des Vertrags der f r diese beiden Netze benutzt werden soll muss bei vads_contracts Folgendes eingegeben werden vads_contracts VISA 1231231 AMEX 949400444000 Beispiel eines Zahlungsformulars das den zu verwendenden H ndlervertrag festlegt lt form method POST action https secure payzen eu vads payment gt mot lt 1NPuUT lt inNpuT lt lt nayenbie lt input lt input lt inmpnt lt input lt input Simone lt input lt input lt input lt input lt form gt type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type submit name vads action mode value INTERACTIVE gt name vads amount value 4000 gt name vads capture delay value 0 gt name vads ctx mode value TEST gt name vads_contracts gt name vads currency value 978 gt name vads page action value PAYMENT gt name vads payment config value SINGLE gt name vads site id value 12345678 gt name vads trans date value 20140327145218 gt name vads trans id value 571381 gt name Nvadsiversionl value NvD7 7 2 name signature value 7896adcaaf7336839030469715afal2353313 f42 gt name bezahlen value Bezahlen gt PayZen 2 3 8 Verwenden von erg nzenden Funktionen 55 8 7 Einrichten d

Implementation_Guide_Zahlungsformular_PayZen_V2.3

Contents

Download Pdf Manuals

Related Search

Related Contents