---
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.

---

[API](https://skmtc.net/mollie/apis/mollie-api.md) · [All operations](https://skmtc.net/mollie/apis/mollie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mollie/mollie-api/revisions/8b6839e22c14/schema)