Customers API

With the Customers API you can create simple minimal representations of your customers in the Mollie API.

For recurring payment processing, the Customers API is required. Tracking mandates, charging recurring payments, and creating subscriptions are all done on a per-customer basis.

For regular payment processing you can optionally ‘attach’ payments to a customer as well. This improves the hosted checkout experience for the customer, and improves the insights provided by the Mollie Dashboard.

The Customers API allows you to provide customer information. Although not required, we recommend at least providing a recognizable name for each customer. This makes it easier to manage your customers and their payments in the Mollie Dashboard.

For a step-by-step guide on charging your customers recurrently, refer to Recurring payments.

Endpoints

Create customer

POST/v2/customers

Create a customer.

Get customer

GET/v2/customers/*id*

Retrieve details of a specific customer.

Update customer

PATCH/v2/customers/*id*

Update the details of a specific customer.

Delete customer

DELETE/v2/customers/*id*

Delete a specific customer.

List customers

GET/v2/customers

Retrieve a list of all your customers.

Create customer payment

POST/v2/customers/*id*/payments

Create a payment attached to a specific customer.

List customer payments

GET/v2/customers/*id*/payments

Retrieve a list of all payments attached to a specific customer.