Checkout.com API logo

Bacs Direct Debit

Send Bacs Direct Debit pre-notifications to payers ahead of collecting funds.

Send a Bacs Direct Debit pre-notification

Send a Bacs Direct Debit pre-notification (advance notice) to a payer ahead of collecting funds from their account.

SecurityAPI Key: ApiSecretKey
Request
Request Body schema: application/json
source_id
required
string^(src)_(\w{26})$

The ID of the Bacs Direct Debit instrument to notify against.

notification_type
required
string

The type of pre-notification being sent to the payer.

Value: "advance_notice"
collection_date
required
string <date>

The date the funds will be collected from the payer's account, in the format yyyy-MM-dd.

amount
required
integer <int64> >= 1

The amount to be collected, in the currency's minor unit.

currency
required
string = 3 characters

The three-letter ISO 4217 currency code of the collection.

billing_descriptor
required
string <= 25 characters

The billing descriptor that appears on the payer's bank statement.

customer_email
required
string <email>

The email address of the payer that the pre-notification is sent to.

support_email
required
string <email>

The support email address included in the pre-notification.

reference
string <= 50 characters

A reference you can use to identify the collection.

support_phone
string

The support phone number included in the pre-notification, in E.164 format.

Responses
201

Pre-notification created successfully

401

Unauthorized

422

Invalid data was sent

post/apms/bacs/notifications
Request samples
application/json
{
  • "source_id": "src_wmlfc3zyhqzehihu7giusaaawu",
  • "notification_type": "advance_notice",
  • "collection_date": "2026-07-15",
  • "amount": 4999,
  • "currency": "GBP",
  • "reference": "INV-12345",
  • "customer_email": "customer@example.com",
  • "billing_descriptor": "CHECKOUT",
  • "support_email": "support@test.com",
  • "support_phone": "+447700900123"
}
Response samples
application/json
{
  • "event_id": "evt_lzr4csdtddwetactr6phd3kea4"
}
➔ Next to Google Pay