Create customer payment¶
POST
https://api.mollie.com/v2/customers/*customerId*/payments
Creates a payment for the customer.
Linking customers to payments enables a number of Mollie Checkout features, including:
- Keeping track of payment preferences for your customers.
- Enabling your customers to charge a previously used credit card with a single click.
- Improved payment insights in your dashboard.
- Recurring payments.
Note
This endpoint is a shortcut for creating a payment with a
customerId
parameter.
Parameters¶
Replace customerId
in the endpoint URL by the customer’s ID, for example cst_8wmqcHMN4U
.
This endpoint accepts the same parameters as the Create payment endpoint. For recurring payments, the following parameters have notable differences in comparison to regular payments:
sequenceType
stringoptionalfirst
, a first payment for the customer is created, allowing the customer
to agree to automatic recurring charges taking place on their account in the future. If set to recurring
, the
customer is charged automatically.redirectUrl
stringoptionalrecurringType
parameter is set to recurring
, this parameter can be omitted. Since the payment will
take place without customer interaction, a redirect is not needed.cancelUrl
stringoptionalrecurringType
parameter is set to recurring
, this parameter can be omitted just like the
redirectUrl
. Since the payment will take place without customer interaction, a redirect is not needed.Access token parameters¶
If you are using organization access tokens or are creating an
OAuth app, you have to specify which profile you are creating payments for using the
profileId
parameter. Organizations can have multiple profiles for each of their websites. See
Profiles API for more information.
For these authentication methods the optional testmode
parameter is available as well to enable test mode.
pfl_3RkSN1zuPE
.true
to create a payment made in test mode.Example¶
1 2 3 4 5 6 7 8 | curl -X POST https://api.mollie.com/v2/customers/cst_8wmqcHMN4U/payments \ -H "Authorization: Bearer test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM" \ -d "amount[currency]=EUR" \ -d "amount[value]=10.00" \ -d "description=Order #12345" \ -d "sequenceType=first" \ -d "redirectUrl=https://webshop.example.org/order/12345/" \ -d "webhookUrl=https://webshop.example.org/payments/webhook/" |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | <?php $mollie = new \Mollie\Api\MollieApiClient(); $mollie->setApiKey("test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM"); $payment = $mollie->customers->get("cst_8wmqcHMN4U")->createPayment([ "amount" => [ "currency" => "EUR", "value" => "10.00", ], "description" => "Order #12345", "sequenceType" => "first", "redirectUrl" => "https://webshop.example.org/order/12345/", "webhookUrl" => "https://webshop.example.org/payments/webhook/", ]); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | from mollie.api.client import Client mollie_client = Client() mollie_client.set_api_key("test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM") customer = mollie_client.customers.get("cst_8wmqcHMN4U") payment = customer.payments.create({ "amount": { "value": "10.00", "currency": "EUR", }, "description": "Order #12345", "sequenceType": "first", "redirectUrl": "https://webshop.example.org/order/12345/", "webhookUrl": "https://webshop.example.org/payments/webhook/", }) |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | require 'mollie-api-ruby' Mollie::Client.configure do |config| config.api_key = 'test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM' end payment = Mollie::Customer::Payment.create( customer_id: 'cst_8wmqcHMN4U', amount: { value: '10.00', currency: 'EUR' }, description: 'Order #12345', sequence_type: 'first', redirect_url: 'https://webshop.example.org/order/12345/', webhook_url: 'https://webshop.example.org/payments/webhook/' ) |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | const { createMollieClient } = require('@mollie/api-client'); const mollieClient = createMollieClient({ apiKey: 'test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM' }); const payment = await mollieClient.customerPayments.create({ customerId: 'cst_8wmqcHMN4U', amount: { currency: 'EUR', value: '10.00' }, description: 'Order #12345', sequenceType: 'first', redirectUrl: 'https://webshop.example.org/order/12345/', webhookUrl: 'https://webshop.example.org/payments/webhook/' }); |
Response¶
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 | HTTP/1.1 201 Created Content-Type: application/hal+json { "resource": "payment", "id": "tr_7UhSN1zuXS", "mode": "test", "createdAt": "2018-03-20T09:13:37+00:00", "amount": { "value": "10.00", "currency": "EUR" }, "description": "Order #12345", "method": null, "metadata": { "order_id": "12345" }, "status": "open", "isCancelable": false, "expiresAt": "2018-03-20T09:28:37+00:00", "details": null, "profileId": "pfl_QkEhN94Ba", "customerId": "cst_8wmqcHMN4U", "sequenceType": "first", "redirectUrl": "https://webshop.example.org/order/12345/", "webhookUrl": "https://webshop.example.org/payments/webhook/", "_links": { "self": { "href": "https://api.mollie.com/v2/payments/tr_7UhSN1zuXS", "type": "application/json" }, "checkout": { "href": "https://www.mollie.com/payscreen/select-method/7UhSN1zuXS", "type": "text/html" }, "dashboard": { "href": "https://www.mollie.com/dashboard/org_12345678/payments/tr_7UhSN1zuXS", "type": "text/html" }, "documentation": { "href": "https://docs.mollie.com/reference/v2/payments-api/create-payment", "type": "text/html" } } } |