CHcheckout
Bacs Direct Debit

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.

post/apms/bacs/notifications

Request

Request body

source_idstring required

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

notification_type'advance_notice' required

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

collection_datestring date required

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

amountinteger required

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

currencystring required

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

referencestring

A reference you can use to identify the collection.

customer_emailstring email required

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

billing_descriptorstring required

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

support_emailstring email required

The support email address included in the pre-notification.

support_phonestring

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

Example request

{
  "source_id": "src_wmlfc3zyhqzehihu7giusaaawu",
  "notification_type": "advance_notice",
  "collection_date": "2026-07-15T00:00:00.0000000",
  "amount": 4999,
  "currency": "GBP",
  "reference": "INV-12345",
  "customer_email": "customer@example.com",
  "billing_descriptor": "CHECKOUT",
  "support_email": "support@test.com",
  "support_phone": "+447700900123"
}

Response

Pre-notification created successfully

event_idstring required

The unique identifier of the notification event.

Example response

{
  "event_id": "evt_lzr4csdtddwetactr6phd3kea4"
}

Changes

No recorded changes to this operation across all 1 revision of this API.