Api steuert die Bezahlung per Lastschrift. Neuerungen SEPA: Mit SEPA ( Single Euro Payments Area ), dem einheitlichen Euro-Zahlungsverkehrsraum, werden auch in Deutschland zum 01.02.2014 neue, europaweit einheitliche Verfahren für den bargeldlosen Zahlungsverkehr (Überweisungen, Lastschriften) eingeführt. Das bisheriege Verfahren mit Bankleitzahl und Kontonummer wird durch IBAN und BIC abgelöst. IBAN (International Bank Account Number) ist die internationale Kontonummer und ersetzt Bankleitzahl und Kontonummer. Für grenzüberschreitende Zahlungen ist noch der BIC (Business Identifier Code) als international standardisierter Bank-Code (vergleichbar mit der Bankleitzahl in Deutschland) erforderlich. Für Zahlungen / Lastschriften innerhalb Deutschlands reicht die Verwendung der IBAN (iban only) aus, für alle anderen Transaktionen wird IBAN und BIC benötigt. Für eine ordentliche SEPA-Zahlung sind noch folgende Punkte wichtig: Mandate (mandateRef), Gläubiger-ID (creditorId) und Prenotification (Nachricht über die Kundenbelastung; payDate). Mandate: Parametername "mandateRef" Ein Mandat ist die Ermächtigung des Zahlungsempfängers durch den Zahlungspflichtigen mit einer Lastschrift vereinbarte Beträge abzubuchen. Die Mandatsreferenz wird durch den Zahlungsempfänger frei vergeben und muss eindeutig sein. In der Regel wird sie durch die Debit-API erstellt, siehe Rückgabe bei "sessionCreate". Sie kann aber auch frei definiert werden. Gläubiger-ID: Parametername "creditorId" Die Gläubiger-Identifikationsnummer ist eine eindeutige Identifizierung für Zahlungsempfänger von SEPA-Mandaten. Sie ist für jeden Zahlungsempfänger verpflichtend und kann bei der Bundesbank kostenlos beantragt werden, siehe https://extranet.bundesbank.de/scp/ . Die Gläubiger-ID ist im ControlCenter unter Kundendaten->Gläubiger-Identifikationsnummer hinterlegt. Alternativ wird die Gläubiger-ID von micropayment bereitgestellt. Prenotification: Der Endkunde muss vor der Belastung (siehe auch "payDate") in geeigneter Weise informiert werden. Ein geeigneter Textvorschlag kann wie folgt aussehen (wobei die Platzhalter in {} durch die tatsächlichen Werte ersetzt werden müssen) "Unsere Forderung in Höhe von {$amount} ziehen wir mit der SEPA-Lastschrift zum Mandat Nr. {$mandateRef} zu der Gläubiger-Identifikationsnummer {$creditorId} von Ihrem Konto IBAN {$iban} bei der {$bank} BIC {$bic} zum Fälligkeitstag {$payDate} ein. Wir bitten Sie für Kontodeckung zu sorgen." ------------------------------------------------------------------------------------ Alle Funktionen die bisher mit Bankleitzahl/Kontonummer aufgerufen wurden, können jetzt alternativ mit IBAN/BIC bedient werden. Bei Aufrufen ohne IBAN ist der Parametername "country" wichtig. Fehlercodes: 4101 // Bankleitzahl ist ungültig 4102 // Kontonummer ist ungültig 4103 // Es wurde keine Kontoverbindung hinterlegt 4104 // Vorgang wurde bereits bestätigt 4105 // Kontoverbindung wurde gesperrt 4106 // Limit erreicht 4107 // kein offener Betrag oder übersteigt Sessionbetrag 4108 // iban ist ungültig 4109 // Land ist ungültig ------------------------------------------------------------------------------------ Hinweise zum TestModus: - Aktivierung der Testumgebung erfolgt in der jeweiligen Funktion über den Parameter `testMode=1` - um automatisierte interne Prozesse und Ereignisse zu simulieren, stehen die ...Test-Funktionen zur Verfügung. Um eine vollumfängliche Lastschrift mit allen Eventualitäten zu simulieren sind folgende Funktionsaufrufe sinnvoll: customerCreate (Kunden anlegen) bankaccountSet (Bankverbindung anlegen) sessionCreate (Bezahlvorgang erzeugen) sessionApprove (Lastschrift bestätigen) sessionChargeTest (Abbuchung simulieren) sessionReverseTest (Rücklastschrift simulieren) sessionRechargeTest (Nachzahlung simulieren) transactionCreate (Nachzahlung auf eig. Konto verbuchen) sessionRefund (Rücküberweisung) sessionRefundReverseTest (Retour der Rücküberweisung simulieren) - für den TestModus steht neben allen regulären, folgende Test-Bankverbindung zur Verfügung, um erfolgreiche Buchungen zu simulieren: bankCode: 88888888 accountNumber: z.B: 1234567890 iban: z.B: DE89888888881234567890 bic: TESTDE00XXX (optional)