Skip to main content

Create a Payment Run

Enable your customers to create and manage payment runs within your product using the API.

Pre-requisites

Before buyers can create payment runs, they must:

To create a payment run your customers must provide a list of payments which include the paymentAmount and supplier bank details where the payment is to be made.

Roles & Permissions

A payment run can be created by a user who has the Creator role. Learn more about the different roles in our guide.

The API endpoint will return the unique id for the created payment run with a PENDING_CONFIRMATION as a status. If you are subscribed and watching the payment run events you will also receive an event with the status update.

Learn how to confirm and authorise a payment run, by reading the guide.

Maximum number of payments in a payment run

A payment run can contain no more then 1,000 payments. If you have a payment run that contains more then 1,000 transactions you will have to create another payment run.