Home Webhooks ermöglichen es, Ihre Anwendung über Zustandsänderungen von Entitäten wie Zahlungstransaktionen oder Abonnements zu benachrichtigen. Obwohl Webhooks für viele Zwecke verwendet werden können, sind sie besonders wichtig bei der Verwendung von Abonnements, bei denen die meiste Aktivität asynchron und im Hintergrund stattfindet.
Unser Konzept ist, dass wir alles abwickeln, und das Einzige, worum Sie sich kümmern müssen, ist das Aktivieren, Pausieren und Beenden des Dienstes auf Ihrer Seite. Das bedeutet, dass Sie auf die Zustandsänderungen von Abonnements reagieren sollten. Webhooks sind der einfachste Weg, dies zu erreichen, da sie Sie automatisch informieren, wenn auf Ihrer Seite eine Änderung erforderlich ist.
Werfen Sie zunächst einen Blick auf unseren allgemeinen Webhook-Leitfaden. Nachfolgend finden Sie zusätzliche Informationen zur Verwendung von Webhooks mit Abonnements.
Ein Zahlungsfehler kann ein vorübergehendes Problem sein (die Bank hat diese Belastung abgelehnt, erlaubt aber möglicherweise den automatischen Wiederholungsversuch) oder auf ein dauerhaftes Hindernis hinweisen, etwa das Fehlen einer verwendbaren Zahlungsquelle. Dies geschieht automatisch, wenn Sie Charge Flows verwenden. Dort können Sie auch festlegen, wie wir den Abonnenten kontaktieren.
Wenn Sie die Option Email Delivery am Produkt aktiviert haben, informieren wir den Kunden auch über Zustandsänderungen am Abonnement selbst. Das heisst, wir schreiben E-Mails über das Beenden eines Abonnements oder das Aussetzen eines Abonnements.
Wenn Sie es vorziehen, den Abonnenten selbst zu informieren, können Sie auf die entsprechenden Zustandsänderungen am Abonnement reagieren.
Abonnements erfordern mehr Koordination zwischen Ihrer Anwendung und unserer Plattform als Einmalzahlungen. Im Abonnementmodell wird der fortgesetzte Zugang eines Kunden zu Ihrem Produkt oder Dienst durch den Erfolg oder das Fehlschlagen automatischer, wiederkehrender Zahlungen bestimmt. Nehmen Sie zum Beispiel eine Website, bei der ein Abonnement Zugang zu den Inhalten der Website gewährt.
Sie werden benachrichtigt, wenn ein Abonnement active, suspended oder terminated ist. Es gibt weitere Zustände
des Abonnements. Die genannten drei Zustände sind jedoch die relevanten, auf die Sie reagieren sollten.
-
activebedeutet, dass das Abonnement aktiv ist und der Dienst auf Ihrer Seite ebenfalls aktiviert werden sollte. -
suspendedbedeutet, dass das Abonnement auf Ihrer Seite pausiert werden sollte (d. h. wenn Sie Ihren Abonnenten Videos anbieten, sollten Sie verhindern, dass sie die Filme sehen, sobald Sie diesen Status im Webhook-Aufruf erhalten. Sie möchten ihnen jedoch möglicherweise weiterhin erlauben, sich in Ihr System einzuloggen, da Sie sie darüber informieren möchten, dass das Abonnement ausgesetzt wurde). -
terminatedbedeutet, dass das Abonnement nicht mehr abgerechnet wird und der Dienst daher dauerhaft eingestellt werden sollte. Dies ist zum Beispiel der Auslöser, um das Konto in Ihrem System zu schliessen.