Create a collection

Changed on Nov 3, 2026

Create a Direct Debit collection against a mandate_id to collect payments from the customer's bank account.

post/payments/collections

Request

Base URL
https://test-api.acquired.com/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/acquired/apis/acquired-api/docs/payments/collections/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

Company-Idstring uuid

Unique ID assigned by Acquired.com for your company.

Midstring uuid

Unique ID assigned by Acquired.com connecting to a specific acquiring bank.

Request body

Example request

{
  "transaction": {
    "order_id": "1f1f2a61-5b68-4725-a0ce-9560514ec00b",
    "amount": 15.02,
    "currency": "GBP",
    "custom_data": "L3BheW1lbnQtbGlua3MgcGF5IGN1c3RvbV9kYXRh",
    "custom1": "4f0a0e0d-a407-46d8-841a-3409831d69a3",
    "custom2": "eb031f5b-9c34-4101-8dea-269ca88fcadb"
  },
  "payment": {
    "mandate_id": "18456786-5d7a-44a6-a4cb-aaaf95590f87",
    "charge_date": "2024-08-05"
  }
}

Response

Created

status'pending'

All Direct Debit collections will initially reside in a pending status, we will then send webhook notifications to inform you of the subsequent statuses.

transaction_idstring uuid

Unique identifier assigned by Acquired.com for the transaction record.

Example response

{
  "status": "pending",
  "transaction_id": "bd3fbbcd-411e-4760-8a9f-7af420d26314"
}

Changes

Nov 3, 20269c9e8ec96e98 Revision changes
- breaking
  removed the enum value aed of the request property /
- breaking
  removed the enum value aud of the request property /
- breaking
  removed the enum value cad of the request property /
- breaking
  removed the enum value chf of the request property /
- breaking
  removed the enum value cny of the request property /
- breaking
  removed the enum value dkk of the request property /
- breaking
  removed the enum value eur of the request property /
- breaking
  removed the enum value gbp of the request property /
- breaking
  removed the enum value hkd of the request property /
- breaking
  removed the enum value jpy of the request property /
- breaking
  removed the enum value mxn of the request property /
- breaking
  removed the enum value sek of the request property /
- breaking
  removed the enum value usd of the request property /
- breaking
  removed the enum value zar of the request property /
- info
  added the new GBP enum value to the request property /

Operation history