OpenAPI 3.1.0CC-BY-NC-SA-4.0raw.githubusercontent.com2026-08-141243861.8 MB

d2a3bd80c1fa

Customers API

Create customer payment

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 with the customerId parameter predefined.

post/v2/customers/{customerId}/payments

Headers

idempotency-keystring
Example:123e4567-e89b-12d3-a456-426

A unique key to ensure idempotent requests. This key should be a UUID v4 string.

Request body

PaymentRequest required— unresolved $ref

Response

The newly created payment object.