New payments admissions and submissions endpoints now live

DATE: December 20, 2023

AUTHOR: The Product team at Griffin

What’s changed?

We recently released our new Payments API data model and webhook payment events. These changes were made to improve compatibility with Faster Payments and to future proof it for new schemes on our roadmap.

Following on from our recent release, we have added new endpoints: List bank account submissions and List bank account admissions. These endpoints can be used to get the processing status of all admissions (inbound payments) associated with a bank account and all submissions (outbound payments) associated with a bank account. They also provide scheme-specific data.

Additionally, we have added: List payment submissions and List payment admissions. These endpoints can be used to track the status and scheme-specific data of a specific payment.

We have also renamed our submissions and admissions payment webhook event types to keep consistent with the rest of our API.

How will this affect existing integrations?

Breaking changes

Our webhook event types have changed from:

payment-submission-created to submission-created
payment-submission-updated to submission-updated
payment-admission-created to admission-created
payment-admission-updated to admission-updated

Anywhere you use the old webhook event types, these will need to be updated to our new webhook event types which are now live. The response payload will remain the same.

New additions

We have added four new endpoints:

List bank account submissions - returns a list of all submissions originating from a given bank account
List bank account admissions - returns a list of all admissions associated with a given bank account
List payment admissions - lists admissions for a payment
List payment submissions - lists submissions for a payment

To learn more about our Payments API, check our API reference.

Why have we done it?

This update provides more flexibility in getting the status of a payment and makes it possible to query all admissions and submissions associated with a given bank account.

Thanks for reading! You'll be hearing from us again soon.

In the meantime, you can start testing our products right away when you sign up for our sandbox.

If you need support, feel free to reach out through our in-app chat or send a message to product@griffin.com.

We’re always working to improve our products and enhance your experience. Stay tuned for more updates!

Check out our docs

Join our developer Slack community

Experiment with Postman