Internal book transfers are now included as a payment scheme in the API

What’s changing?

We’re separating out Book transfers and Faster Payments (FPS) in our API payment schemes. From 1st July 2025, you’ll need to specify which scheme you’d like to use for your payments.

The API changes are as follows:

• Submissions: the payment-scheme ENUM in submissions now has book-transfer

• Response body for submissions: we’ll now provide submission-scheme-information including payment-scheme. This ENUM will include book-transfer

• Response body for admissions: we’ll also provide admission-scheme-information including payment-scheme. This ENUM will include book-transfer

Reminder: what are book transfers

Book transfers are payments that can be made between two bank accounts that are both within your Griffin organisation. Book transfers happen on our ledger and don’t go through an external payment rail like FPS. Book transfers are also sometimes referred to as internal transfers.

Action required

By the 1st July 2025, in API payment submissions, you’ll need to specify either book-transfer or fps.

Why are you adding book transfers as a new scheme?

Currently, we send all payments via FPS, even those that could have been book transfers. We’re now adding book transfers as its own scheme because they are typically quicker than FPS and they don’t need clearing and settlement. However, book transfers are not subject to the same scheme rules that rails like FPS operate under. Therefore, we want to make it your choice how you send specific payments.

Will this impact pricing and billing?

This will not impact your prices, but it could impact the way you’re billed:

• Until 1st July 2025, there is no change to your billing. You’ll continue to be billed the lower book transfer price for FPS payments between two accounts within your Griffin organisation

• After 1st July 2025, if you specify fps in payment submissions, an FPS payment will be made even if the payment is between two accounts within your Griffin organisation. As this will now use the FPS rail, you will be billed at your agreed rate for FPS payments.

What happens if I send a book transfer to a non-Griffin account?

The payment will be rejected.

Find out more about book transfers in our updated documentation guide linked here.

Thanks for reading!

Ready to explore? Sign up for our sandbox to start testing.

Need help? Chat with us in-app or email product@griffin.com.

Stay connected:

 Read our docs

 Join our Slack community

Try our Postman collection

 Follow us on LinkedIn