Mollie
Create and manage payments with the Mollie payment gateway.
On this page
Connect
Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.
- In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
- For every project in a workspace: Workspace settings, Integrations.
- Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.
Call it from a workflow
Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.
// .workflow.js (native ctx)
export async function run(ctx) {
const res = await ctx.integrations.invoke("mollie", "create_payment", {
"description": "<description>",
"currency": "<currency>",
"amount": "<amount>",
"redirectUrl": "<redirect url>"
});
if (!res.success) throw new Error(res.error);
ctx.log.info("Mollie answered", { output: res.output });
}// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";
export default defineWorkflow({
id: "mollie-create-payment",
name: "Mollie: Create Payment",
description: "Calls Mollie when a row is created.",
trigger: { type: "entity_event", entity: "tickets", event: "created" },
async run(ctx, event) {
const res = await ctx.integrations.call("mollie", {
"action": "create_payment",
"description": "<description>",
"currency": "<currency>",
"amount": "<amount>",
"redirectUrl": "<redirect url>"
}) as { success: boolean; error?: string };
if (!res.success) throw new Error(res.error);
},
});curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/mollie/create_payment" \
-H "Authorization: Bearer $APP_KEY" \
-H "content-type: application/json" \
-d '{"props":{"description":"<description>","currency":"<currency>","amount":"<amount>","redirectUrl":"<redirect url>"}}'Actions
create_paymentin catalog
Create Payment. Creates a new payment in Mollie
| Input | Type | Description |
|---|---|---|
descriptionrequired | text | Description of the payment (max 255 characters) |
currencyrequired | text | A three-character ISO 4217 currency code (e.g. EUR, USD) |
amountrequired | text | The amount to charge (e.g. "10.00") |
redirectUrlrequired | long text | URL to redirect customer after payment completion |
cancelUrloptional | long text | URL to redirect customer when they cancel payment |
webhookUrloptional | long text | URL for payment status updates |
includeLinesoptional | boolean | Whether to include detailed order line items |
linesoptional | array | Order line items (required for certain payment methods) |
includeBillingAddressoptional | boolean | Whether to include billing address details |
billingTitleoptional | text | Title (e.g. Mr., Mrs.) |
billingGivenNameoptional | text | First name |
billingFamilyNameoptional | text | Last name |
billingOrganizationNameoptional | text | Organization name |
billingStreetAndNumberoptional | text | Street address with number |
billingStreetAdditionaloptional | text | Additional address details |
billingPostalCodeoptional | text | Postal code |
billingEmailoptional | text | Email address |
billingPhoneoptional | text | Phone in E.164 format |
billingCityoptional | text | City name |
billingRegionoptional | text | State or region |
create_customer
Create Customer. Creates a new customer in Mollie
| Input | Type | Description |
|---|---|---|
nameoptional | text | The full name of the customer |
emailoptional | text | The email address of the customer |
localeoptional | one of "en_US" | "en_GB" | "nl_NL" | "nl_BE" | "de_DE" | "de_AT" | "de_CH" | "fr_FR" | "fr_BE" | "es_ES" | "ca_ES" | "pt_PT" | The language to be used in the hosted payment pages |
metadataoptional | text | Additional data to save alongside the customer (JSON string) |
testmodeoptional | boolean | Whether to create the customer in test mode |
create_order
Create Order. ⚠️ We no longer recommend using the Orders API. Please refer to the Payments API instead. Create a new order in Mollie
| Input | Type | Description |
|---|---|---|
orderNumberrequired | text | The order number for this order. We recommend each order number to be unique. |
currencyrequired | text | A three-character ISO 4217 currency code (e.g. EUR, USD) |
amountrequired | text | The total amount to charge (e.g. "10.00") |
linesrequired | array | The order lines for the order |
billingTitleoptional | text | The title of the person (e.g. Mr., Mrs.) |
billingGivenNamerequired | text | The given name (first name) of the person |
billingFamilyNamerequired | text | The family name (surname) of the person |
billingOrganizationNameoptional | text | The name of the organization |
billingStreetAndNumberrequired | text | A street and street number |
billingStreetAdditionaloptional | text | Any additional addressing details |
billingPostalCoderequired | text | A postal code |
billingEmailrequired | text | Email address |
billingPhoneoptional | text | Phone number in E.164 format |
billingCityrequired | text | City name |
billingRegionoptional | text | Region or state |
billingCountryrequired | text | A country code in ISO 3166-1 alpha-2 format |
includeShippingAddressoptional | boolean | Whether to include a separate shipping address |
shippingTitleoptional | text | The title of the person (e.g. Mr., Mrs.) |
shippingGivenNameoptional | text | The given name (first name) of the person |
shippingFamilyNameoptional | text | The family name (surname) of the person |
create_payment_link
Create Payment Link. Generate a new payment link targeting a customer, product, or specific amount
| Input | Type | Description |
|---|---|---|
descriptionrequired | text | A short description of the payment link (max 255 characters) |
includeAmountoptional | boolean | Whether to include a fixed amount or let customer enter amount |
currencyoptional | text | A three-character ISO 4217 currency code (e.g. EUR, USD) |
amountoptional | text | The amount to charge (e.g. "10.00") |
includeMinimumAmountoptional | boolean | Whether to set a minimum amount (only when no fixed amount) |
minimumAmountCurrencyoptional | text | Currency for minimum amount |
minimumAmountoptional | text | The minimum amount (e.g. "5.00") |
redirectUrloptional | long text | URL to redirect customer after payment completion |
webhookUrloptional | long text | URL for payment status updates |
includeLinesoptional | boolean | Whether to include detailed order line items |
linesoptional | array | Order line items (required for certain payment methods) |
includeBillingAddressoptional | boolean | Whether to include billing address details |
billingTitleoptional | text | Title (e.g. Mr., Mrs.) |
billingGivenNameoptional | text | First name |
billingFamilyNameoptional | text | Last name |
billingOrganizationNameoptional | text | Organization name |
billingStreetAndNumberoptional | text | Street address with number |
billingStreetAdditionaloptional | text | Additional address details |
billingPostalCodeoptional | text | Postal code |
billingEmailoptional | text | Email address |
create_payment_refund
Create Payment Refund. Creates refund for payment
| Input | Type | Description |
|---|---|---|
paymentIdrequired | id (picked from your account) | Select the payment to refund |
descriptionoptional | text | The description of the refund (max 255 characters) |
currencyrequired | text | A three-character ISO 4217 currency code (e.g. EUR, USD) |
amountrequired | text | The amount to refund (e.g. "10.00") |
metadataoptional | text | Additional data to save alongside the refund (JSON string) |
includeExternalReferenceoptional | boolean | Whether to include external reference details |
externalReferenceTypeoptional | one of "acquirer-reference" | Type of external reference |
externalReferenceIdoptional | text | Unique reference from the payment provider |
reverseRoutingoptional | boolean | Pull back funds routed to connected merchants (full refund only) |
includeRoutingReversalsoptional | boolean | Specify detailed routing reversals for partial refunds |
routingReversalsoptional | array | Detailed routing reversals for connected merchants |
testmodeoptional | boolean | Whether to create the refund in test mode |
search_customer
Search Customer. Retrieve a list of all customers
| Input | Type | Description |
|---|---|---|
fromoptional | text | Start the result set from this customer ID onwards |
limitoptional | number | Maximum number of customers to return (1-250, default: 50) |
sortoptional | one of "desc" | "asc" | Sort customers by creation date |
testmodeoptional | boolean | Whether to search in test mode |
search_order
Search Order. ⚠️ We no longer recommend using the Orders API. Please refer to the Payments API instead. Searches for orders in Mollie
| Input | Type | Description |
|---|---|---|
fromoptional | text | Start the result set from this order ID onwards |
limitoptional | number | Maximum number of orders to return (1-250, default: 50) |
sortoptional | one of "desc" | "asc" | Sort orders by creation date |
profileIdoptional | text | Profile ID to retrieve orders for (optional) |
testmodeoptional | boolean | Whether to search in test mode |
search_payment
Search Payment. Retrieve all payments created with the current website profile
| Input | Type | Description |
|---|---|---|
fromoptional | text | Start the result set from this payment ID onwards |
limitoptional | number | Maximum number of payments to return (1-250, default: 50) |
sortoptional | one of "desc" | "asc" | Sort payments by creation date |
profileIdoptional | text | Profile ID to retrieve payments for (optional) |
testmodeoptional | boolean | Whether to search in test mode |
Details
- Id
mollie- Category
- Finance and payments
- Tags
- payments, gateway, europe, billing
- Package
@activepieces/piece-mollie@0.1.3- Tier
- Community