What is a mandate?
In PayTo, a Mandate (or PayTo Agreement) is the core component that defines the terms under which payments are authorised. It is a consent mechanism that allows a business to request payments directly from a customer’s bank account according to the agreed terms.
Fileactive PayTo API capabilities for mandates:
-
Create mandate: Establish a new PayTo mandate that defines how and when payments can be made.
-
Amend mandate: Modify the existing mandate details, such as updating payment terms or conditions.
-
Change mandate status: Manage the status of mandates, including activating, suspending, or cancelling them.
-
Fetch detailed information about mandates on-demand: Fetch detailed information about mandates for monitoring or compliance purposes.
-
Query resolution: Handle queries related to mandates, ensuring clarity and support for mandate-related transactions.
Where mandates fit in the PayTo process flow:
The diagram below illustrates the steps involved in the PayTo process and highlights where mandates play a critical role:
Key points for developers:
-
Mandate creation: This is a pivotal step where the terms of payment are set up, allowing for clear authorisation and control over transactions.
-
Mandate management: Once a mandate is created, it can be amended or its status can be changed, providing flexibility to adjust to business needs.
-
Integration tips: Utilize the API endpoints to automate the creation, management, and retrieval of mandates, ensuring a seamless integration into your payment processes.
-
Webhooks for real-time updates: Integrate webhook notifications to stay updated on changes to mandates and other related events, keeping your systems aligned with payment activities.