---
title: "Create new Direct Debit payment"
method: POST
path: "/v1/directdebit/payments"
tags: ["Direct Debit"]
---

# Create new Direct Debit payment

`POST /v1/directdebit/payments`

Create a new Direct Debit payment for the account associated to the Authorisation token. The Authorisation token needs to be specified in the 'authorization' header as 'authorization: Bearer YOUR_API_KEY_HERE'

## Request body

- CreateDirectDebitPaymentRequest — The Direct Debit Payment Request Payload
  - `amount` integer, required — amount in pence
  - `reference` string, required — payment reference
  - `description` string, required — payment description
  - `mandate_id` string — ID of the mandates being used to collect the payment

## Response `201`

Created

- DirectDebitPayment
  - `amount` integer
  - `description` string
  - `reference` string
  - `payment_id` string
  - `payment_provider` string
  - `created_date` string
  - `mandate_id` string
  - `provider_id` string
  - `_links` DirectDebitPaymentLinks — links for payment
    - `self` Link — A link related to a payment
      - `href` string
      - `method` string
    - `mandate` Link — A link related to a payment
      - `href` string
      - `method` string
  - `state` DirectDebitPaymentState
    - `details` string
    - `status` string

## Other responses

- `400` — Bad request
- `401` — Credentials are required to access this resource
- `422` — Invalid parameters: amount, reference, description, mandate id. See Public API documentation for the correct data formats
- `429` — Too many requests
- `500` — Downstream system error

## Changes

- **2019-08-01** `6e01c8022b87` — 1 info
  - api operation id `Collect a direct debit payment` removed and replaced with `Collect a Direct Debit payment`
- **2019-07-31** `f8066d82895d` — 1 info
  - api operation id `createDirectDebitPayment` removed and replaced with `Collect a direct debit payment`
- **2019-07-31** `ef50a2b1c4f1` — 1 info
  - api tag `Direct Debit` added
- **2019-07-24** `8c9cfc1bfdd1` — 1 info
  - api operation id `createPayment` removed and replaced with `createDirectDebitPayment`
- **2019-07-19** `4752d7029174` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/alphagov/apis/gov-uk-pay-api/changes/v1/directdebit/payments/post.md)

---

[API](https://skmtc.dev/alphagov/apis/gov-uk-pay-api.md) · [All operations](https://skmtc.dev/alphagov/apis/gov-uk-pay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphagov/apis/gov-uk-pay-api/revisions/6e01c8022b87?raw)