Upload mandates
Upload a file of mandate records for bulk creation or import through the DebiPay mandates API.
Query Parameters
>= 0, <= 36Use this endpoint to upload a file containing mandate data for bulk processing. It is helpful when you need to import a large number of mandates from a file rather than submitting them one-by-one through the create endpoint.
This operation is designed for batch import scenarios and includes the merchant identifier and idempotency key as request parameters.
Typical use cases
- Bulk import mandates from an external system.
- Upload a backlog of mandate records for a merchant.
- Process large-scale onboarding activities without individual API calls.
Request details
The request uses a multipart form upload with a file field named File. The API also accepts MerchantId and IdempotencyKey as query parameters to help you manage large imports safely.
Response handling
The API returns a confirmation that the upload was accepted and the import process was initiated. You can review the resulting mandate records using the mandate collection and detail endpoints.
Use the IdempotencyKey when you want to retry the same upload without accidentally creating duplicate mandate records.