---
title: "Changes to Create customer payment"
method: POST
path: "/v2/customers/{customerId}/payments"
---

# Changes to Create customer payment

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

> Every recorded change to this endpoint, newest first.
> 92 revisions in range; 9 not diffed.

## Timeline

Changed in 19 of 92 revisions.

- **2026-09-15** `9c1c6717ac7d` — 3 warning, 3 info
- **2026-09-15** `34b0d7662c30` — 1 warning, 1 info
- **2026-09-14** `7eb5bf6b29dd` — 1 warning, 2 info
- **2026-09-07** `66dee9998c09` — 1 warning, 2 info
- **2026-08-27** `8e5a936eb5bd` — 6 warning, 6 info
- **2026-08-07** `86a9cd830b06` — 3 warning, 3 info
- **2026-08-06** `64c0511a62bc` — 1 breaking, 1 warning, 2 info
- **2026-08-05** `42479670d8c9` — 1 breaking, 2 info
- **2026-07-30** `160fcdd65af7` — 1 warning, 2 info
- **2026-07-08** `4d4ab81fb2d5` — 2 warning, 2 info
- **2026-07-02** `226f9009e928` — 13 warning, 13 info
- **2026-06-22** `245eb8c59534` — 37 breaking, 38 info
- **2026-06-09** `327472893a89` — 1 warning, 1 info
- **2026-05-19** `7cab62b21830` — 1 info
- **2026-05-13** `82b319a5dc58` — 1 info
- **2026-05-12** `331cb8579126` — 2 info
- **2026-05-12** `ef4b5a97b56a` — 2 info
- **2026-05-05** `f3d6346a1412` — 2 warning, 2 info
- **2026-05-04** `18e0e58eb54d` — 2 info

## Changes

- **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`
  - added the new `sl_SI` enum value to the request property `allOf[#/components/schemas/entity-payment]/locale`
  - added the new `tr_TR` enum value to the request property `allOf[#/components/schemas/entity-payment]/locale`
- **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/`
- **2026-09-07** `66dee9998c09` — 1 warning, 2 info
  - added the new `wero` enum value to the `allOf[subschema #2]/method` response property for the response status `201`
  - added the new `wero` enum value to the request property `allOf[subschema #3]/method/oneOf[#/components/schemas/method]/`
  - added the new `wero` enum value to the request property `allOf[subschema #3]/method/oneOf[subschema #2]/items/`
- **2026-08-27** `8e5a936eb5bd` — 6 warning, 6 info
  - added the new `Cartes Bancaires` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/cardLabel` response property for the response status `201`
  - added the new `cartes-bancaires-business` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `cartes-bancaires-consumer` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `mastercard-debit-consumer-inter` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `visa-debit-consumer-inter` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `visa-debit-consumer-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `Cartes Bancaires` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/cardLabel`
  - added the new `cartes-bancaires-business` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `cartes-bancaires-consumer` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `mastercard-debit-consumer-inter` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `visa-debit-consumer-inter` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `visa-debit-consumer-intra-eea` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
- **2026-08-07** `86a9cd830b06` — 3 warning, 3 info
  - added the new `en_BE` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
  - added the new `en_NL` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
  - added the new `visa-credit-consumer-inter` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `en_BE` enum value to the request property `allOf[#/components/schemas/entity-payment]/locale`
  - added the new `en_NL` enum value to the request property `allOf[#/components/schemas/entity-payment]/locale`
  - added the new `visa-credit-consumer-inter` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
- **2026-08-06** `64c0511a62bc` — 1 breaking, 1 warning, 2 info
  - removed the enum value `null` of the request property `allOf[#/components/schemas/entity-payment]/locale`
  - added the new `undefined` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
  - added the new `undefined` enum value to the request property `allOf[#/components/schemas/entity-payment]/locale`
  - removed the `null` enum value from the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
- **2026-08-05** `42479670d8c9` — 1 breaking, 2 info
  - the response property `allOf[#/components/schemas/entity-payment-response]/dueDate` became nullable for the status `201`
  - the request property `allOf[#/components/schemas/entity-payment]/dueDate` became nullable
  - the request property `allOf[#/components/schemas/extra-parameter-parameters]/dueDate` became nullable
- **2026-07-30** `160fcdd65af7` — 1 warning, 2 info
  - added the new `billink` enum value to the `allOf[subschema #2]/method` response property for the response status `201`
  - added the new `billink` enum value to the request property `allOf[subschema #3]/method/oneOf[#/components/schemas/method]/`
  - added the new `billink` enum value to the request property `allOf[subschema #3]/method/oneOf[subschema #2]/items/`
- **2026-07-08** `4d4ab81fb2d5` — 2 warning, 2 info
  - added the new `cs_CZ` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
  - added the new `sk_SK` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
  - added the new `cs_CZ` enum value to the request property `allOf[#/components/schemas/entity-payment]/locale`
  - added the new `sk_SK` enum value to the request property `allOf[#/components/schemas/entity-payment]/locale`
- **2026-07-02** `226f9009e928` — 13 warning, 13 info
  - added the new `mastercard-credit-business-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `mastercard-credit-consumer-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `mastercard-credit-consumer-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `mastercard-debit-business-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `mastercard-debit-business-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `mastercard-debit-consumer-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `mastercard-debit-consumer-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `visa-credit-business-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `visa-credit-consumer-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `visa-credit-consumer-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `visa-debit-business-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `visa-debit-business-intra-eea` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `visa-debit-consumer-domestic` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/feeRegion` response property for the response status `201`
  - added the new `mastercard-credit-business-domestic` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `mastercard-credit-consumer-domestic` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `mastercard-credit-consumer-intra-eea` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `mastercard-debit-business-domestic` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `mastercard-debit-business-intra-eea` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `mastercard-debit-consumer-domestic` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `mastercard-debit-consumer-intra-eea` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `visa-credit-business-domestic` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `visa-credit-consumer-domestic` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `visa-credit-consumer-intra-eea` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `visa-debit-business-domestic` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `visa-debit-business-intra-eea` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
  - added the new `visa-debit-consumer-domestic` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/feeRegion`
- **2026-06-22** `245eb8c59534` — 37 breaking, 38 info
  - the request property `allOf[#/components/schemas/entity-payment]/method` became not nullable
  - removed the enum value `alma` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `applepay` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `bacs` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `bancomatpay` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `bancontact` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `banktransfer` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `belfius` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `billie` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `bizum` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `blik` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `creditcard` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `directdebit` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `eps` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `giftcard` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `ideal` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `in3` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `kbc` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `klarna` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `mbway` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `mobilepay` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `multibanco` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `mybank` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `paybybank` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `paypal` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `paysafecard` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `pointofsale` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `przelewy24` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `riverty` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `satispay` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `swish` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `trustly` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `twint` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `vipps` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - removed the enum value `voucher` of the request property `allOf[#/components/schemas/entity-payment]/method`
  - the `allOf[#/components/schemas/entity-payment]/method` request property type changed from `string, null` to no type
  - the `allOf[#/components/schemas/entity-payment-response]/method` response's property type changed from `string, null` to no type for status `201`
  - removed the `alma` enum value from the `allOf[#/components/schemas/entity-payment-response]/method` response property for the response status `201`
  - removed the `applepay` enum value from the `allOf[#/components/schemas/entity-payment-response]/method` response property for the response status `201`
  - removed the `bacs` enum value from the `allOf[#/components/schemas/entity-payment-response]/method` response property for the response status `201`
  - …35 more
- **2026-06-09** `327472893a89` — 1 warning, 1 info
  - added the new `googlepay` enum value to the `allOf[#/components/schemas/entity-payment-response]/details/wallet` response property for the response status `201`
  - added the new `googlepay` enum value to the request property `allOf[#/components/schemas/entity-payment]/details/wallet`
- **2026-05-19** `7cab62b21830` — 1 info
  - added the non-success response with the status `429`
- **2026-05-13** `82b319a5dc58` — 1 info
  - added the new optional request property `allOf[#/components/schemas/extra-parameter-parameters]/googlePayPaymentToken`
- **2026-05-12** `331cb8579126` — 2 info
  - the request required property `allOf[#/components/schemas/entity-payment]/routing/items/_links` became read-only
  - the response required property `allOf[#/components/schemas/entity-payment-response]/routing/items/_links` became read-only for the status `201`
- **2026-05-12** `ef4b5a97b56a` — 2 info
  - the endpoint scheme security `advancedAccessToken` was added to the API
  - the endpoint scheme security `organizationAccessToken` was removed from the API
- **2026-05-05** `f3d6346a1412` — 2 warning, 2 info
  - added the new `de_LU` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
  - added the new `fr_LU` enum value to the `allOf[#/components/schemas/entity-payment-response]/locale` response property for the response status `201`
  - added the new `de_LU` enum value to the request property `allOf[#/components/schemas/entity-payment]/locale`
  - added the new `fr_LU` enum value to the request property `allOf[#/components/schemas/entity-payment]/locale`
- **2026-05-04** `18e0e58eb54d` — 2 info
  - request property `allOf[#/components/schemas/entity-payment]/settlementAmount` deprecated
  - response property `allOf[#/components/schemas/entity-payment-response]/settlementAmount` deprecated

---

[Operation](https://skmtc.dev/mollie/apis/mollie-api/docs/v2/customers/:customerId/payments/post.md) · [API](https://skmtc.dev/mollie/apis/mollie-api.md) · [Page](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/customers/:customerId/payments/post)