Bei PAYMILL ist es neben einmaligen Zahlungen auch möglich Abonnements zu erstellen. Dies hat für den Seitenbetreiber den Vorteil, dass ohne erneute Nachfrage die z.B. monatlich aufgelaufenen Kosten problemlos von der angegebenen Kreditkarte oder per ELV abgebucht werden können, ohne eine erneute Authorisierung des Kunden zu erhalten.
Abonnements kannst du in deinem Händler Cockpit erstellen und verwalteten. Alternativ kannst du die PAYMILL API verwenden, um Abonnements über deine Webseite zu generieren. Hier das passende Code-Beispiel:
curl https://api.paymill.com/v2/offers \
-u 282dbb1313587ea5d8dd71c7f7ac1b27: \
-d "amount=4200" \
-d "currency=EUR" \
-d "interval=1 MONTH" \
-d "name=Test Offer"
Jedes Abonnement erhält eine eindeutige ID, die du dann über die API Referenz ansprechen kannst.
Die erste Zahlungsanweisung eines Abonnements wird mit entweder nur dem CVC oder aber zusätzlich mit einer 3-D Secure Abfrage stattfinden. Diese Verifikation der Kreditkartendaten ist auch wenn das Abonnement eine Trialperiode von n Tagen hat direkt beim Abschluß des Kunden zu.
Hier der Code, um einen Kunden in PAYMILL zu erstellen, dem ein Abonnement zugewiesen werden kann:
curl https://api.paymill.com/v2/clients \
-u 282dbb1313587ea5d8dd71c7f7ac1b27: \
-d "email=lovely-client@example.com" \
-d "description=Lovely Client"
Um ein existierendes Abonnement für einen speziellen Kunden zu ändern (z.B. aus Gründen der Abrechnung), musst du aktuell vorerst das existierende Abo löschen und dann dem Kunden neu zuweisen. Der Restbetrag vom alten Abonnement muss dem Kunden dann natürlich gutgeschrieben werden, die Gutschrift muss aber in der Logik deines Shops erfolgen und nicht über uns.
Wir arbeiten gerade mit Hochdruck daran dieses Feature bei uns zu integrieren, damit es für dich einfacher funktioniert.
Kunden sind bei Abonnements eine zweite wichtige Komponente. Sie müssen mit einem Abonnement verknüpft werden. Die Zuordnung zu einem Abonnement kannst du ganz leicht über unsere API Referenz erstellen.
Ebenso kann einem existierenden Kunden ein weiteres Abonnement zugeordnet werden. Hier ein Beispiel:
curl https://api.paymill.com/v2/subscriptions \
-u 282dbb1313587ea5d8dd71c7f7ac1b27: \
-d "client=client_64b025ee5955abd5af66" \
-d "offer=offer_40237e20a7d5a231d99b" \
-d "payment=pay_95ba26ba2c613ebb0ca8"
Die ID, die beim Anlegen des neuen Kunden erstellt wurde, muss in deinem eigenen System gespeichert werden, um später mit PAYMILL kommunizieren und Operationen ausführen zu können.
Über das Händler Cockpit wären die Schritte folgende:
Kundenabonnements werden über folgenden simplen API Request gekündigt:
curl https://api.paymill.com/v2/subscriptions/sub_dc180b755d10da324864 \
-u 282dbb1313587ea5d8dd71c7f7ac1b27: \
-X DELETE
Mehr Infos zu Rückerstattungen und weitere Änderungen findest du in unserer API Referenz.
Um ein Abonnement zu löschen, musst du erst Schritt 4, das Abo kündigen, erledigt haben. Du kannst Abonnements mit folgendem Code-Beispiel löschen:
curl https://api.paymill.com/v2/offers/offer_40237e20a7d5a231d99b \
-u 282dbb1313587ea5d8dd71c7f7ac1b27: \
-X DELETE
Sollten für dich noch offene Fragen bestehen, kannst du dir gerne unsere API Referenz anschauen oder dich in unseren FAQs umsehen.
Mit unserer v2 ist es Dir nun auch möglich existierende Abonnements zu ändern und die Daten entsprechend zu editieren.
curl https://api.paymill.com/v2/subscriptions/sub_dc180b755d10da324864 \
-u 90365b70518d8d3101af0e1e8d3413d5: \
-d "cancel_at_period_end=true" \
-d "offer=offer_40237e20a7d5a231d99b" \
-d "payment=pay_95ba26ba2c613ebb0ca8" \
-X PUT
Schau Dir diese Funktion genauer im Händler Cockpit an.