---
title: "Create customer payment"
method: POST
path: "/v2/customers/{customerId}/payments"
tags: ["Customers API"]
---

# Create customer payment

`POST /v2/customers/{customerId}/payments`

Creates a payment for the customer.

Linking customers to payments enables you to:

* Keep track of payment preferences for your customers
* Allow your customers to charge a previously used credit card with a single click in our hosted checkout
* Improve payment insights in the Mollie dashboard
* Use recurring payments

This endpoint is effectively an alias of the [Create payment endpoint](create-payment) with the `customerId`
parameter predefined.

## Headers

- `idempotency-key` string

## Request body

- PaymentRequest — unresolved $ref

## Response `201`

The newly created payment object.

## Other responses

- `422` — The request contains issues. For example, if a payment description is missing, or if the specified amount is higher than the maximum allowed amount.
- `429` — Rate Limit has been reached.
- `503` — The payment method supplier is currently unavailable. For example, if you are setting up an iDEAL payment but the iDEAL network is having issues, we may return this error response.

## Changes

> 92 revisions in range; 9 not diffed.

- **2026-09-15** `9c1c6717ac7d` — 3 warning, 3 info
  - added the new `el_GR` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
  - added the new `sl_SI` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
  - added the new `tr_TR` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
  - added the new `el_GR` enum value to the request property `allOf[#/components/schemas/entity-payment]/locale`
  - …2 more
- **2026-09-15** `34b0d7662c30` — 1 warning, 1 info
  - added the new `undefined` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/cardLabel` response property for the response status `201`
  - added the new `undefined` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/cardLabel`
- **2026-09-14** `7eb5bf6b29dd` — 1 warning, 2 info
  - added the new `undefined` enum value to the `allOf[subschema #2]/method` response property for the response status `201`
  - added the new `undefined` enum value to the request property `allOf[subschema #3]/method/oneOf[#/components/schemas/method]/`
  - added the new `undefined` enum value to the request property `allOf[subschema #3]/method/oneOf[subschema #2]/items/`
- …earlier changes not shown

[Full history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/customers/:customerId/payments/post.md)

---

[API](https://skmtc.dev/mollie/apis/mollie-api.md) · [All operations](https://skmtc.dev/mollie/apis/mollie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mollie/apis/mollie-api/revisions/b9d764add1c3?raw)