---
title: "Create a collection"
method: POST
path: "/payments/collections"
tags: ["Direct Debit"]
---

# Create a collection

`POST /payments/collections`

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

## Headers

- `Company-Id` string, uuid
- `Mid` string, uuid

## Request body

- object
  - `transaction` object
    - `order_id` string, required — Unique reference assigned by you for the payment request.
    - `amount` number, float, required — The total amount you want to charge.
    - `currency` 'aed' | 'aud' | 'cad' | 'chf' | 'cny' | 'dkk' | 'eur' | 'gbp' | 'hkd' | 'jpy' | 'mxn' | 'sek' | 'usd' | 'zar', required — ISO 4217 currency code in lower case.
    - `custom_data` string — Base64 encoded string detailing custom data passed in the request.
    - `custom1` string — Send additional data relating to the customer or another internal reference.
    - `custom2` string — Send additional data relating to the customer or another internal reference.
  - `payment` object
    - `mandate_id` string, uuid, required — Unique identifier assigned by Acquired.com for the mandate record.
    - `charge_date` string, date — Populate this parameter if you want to set the initial Direct Debit collection for a date in the future, rather than the collection being processed on the next working day.

## Response `201`

Created

- object
  - `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_id` string, uuid — Unique identifier assigned by Acquired.com for the transaction record.

## Other responses

- `400` — An error occurred
- `401` — An error occurred
- `500` — Internal Server error

---

[API](https://skmtc.dev/acquired/apis/acquired-api.md) · [All operations](https://skmtc.dev/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/acquired/acquired-api/revisions/7ae178a046f2/schema)