IT Docs

Unterstützte Plugin Versionen & API Docs

• Plugins für Kauf auf Rechnung / Raten
  Magento 1.9
  Magento 2.3+
  PrestaShop 1.7, V8
  Shopify
  Shopware 5
  Shopware 6
  WooCommerce
  SmartStore
  ConcertoPro
  JTL 5
  
• API Docs für Lösungen ideal BILLING+ und ideal RISK&COLLECT
  Für Direktintegrationen können auch direkt unsere REST API's eingebunden werden.
  ‍
  Schnittstelle für Bonitätsprüfung (CreditCheck):
  Risk API
  
  Schnittstelle für Rechnungsübermittlung:
  Invoice API
  
  Schnittstelle für Ratenübermittlung:
  RateVoucher API
  
  Schnittstelle für Shop-System integrierte Stornos:Reversal API
• Generelle Anforderungen an die direkte Implementation unserer APIs (ohne Plugin)
  ‍1) Sofern die Zahlungsgarantie im Vertrag inkludiert wird, muss zwingend für jede übermittelte Rechnung ein passender, positiver CreditCheck vorhanden (Green / 1) sein. Ansonsten ist die Ideal Payment AG von der Verpflichtung zur Übernahme der entsprechenden Forderung befreit. Dies gilt ebenso für Bestellungen mit abweichender Lieferadresse. Dabei muss auch sichergestellt werden, das pro (versuchter) Bestellung gegen Rechnung nur ein API Request ausgeführt wird.
  2) Sofern nichts anderes vereinbart wurde, muss die Bonitätsprüfung so integriert werden, dass sie bei Bestellabschluss getriggert wird (sog. nachgelagert). Dementsprechend werden Rechnung oder Raten als Zahlungsoption immer angezeigt. Bei Bestellabschluss gegen Rechnung/Raten wird der Kunde bei negativem Entscheid zurück auf die Zahlungsauswahl geleitet und mit einer einfachen Message über die Nicht-Verfügbarkeit der Zahlungsoption informiert. Dies hängt mit der künftigen, Schweizer Angleichung der DSGVO Vorgaben zusammen.
  3) Bei einer Direktintegration (ohne Plugin) liegt die Weiterverrechnung der Billing-Gebühr gem. Vertrag in der Verantwortung des Händlers. Dies gilt sowohl für die aggregierte Übermittlung an unsere InvoiceAPI (Gebühr als Artikelzeile), als auch für die transparente Anzeige im Checkout (direkt im Warenkorb verrechnen für max. Transparenz).
  4) Um alle neuesten Funktionen unseres Systems nutzen zu können muss bei der Rechnungsübermittlung der "/CreateNumber" Request integriert werden.
  5) Bestellungen bei denen die Lieferadresse von der Rechnungsadresse abweicht sind zwingend zu verhindern, sofern die Zahlungsgarantie im Rahmen des Vertrags bezogen wird. Um dies sicherzustellen muss zwingend beim RiskAPI Request im Feld "deliveryAddress" [True] übermittelt werden, sofern die Lieferadresse abweicht. So kann die Bestellung über die Response der RiskAPI, gemäss den vereinbarten Bedingungen, auf unserer Seite verhindert werden.
  6) Anpassungen der Implementation müssen auf Aufforderung der Ideal Payment AG innert 3 Werktagen umgesetzt werden. Ansonsten steht es der Ideal Payment AG frei, die Lösung zwischenzeitlich zu deaktivieren. Dies ist insbesondere dann der Fall, wenn Aktionen entgegen den Vertragsbedingungen oder den Anforderungen der Lösung umgesetzt werden.
  7) Generell gilt es bei allen verfügbaren API Feldern möglichst viel der gefragten Informationen zu übermitteln. So kann der maximal mögliche Funktionsumfang in Bezug auf unsere Features sichergestellt werden.
  8) Sämtliche Risiken und Kosten sind, sofern nicht anders vereinbart, beim Entwickler der Schnittstelle. Sofern kundenseitig integriert wird, haftet entsprechend der Händler bzw. dessen IT Partner für allfällige Entwicklungsfehler.
  
• Unterstützte Datenformate für Inkassoabtretungen
  API, FTP oder SFTP Übermittlung
  Einfaches Excel oder CSV File
  PDF Belege