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.

Changes

Changed in 19 of the 92 revisions of this API.393587

Sep 15, 20269c1c6717ac7d33See the full diff
- ●
  added the new el_GR enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new sl_SI enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new tr_TR enum value to the //// response property for the response status
  response-property-enum-value-added
- ○
  added the new el_GR enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new sl_SI enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new tr_TR enum value to the request property ////
  request-property-enum-value-added
Sep 15, 202634b0d7662c3011See the full diff
- ●
  added the new undefined enum value to the ///// response property for the response status
  response-property-enum-value-added
- ○
  added the new undefined enum value to the request property /////
  request-property-enum-value-added
Sep 14, 20267eb5bf6b29dd12See the full diff
- ●
  added the new undefined enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new undefined enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new undefined enum value to the request property ///
  request-property-enum-value-added
Sep 7, 202666dee9998c0912See the full diff
- ●
  added the new wero enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new wero enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new wero enum value to the request property ///
  request-property-enum-value-added
Aug 27, 20268e5a936eb5bd66See the full diff
- ●
  added the new Cartes Bancaires enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new cartes-bancaires-business enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new cartes-bancaires-consumer enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new mastercard-debit-consumer-inter enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new visa-debit-consumer-inter enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new visa-debit-consumer-intra-eea enum value to the ///// response property for the response status
  response-property-enum-value-added
- ○
  added the new Cartes Bancaires enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new cartes-bancaires-business enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new cartes-bancaires-consumer enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new mastercard-debit-consumer-inter enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new visa-debit-consumer-inter enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new visa-debit-consumer-intra-eea enum value to the request property /////
  request-property-enum-value-added
Aug 7, 202686a9cd830b0633See the full diff
- ●
  added the new en_BE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new en_NL enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new visa-credit-consumer-inter enum value to the ///// response property for the response status
  response-property-enum-value-added
- ○
  added the new en_BE enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new en_NL enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new visa-credit-consumer-inter enum value to the request property /////
  request-property-enum-value-added
Aug 6, 202664c0511a62bc112See the full diff
- ▲
  removed the enum value null of the request property ////
  request-property-enum-value-removed
- ●
  added the new undefined enum value to the //// response property for the response status
  response-property-enum-value-added
- ○
  added the new undefined enum value to the request property ////
  request-property-enum-value-added
- ○
  removed the null enum value from the //// response property for the response status
  response-property-enum-value-removed
Aug 5, 202642479670d8c912See the full diff
- ▲
  the response property //// became nullable for the status
  response-property-became-nullable
- ○
  the request property //// became nullable
  request-property-became-nullable
- ○
  the request property //// became nullable
  request-property-became-nullable
Jul 30, 2026160fcdd65af712See the full diff
- ●
  added the new billink enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new billink enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new billink enum value to the request property ///
  request-property-enum-value-added
Jul 8, 20264d4ab81fb2d522See the full diff
- ●
  added the new cs_CZ enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new sk_SK enum value to the //// response property for the response status
  response-property-enum-value-added
- ○
  added the new cs_CZ enum value to the request property ////
  request-property-enum-value-added
- ○
  added the new sk_SK enum value to the request property ////
  request-property-enum-value-added

Of the 92 revisions, 9 have no diff computed.

Full history (19 revisions)