Developer Docs

Developer Docs

  • Getting Started
  • SubscriptionJS
  • REST API
  • Webhooks
  • Code Samples
  • UseCases
  • Request a Demo

›Payment

General

  • Introduction
  • Security & Reliability

Customer and Contract

  • Order Succeeded
  • Contract Created
  • Contract Changed
  • Contract Data Changed
  • Contract Deleted
  • Contract Cancelled
  • Customer Created
  • Customer Changed
  • Customer Deleted
  • Customer Locked
  • Customer Unlocked
  • Dunning Created
  • Invoice Created
  • Invoice Corrected
  • Recurring Billing Approaching
  • Trial End Approaching
  • AccountCreated (deprecated)

Payment

  • Payment Bearer Expiring
  • Payment Bearer Expired
  • Debit Auth Cancelled
  • Payment Data Changed
  • Payment Escalated
  • Payment Escalation Reset
  • Payment Succeeded
  • Payment Failed
  • Payment Process Status Changed
  • Payment Registered

Plan

  • Plan Created
  • Plan Changed
  • Plan Deleted

Planvariant

  • Planvariant Created
  • Planvariant Changed
  • Planvariant Deleted

Components

  • Component Created
  • Component Changed
  • Component Deleted

Reporting

  • Report Succeeded
  • Report Failed
  • Accounting Export File Created

Payment Bearer Expiring

This webhook notifies you about a payment bearer that is due to expire soon (typically a credit card). You probably want to inform your customer and ask them to provide new payment information. This hook will be triggered even for contracts that have ended, but you can filter such contracts in your webhook handler.

Typical Scenario

The credit card expires in one month and you want to show the customer a notification, that the current payment method will be invalid shortly.

HTTP/1.1
POST /billwerk-hook
Host: example.com
Content-Type: application/json

{
    "Event" : "PaymentBearerExpiring",
    "ContractId" : "51d970c8eb596a1168df119a",
    "ExpiryDate" : "2013-12-22T11:11:11Z"
}
Last updated on 2/25/2020 by Robert Ohlig
← AccountCreated (deprecated)Payment Bearer Expired →
Docs
Getting StartedAPI Reference
Resource
Help CenterSupportBlogTutorials
Start with billwerk
Test for free
Request a Demo
Already started?
billwerk Sandboxbillwerk Production
billwerk GmbH
© Made with ❤ in Germany for Europe by billwerk GmbH | 2022
Imprint
|
Data Privacy Rules
|
Disclaimer