---
title: Mollie API Integration on Truto
slug: mollie
category: Payment Gateway
canonical: "https://truto.one/integrations/detail/mollie/"
---

# Mollie API Integration on Truto



**Category:** Payment Gateway  
**Status:** Generally available

## MCP-ready AI tools

Truto exposes 124 tools for Mollie that AI agents can call directly.

- **create_a_mollie_oauth_2_token** — Generate Mollie OAuth2 tokens by exchanging an authorization code or refreshing an existing token. Returns: access_token, refresh_token, expires_in, token_type, scope. Use grant_type `authorization_code` with a `code` parameter, or `refresh_token` with a `refresh_token` parameter. Required: grant_type.
- **mollie_oauth_2_tokens_bulk_delete** — Revoke a Mollie OAuth2 access token or refresh token. Once revoked, the token can no longer be used; revoking a refresh token also revokes all access tokens created from the same authorization. Returns an empty 204 response on success. Required: token_type_hint, token.
- **list_all_mollie_balances** — List all Mollie balances including the primary balance, paginated. Returns each balance's id, currency, availableAmount, pendingAmount, status, transferFrequency, transferThreshold, transferReference, transferDestination, createdAt, mode, and description. Optionally filter by currency.
- **get_single_mollie_balance_by_id** — Get a single Mollie balance by id. Returns the balance object including available and pending amounts, currency, transfer frequency, transfer threshold, transfer destination, and status. Required: id.
- **list_all_mollie_balances_primaries** — Retrieve the primary balance of your Mollie account — the balance of your account's primary currency where all payments settle by default. Returns: resource, id, mode, createdAt, currency, description, status, transferFrequency, transferThreshold, transferReference, transferDestination, availableAmount, pendingAmount, _links. No required parameters.
- **list_all_mollie_balance_reports** — Get a summarized report of all transactions on a Mollie balance within a given timeframe, including prepayments for Mollie fees. Returns: resource, balanceId, timeZone, from, until, grouping, totals, _links. The alias `primary` can be used instead of a balance ID. Required: balance_id, from, until.
- **list_all_mollie_balance_transactions** — List all transactions for a specific Mollie balance, including payments, refunds, chargebacks, and settlements. Returns: resource, id, type, resultAmount, initialAmount, deductions, deductionDetails, context, createdAt. The alias 'primary' may be used as the balance_id to target the organization's primary balance. Required: balance_id.
- **list_all_mollie_settlements** — List all Mollie settlements, paginated. Returns: resource, id, createdAt, reference, settledAt, status, amount, balanceId, invoiceId, periods, _links. Filters include balanceId, year+month (must be used together), and currencies (comma-separated).
- **get_single_mollie_settlement_by_id** — Get a single Mollie settlement by id or bank reference. Returns: resource, id, createdAt, reference, settledAt, status, amount, balanceId, invoiceId, periods, _links, advancedAccessToken. Required: id.
- **list_all_mollie_settlements_opens** — Retrieve the open settlement representing the organization's current open balance in Mollie. Returns: resource, id, createdAt, reference, settledAt, status, amount, balanceId, invoiceId, periods, _links.
- **list_all_mollie_settlements_nexts** — Get the next Mollie settlement — the current settlement that has not yet been paid out. Returns: resource, id, createdAt, reference, settledAt, status, amount, balanceId, invoiceId, periods, _links.
- **list_all_mollie_settlement_payments** — List all payments included in a Mollie settlement. Returns: resource, id, mode, description, amount, amountRefunded, amountRemaining, amountCaptured, amountChargedBack, redirectUrl, cancelUrl, webhookUrl, lines, billingAddress, shippingAddress, locale, countryCode, method, issuer, restrictPaymentMethodsToCountry, metadata, captureMode, captureDelay, captureBefore, applicationFee, routing,…. Required: settlement_id.
- **list_all_mollie_settlement_captures** — List all captures included in a Mollie settlement. Returns: resource, id, mode, description, amount, status, metadata, paymentId, shipmentId, settlementId, createdAt, _links, settlementAmount. Required: settlement_id.
- **list_all_mollie_settlement_refunds** — List all refunds deducted from a specific Mollie settlement. Returns: resource, id, mode, description, amount, metadata, paymentId, settlementId, status, createdAt, externalReference, reverseRouting, routingReversals, testmode, _links, settlementAmount. Required: settlement_id.
- **list_all_mollie_settlement_chargebacks** — List all chargebacks deducted from a specific Mollie settlement. Returns: resource, id, amount, reason, paymentId, settlementId, createdAt, reversedAt, _links, mode, settlementAmount, _embedded. Required: settlement_id.
- **list_all_mollie_invoices** — List Mollie invoices, optionally filtered by year or invoice reference. Returns each invoice with id, reference, status, netAmount, vatAmount, grossAmount, lines, issuedAt, dueAt, paidAt, and _links. Results are paginated.
- **get_single_mollie_invoice_by_id** — Get a single Mollie invoice by id. Returns the full invoice object including id, reference, status, netAmount, vatAmount, grossAmount, lines, issuedAt, dueAt, paidAt, and _links with a PDF download link. To retrieve by invoice number instead of id, use the List invoices endpoint with the reference parameter. Required: id.
- **list_all_mollie_permissions** — List all Mollie permissions available to the current access token. Returns: resource, id, description, granted, _links. The results are not paginated.
- **get_single_mollie_permission_by_id** — Get a single Mollie permission by id and check whether it is granted to the current access token. Returns: resource, id, description, granted, _links. Required: id.
- **get_single_mollie_organization_by_id** — Get a single Mollie organization by its id. Returns: resource, id, name, email, locale, address, registrationNumber, vatNumber, vatRegulation, _links, verifiedAt. Required: id.
- **list_all_mollie_organizations** — Retrieve the current Mollie organization. Returns: resource, id, name, email, locale, address, registrationNumber, vatNumber, vatRegulation, _links, verifiedAt.
- **list_all_mollie_organizations_partners** — Get the partner status for the currently authenticated Mollie organization. Returns: resource, partnerType, isCommissionPartner, userAgentTokens, partnerContractSignedAt, partnerContractUpdateAvailable, partnerContractExpiresAt, _links. Only relevant for partner accounts.
- **list_all_mollie_profiles** — List all Mollie profiles. Returns: resource, id, mode, name, website, email, phone, description, countriesOfActivity, businessCategory, status, review, createdAt, _links. Results are paginated.
- **create_a_mollie_profile** — Create a new Mollie profile to process payments on. Returns the created profile including id, name, website, email, status, mode, businessCategory, and createdAt. Required: name, website, email, phone.
- **get_single_mollie_profile_by_id** — Get a single Mollie profile by id. Returns: resource, id, mode, name, website, email, phone, description, countriesOfActivity, businessCategory, status, review, createdAt, _links. Required: id.
- **update_a_mollie_profile_by_id** — Update an existing Mollie profile by id. Returns the updated profile including id, name, website, email, status, mode, businessCategory, and createdAt. At least one body field must be provided. Required: id.
- **delete_a_mollie_profile_by_id** — Delete a Mollie profile by id. A deleted profile and its related credentials can no longer be used for accepting payments. Returns an empty 204 response on success. Required: id.
- **list_all_mollie_onboardings** — Get the onboarding status of the currently authenticated organization in Mollie. Returns: resource, name, status, canReceivePayments, canReceiveSettlements, signedUpAt, _links.
- **create_a_mollie_onboarding** — Submit onboarding data to prefill the merchant's onboarding in Mollie. Data is only processed when the onboarding status is needs-data. Mollie recommends using the Client Links API instead. Returns an empty 204 response on success.
- **list_all_mollie_capabilities** — List capabilities for a Mollie organization, showing the onboarding status and requirements for each capability. Returns: resource, name, status, statusReason, requirements. This is a beta feature and the final specification may still change.
- **list_all_mollie_clients** — List all Mollie clients linked to your partner account. Returns: resource, id, commission, organizationCreatedAt, _links, _embedded. Results are paginated.
- **get_single_mollie_client_by_id** — Get a single Mollie client by id. Returns: resource, id, commission, organizationCreatedAt, _links, _embedded, advancedAccessToken. Required: id.
- **create_a_mollie_client_link** — Create a Mollie client link to link a new or existing organization to your OAuth application, creating a new client. Returns: resource, id, owner, name, address, registrationNumber, vatNumber, legalEntity, registrationOffice, incorporationDate, _links. A client link must be used within 30 days of creation. Required: owner, name, address.
- **list_all_mollie_webhooks** — List all Mollie webhooks, optionally filtered by event type. Returns: resource, id, url, profileId, createdAt, name, eventTypes, status, mode, _links.
- **create_a_mollie_webhook** — Create a Mollie webhook with a name, URL, and list of event types. Returns: resource, id, url, profileId, createdAt, name, eventTypes, status, mode, webhookSecret, _links. Required: name, url, eventTypes.
- **get_single_mollie_webhook_by_id** — Get a single Mollie webhook by id. Returns: resource, id, url, profileId, createdAt, name, eventTypes, status, mode, _links. Required: id.
- **update_a_mollie_webhook_by_id** — Update a Mollie webhook by id, editing its name, URL, and subscribed event types. Returns: resource, id, url, profileId, createdAt, name, eventTypes, status, mode, _links, webhookSecret. Required: id.
- **delete_a_mollie_webhook_by_id** — Delete a Mollie webhook by id. Returns an empty 204 response on success. Required: id.
- **create_a_mollie_webhook_ping** — Send a test event to a Mollie webhook to verify the endpoint is working as expected. Returns an empty 202 Accepted response on success. Required: webhook_id.
- **get_single_mollie_event_by_id** — Get a single Mollie webhook event by id. Returns: resource, id, type, entityId, createdAt, _embedded, _links.entity. Required: id.
- **list_all_mollie_connect_balance_transfers** — List all Connect balance transfers in Mollie associated with your organization, including transfers received, sent, or initiated on behalf of clients. Returns: resource, id, amount, source, destination, description, status, statusReason, category, metadata, createdAt, executedAt, mode. If no transfers exist, the resulting array is empty.
- **create_a_mollie_connect_balance_transfer** — Create a Mollie Connect balance transfer between your organization and a connected organization. Returns: resource, id, amount, source, destination, description, status, statusReason, category, metadata, createdAt, executedAt, testmode, mode. Required: resource, id, amount, source, destination, description, status, statusReason, createdAt, mode.
- **get_single_mollie_connect_balance_transfer_by_id** — Get a single Mollie Connect balance transfer by id. Returns: resource, id, amount, source, destination, description, status, statusReason, category, metadata, createdAt, executedAt, testmode, mode. Required: id.
- **list_all_mollie_payments** — List all Mollie payments created with the current website profile. Returns: resource, id, mode, description, amount, amountRefunded, amountRemaining, amountCaptured, amountChargedBack, redirectUrl, cancelUrl, webhookUrl, lines, billingAddress, shippingAddress, locale, countryCode, method, issuer, restrictPaymentMethodsToCountry, metadata, captureMode, captureDelay, captureBefore, applicationFee,…
- **create_a_mollie_payment** — Create a new payment in Mollie. Returns the created payment object including id, status, amount, method, redirectUrl, and _links containing the checkout URL the customer should be redirected to. Specifying a method may unlock additional method-specific parameters not listed here. Required: description, amount, redirectUrl.
- **get_single_mollie_payment_by_id** — Get a single Mollie payment by id. Returns the full payment object including id, status, amount, method, description, createdAt, profileId, and _links. Required: id.
- **update_a_mollie_payment_by_id** — Update certain details of an existing Mollie payment by id. Returns: resource, id, mode, description, amount, amountRefunded, amountRemaining, amountCaptured, amountChargedBack, redirectUrl, cancelUrl, webhookUrl, lines, billingAddress, shippingAddress, locale, countryCode, method, issuer, restrictPaymentMethodsToCountry, metadata, captureMode, captureDelay, captureBefore, applicationFee,…. Required: id.
- **delete_a_mollie_payment_by_id** — Cancel a Mollie payment by id — only possible while the payment status is open and isCancelable is true. Returns the canceled payment object including id, amount, description, status, and createdAt. Required: id.
- **create_a_mollie_payment_release_authorization** — Release the full remaining authorized amount on a Mollie payment. The request is processed asynchronously — on success the payment transitions to canceled (without captures) or paid (with a successful capture). Returns an empty 202 response on success. Required: payment_id.
- **list_all_mollie_unmatched_credit_transfers** — List Mollie unmatched credit transfers for the profile. Returns: resource, id, profileId, amount, source, remittanceInformation, status, createdAt, expiresAt, paymentIds, _links. Beta feature; results are paginated.
- **get_single_mollie_unmatched_credit_transfer_by_id** — Get a single Mollie unmatched credit transfer by id. Returns: resource, id, profileId, amount, source, remittanceInformation, status, createdAt, expiresAt, paymentIds, _links. Beta feature. Required: id.
- **create_a_mollie_unmatched_credit_transfer_match** — Match a Mollie unmatched credit transfer to one or more payments, settling the funds accordingly. Returns the unmatched credit transfer action object including id, status, paymentIds, amount, and createdAt. Beta feature — the final specification may still change. Required: unmatched_credit_transfer_id, paymentIds.
- **create_a_mollie_unmatched_credit_transfer_return** — Return an unmatched credit transfer in Mollie, sending the funds back to the original sender. Returns the unmatched credit transfer action object including resource, id, and createdAt. This is a beta feature and the specification may still change. Required: unmatched_credit_transfer_id.
- **create_a_mollie_session** — Create a Mollie session to start a checkout process with Mollie Components. Returns: resource, id, mode, clientAccessToken, status, amount, description, lines, redirectUrl, billingAddress, shippingAddress, customerId, sequenceType, metadata, payment, profileId, testmode, createdAt, expiredAt, completedAt, _links. This feature is currently in private…. Required: amount, description, lines, redirectUrl.
- **get_single_mollie_session_by_id** — Get a single Mollie session by id to view its details and checkout status. Returns: resource, id, mode, clientAccessToken, status, amount, description, lines, redirectUrl, billingAddress, shippingAddress, customerId, sequenceType, metadata, payment, profileId, testmode, createdAt, expiredAt, completedAt, _links. This feature is currently in private beta and the specification may…. Required: id.
- **list_all_mollie_methods** — List all enabled Mollie payment methods, optionally filtered by sequence type, amount, billing country, and other criteria. Returns: resource, id, description, minimumAmount, maximumAmount, image, status, issuers, _links. Results are not paginated and only online payment methods are included.
- **get_single_mollie_method_by_id** — Get a single Mollie payment method by id. Returns: resource, id, description, minimumAmount, maximumAmount, image, status, issuers, _links. A 404 is returned if the method is not available on the profile, or 403 if available but not yet enabled. Required: id.
- **list_all_mollie_methods_alls** — List all payment methods Mollie offers regardless of organization eligibility. Returns: resource, id, description, minimumAmount, maximumAmount, image, status, issuers, _links, pricing. Results are not paginated. Only online payment methods are returned.
- **create_a_mollie_profile_method** — Enable a payment method on a specific Mollie profile. Returns: resource, id, description, minimumAmount, maximumAmount, image, status, issuers, _links. Some payment methods may return a status of pending-external when extra activation steps at the provider are required. The alias `me` can be used instead of a profile ID when using profile-specific API credentials. Required: profile_id, method_id.
- **delete_a_mollie_profile_method_by_id** — Disable a payment method on a specific Mollie profile. Returns an empty 204 response on success. The alias `me` can be used instead of a profile ID when using profile-specific API credentials. Required: id, profile_id.
- **create_a_mollie_method_issuer** — Enable an issuer for a payment method on a specific Mollie profile. Returns: resource, id, description, status, _links. Currently only the voucher and giftcard payment methods are supported. Required: profile_id, method_id, issuer_id.
- **delete_a_mollie_method_issuer_by_id** — Disable an issuer for a payment method on a specific Mollie profile. Returns an empty 204 response on success. Currently only the voucher and giftcard payment methods are supported. Required: id, profile_id, method_id.
- **list_all_mollie_payment_refunds** — List all refunds for a specific Mollie payment. Returns: resource, id, mode, description, amount, metadata, paymentId, settlementId, status, createdAt, externalReference, reverseRouting, routingReversals, testmode, _links, settlementAmount. Required: payment_id.
- **create_a_mollie_payment_refund** — Create a refund for a specific Mollie payment. The refunded amount is credited to the customer via bank transfer or credit card. Returns: resource, id, mode, description, amount, metadata, paymentId, settlementId, status, createdAt, externalReference, reverseRouting, routingReversals, testmode, _links, settlementAmount. Required: payment_id, resource, id, mode, description, amount, metadata, paymentId, status, createdAt, _links.
- **delete_a_mollie_payment_refund_by_id** — Cancel a pending or queued Mollie payment refund by id. A refund can only be canceled while its status is queued or pending. Returns an empty 204 response on success. Required: id, payment_id.
- **get_single_mollie_payment_refund_by_id** — Get a single Mollie payment refund by id. Returns: resource, id, mode, description, amount, metadata, paymentId, settlementId, status, createdAt, externalReference, reverseRouting, routingReversals, testmode, _links, settlementAmount, entityId, _embedded. Required: id, payment_id.
- **list_all_mollie_refunds** — List all Mollie refunds. Returns: resource, id, mode, description, amount, metadata, paymentId, settlementId, status, createdAt, externalReference, reverseRouting, routingReversals, testmode, _links. The results are paginated.
- **list_all_mollie_payment_chargebacks** — List chargebacks initiated for a specific Mollie payment. Returns: resource, id, amount, reason, paymentId, settlementId, createdAt, reversedAt, _links, settlementAmount, _embedded. Required: payment_id.
- **get_single_mollie_payment_chargeback_by_id** — Get a single Mollie payment chargeback by id and parent payment ID. Returns: resource, id, amount, reason, paymentId, settlementId, createdAt, reversedAt, _links, settlementAmount, _embedded, entityId. Required: id, payment_id.
- **list_all_mollie_chargebacks** — List all chargebacks initiated for your Mollie payments. Returns: resource, id, amount, reason, paymentId, settlementId, createdAt, reversedAt, _links, settlementAmount, _embedded.
- **list_all_mollie_payment_captures** — List all captures created for a specific Mollie payment. Returns: resource, id, mode, description, amount, status, metadata, paymentId, shipmentId, settlementId, createdAt, _links, settlementAmount. Required: payment_id.
- **create_a_mollie_payment_capture** — Create a capture for an authorized Mollie payment configured with manual capture mode. Returns: resource, id, mode, description, amount, status, metadata, paymentId, shipmentId, settlementId, createdAt, _links, settlementAmount. Required: payment_id.
- **get_single_mollie_payment_capture_by_id** — Get a Mollie payment capture by id within the context of its parent payment. Returns the capture object including id, amount, settlementAmount, status, paymentId, shipmentId, and links to the related payment and shipment. Required: id, payment_id.
- **create_a_mollie_applepay_session** — Request an Apple Pay payment session from Mollie for merchant validation in web checkout. The response can be passed as-is to Apple's completeMerchantValidation method. Returns: epochTimestamp, expiresAt, merchantSessionIdentifier, nonce, merchantIdentifier, domainName, displayName, signature. Session objects are not reusable and expire after five minutes; the…. Required: validationUrl, domain.
- **list_all_mollie_payment_links** — List all Mollie payment links, paginated. Returns each payment link with id, description, amount, mode, archived, createdAt, paidAt, expiresAt, reusable, allowedMethods, sequenceType, and _links containing the paymentLink URL.
- **create_a_mollie_payment_link** — Create a Mollie payment link that can be shared with customers to initiate a payment. Returns the created payment link including id, description, amount, mode, archived, createdAt, expiresAt, reusable, allowedMethods, and _links with the paymentLink URL. Required: description.
- **get_single_mollie_payment_link_by_id** — Get a single Mollie payment link by id. Returns the full payment link object including id, description, amount, mode, archived, createdAt, paidAt, expiresAt, reusable, sequenceType, and _links with the paymentLink URL. Required: id.
- **update_a_mollie_payment_link_by_id** — Update certain details of an existing Mollie payment link such as description, archived status, allowedMethods, order lines, and billing/shipping address. Returns the updated payment link including id, description, amount, mode, archived, createdAt, and _links. At least one body parameter must be provided. Required: id.
- **delete_a_mollie_payment_link_by_id** — Delete a Mollie payment link by id. Only payment links that have not been opened and have no payments can be deleted. Returns an empty 204 response on success. Required: id.
- **list_all_mollie_payment_link_payments** — List all payments for a specific Mollie payment link. Returns each payment's id, status, amount, mode, method, createdAt, and paidAt. Required: payment_link_id.
- **list_all_mollie_terminals** — List all physical point-of-sale terminals in Mollie. Returns: resource, id, mode, description, status, brand, model, serialNumber, currency, profileId, createdAt, updatedAt, _links. Results are paginated.
- **get_single_mollie_terminal_by_id** — Get a single Mollie terminal by its id. Returns the terminal object including id, status, brand, model, serialNumber, currency, profileId, createdAt, and updatedAt. Required: id.
- **list_all_mollie_terminals_pairing_codes** — List all Mollie terminal pairing codes (active, expired, and revoked). Returns: resource, id, mode, code, profileId, status, expiresAt, revokedAt, createdAt. Pairing codes can be filtered by profileId.
- **create_a_mollie_terminals_pairing_code** — Create a Mollie terminal pairing code to onboard a point-of-sale terminal. Returns: resource, id, mode, code, profileId, status, details, expiresAt, revokedAt, createdAt, _links. Pass include=details.qrCode to receive a QR code for terminal scanning. Pairing codes expire after 90 days and can be used multiple times. Required: profileId.
- **get_single_mollie_terminals_pairing_code_by_id** — Get a single Mollie terminal pairing code by id. Returns: resource, id, mode, code, profileId, status, details, expiresAt, revokedAt, createdAt, _links. Pass include=details.qrCode to receive a QR code for terminal scanning. Required: id.
- **delete_a_mollie_terminals_pairing_code_by_id** — Revoke a Mollie terminal pairing code by id, preventing onboarding of new terminals. Already paired terminals are not affected. Returns: resource, id, mode, code, profileId, status, details, expiresAt, revokedAt, createdAt, _links. Required: id.
- **list_all_mollie_payment_routes** — List all delayed routes created for a specific Mollie payment. Returns: resource, id, paymentId, amount, description, destination, testmode, createdAt, _links. Required: payment_id.
- **create_a_mollie_payment_route** — Create a delayed route for a specific Mollie payment. The routed amount is credited to the account of your customer. Returns: resource, id, paymentId, amount, description, destination, testmode, createdAt, _links. Required: payment_id, amount, destination.
- **get_single_mollie_payment_route_by_id** — Get a single delayed route by id for a specific Mollie payment. Returns: resource, id, paymentId, amount, description, destination, testmode, createdAt, _links, entityId, _embedded. Required: id, payment_id.
- **list_all_mollie_customers** — List Mollie customers. Returns: resource, id, mode, name, email, locale, metadata, createdAt, testmode, _links. Results are paginated.
- **create_a_mollie_customer** — Create a new Mollie customer. Returns the created customer object including resource, id, mode, name, email, locale, metadata, createdAt, and _links.
- **get_single_mollie_customer_by_id** — Get a single Mollie customer by id. Returns: resource, id, mode, name, email, locale, metadata, createdAt, testmode, _links. Required: id.
- **update_a_mollie_customer_by_id** — Update an existing Mollie customer by id. Returns the updated customer object including resource, id, mode, name, email, locale, metadata, createdAt, and _links. Required: id.
- **delete_a_mollie_customer_by_id** — Delete a Mollie customer by id. All mandates and subscriptions created for this customer will be canceled as well. Returns an empty 204 response on success. Required: id.
- **list_all_mollie_customer_payments** — List all payments linked to a specific Mollie customer. Returns each payment's id, status, amount, method, description, createdAt, and expiresAt. Required: customer_id.
- **create_a_mollie_customer_payment** — Create a payment for a specific Mollie customer. Returns the created payment object including id, amount, description, status, method, mode, createdAt, expiresAt, profileId, sequenceType, redirectUrl, and _links with the checkout URL. Required: customer_id, description, amount, redirectUrl.
- **list_all_mollie_customer_mandates** — List all mandates for a Mollie customer. Returns: resource, id, mode, method, consumerName, consumerAccount, consumerBic, consumerEmail, details, signatureDate, mandateReference, paypalBillingAgreementId, payPalVaultId, scopes, status, customerId, createdAt, testmode, _links. Required: customer_id.
- **create_a_mollie_customer_mandate** — Create a Mollie customer mandate for IBAN or PayPal billing agreements. Returns: resource, id, mode, method, consumerName, consumerAccount, consumerBic, consumerEmail, details, signatureDate, mandateReference, paypalBillingAgreementId, payPalVaultId, scopes, status, customerId, createdAt, testmode, _links. Card mandates require a first payment instead. Required: customer_id, method, consumerName.
- **delete_a_mollie_customer_mandate_by_id** — Revoke a Mollie customer mandate by id. All connected subscriptions will be canceled. Returns an empty 204 response on success. Required: id, customer_id.
- **get_single_mollie_customer_mandate_by_id** — Get a single Mollie customer mandate by id. Returns: resource, id, mode, method, consumerName, consumerAccount, consumerBic, consumerEmail, details, signatureDate, mandateReference, paypalBillingAgreementId, payPalVaultId, scopes, status, customerId, createdAt, testmode, _links, name, email, locale, address, registrationNumber, vatNumber, vatRegulation, verifiedAt. Required: id, customer_id.
- **list_all_mollie_customer_subscriptions** — List all subscriptions for a Mollie customer. Returns: resource, id, mode, status, amount, times, timesRemaining, interval, startDate, nextPaymentDate, description, method, applicationFee, metadata, webhookUrl, customerId, mandateId, createdAt, canceledAt, profileId, testmode, _links. Required: customer_id.
- **update_a_mollie_customer_subscription_by_id** — Update an existing Mollie subscription. Returns the updated subscription object including id, status, amount, interval, times, timesRemaining, customerId, createdAt. Canceled subscriptions cannot be updated. Required: id, customer_id.
- **delete_a_mollie_customer_subscription_by_id** — Cancel a Mollie subscription. Returns the subscription object with status 'canceled', including id, amount, interval, times, timesRemaining, customerId, createdAt. Required: id, customer_id.
- **get_single_mollie_customer_subscription_by_id** — Get a single Mollie subscription by its id and the parent customer's id. Returns: resource, id, mode, status, amount, times, timesRemaining, interval, startDate, nextPaymentDate, description, method, applicationFee, metadata, webhookUrl, customerId, mandateId, createdAt, canceledAt, profileId, testmode, _links, name, email, locale, address, registrationNumber, vatNumber, vatRegulation,…. Required: id, customer_id.
- **create_a_mollie_customer_subscription** — Create a Mollie subscription for a customer to schedule recurring payments at regular intervals. Returns the created subscription object including id, status, amount, interval, description, and createdAt. Required: customer_id.
- **list_all_mollie_subscriptions** — List all Mollie subscriptions initiated across all your customers. Returns each subscription's id, status, amount, interval, customerId, createdAt, and nextPaymentDate.
- **list_all_mollie_subscription_payments** — List all payments of a specific Mollie subscription. Returns: resource, id, mode, description, amount, amountRefunded, amountRemaining, amountCaptured, amountChargedBack, redirectUrl, cancelUrl, webhookUrl, lines, billingAddress, shippingAddress, locale, countryCode, method, issuer, restrictPaymentMethodsToCountry, metadata, captureMode, captureDelay, captureBefore, applicationFee, routing,…. Required: customer_id, subscription_id.
- **list_all_mollie_sales_invoices** — List Mollie sales invoices created through the API. Returns each invoice with id, mode, status, currency, lines, amountDue, totalAmount, isEInvoice, createdAt, and _links.
- **create_a_mollie_sales_invoice** — Create a new Mollie sales invoice to send to customers. Returns the created sales invoice object including id, mode, status, currency, recipient, lines, amountDue, totalAmount, isEInvoice, createdAt, and _links. Required: status, recipientIdentifier, recipient, lines.
- **get_single_mollie_sales_invoice_by_id** — Get a single Mollie sales invoice by id. Returns the sales invoice object including id, mode, status, currency, recipient, lines, amountDue, totalAmount, isEInvoice, createdAt, and _links. Required: id.
- **update_a_mollie_sales_invoice_by_id** — Update details of an existing Mollie sales invoice by id. For draft status all listed fields can be updated; for paid and issued statuses paymentDetails and emailDetails are required respectively. Returns the updated sales invoice object including id, mode, status, currency, recipient, lines, amountDue, totalAmount, isEInvoice, createdAt, and _links. Required: id.
- **delete_a_mollie_sales_invoice_by_id** — Delete a Mollie sales invoice by id. Only invoices in draft status can be deleted; for other statuses use the update endpoint instead. Returns an empty 204 response on success. This is a beta feature. Required: id.
- **list_all_mollie_business_accounts_accounts** — List all Mollie business accounts for the authenticated organization. Returns each account with resource, id, mode, accountDetails, status, balance, and createdAt. Results are paginated.
- **get_single_mollie_business_accounts_account_by_id** — Get a single Mollie business account by id. Returns the full account object including resource, id, mode, accountDetails, status, balance, and createdAt. Required: id.
- **list_all_mollie_account_transactions** — List all transactions for a specific Mollie business account. Returns: resource, id, businessAccountId, creditDebitIndicator, type, amount, description, counterparty, afterBalance, processedAt, mode, createdAt. Required: business_account_id.
- **get_single_mollie_account_transaction_by_id** — Get a single Mollie business account transaction by id. Returns: resource, id, businessAccountId, creditDebitIndicator, type, amount, description, counterparty, afterBalance, processedAt, mode, createdAt. Required: id, business_account_id.
- **create_a_mollie_business_accounts_transfer** — Create a SEPA Credit Transfer from a Mollie Business Account. Returns the created transfer object including id, status, amount, debtor, creditor, statusHistory, and createdAt. Required: debtorIban, creditor, amount, transferScheme.
- **get_single_mollie_business_accounts_transfer_by_id** — Get a single Mollie business account transfer by id. Returns the transfer object including id, status, amount, debtor, creditor, statusHistory, and createdAt. Required: id.
- **create_a_mollie_business_accounts_payee_verification** — Perform a Verification of Payee (VoP) check in Mollie to verify the account holder name against the receiving bank's records before initiating a transfer. Returns: resource, mode, creditorBankAccount, verificationResult, createdAt. Beta feature — the specification may still change. Required: creditorBankAccount.
- **list_all_mollie_payouts** — List all payouts for your Mollie organization, including automatic and manually requested payouts. Returns: resource, id, balanceId, amount, description, status, statusReason, createdAt, initiatedAt, completedAt, canceledAt, mode, testmode, _links. Only payouts created on or after April 1st, 2026 are returned.
- **create_a_mollie_payout** — Create a payout in Mollie from one of your balances to its configured bank account. Returns: resource, id, balanceId, amount, description, status, statusReason, createdAt, initiatedAt, completedAt, canceledAt, mode, testmode, _links. If no amount is specified, the full available balance minus any configured balance reserve is paid out. Creating a payout via the API pauses the…. Required: resource, id, balanceId, status, statusReason, createdAt, mode.
- **get_single_mollie_payout_by_id** — Get a single Mollie payout by id. Returns: resource, id, balanceId, amount, description, status, statusReason, createdAt, initiatedAt, completedAt, canceledAt, mode, testmode, _links. Required: id.
- **delete_a_mollie_payout_by_id** — Cancel a Mollie payout by id. The payout must still have status `requested` to be cancelable; once it moves to `initiated`, cancellation is no longer possible. Returns the canceled payout object including resource, id, balanceId, amount, status, createdAt, mode, _links. Required: id.
- **list_all_mollie_profiles_current** — Get the currently authenticated Mollie profile associated with the API credential. Returns: resource, id, mode, name, website, email, phone, description, countriesOfActivity, businessCategory, status, review, createdAt, _links. No required parameters.

## How it works

1. **Link your customer's Mollie account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach Mollie.** The Proxy API is a 1-to-1 mapping of the Mollie API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Embed Mollie payments in vertical SaaS checkouts** — Let your users accept European local payment methods (iDEAL, Bancontact, SEPA, Klarna) and global cards through your product without leaving your UI. Truto handles OAuth so merchants connect their Mollie account in one click.
- **Power marketplace split payments and application fees** — For multi-vendor platforms, orchestrate Mollie Connect flows to route funds to individual sellers and retain a platform commission on every transaction—without holding funds yourself or taking on PSP licensing.
- **Automate subscription billing with SEPA mandates** — Membership, gym, and SaaS billing products can capture SEPA Direct Debit mandates during signup and then charge customers on a recurring schedule via Mollie subscriptions, all managed inside your app.
- **Sync settlements and payouts into accounting/ERP tools** — Accounting, invoicing, and ERP platforms can reconcile Mollie settlements, payments, refunds, and chargebacks against a merchant's ledger automatically, eliminating manual bank reconciliation.
- **Unify online and in-person payments for retail SaaS** — POS, ticketing, and field-service SaaS can pair Mollie physical terminals to their app and process card-present transactions that flow into the same reporting as their online sales.

## What you can build

- **One-click Mollie merchant onboarding** — Use OAuth2 and Mollie client links so your users connect (or create) their Mollie account from inside your product, with linked profiles ready to transact immediately.
- **Native checkout with Payment Links and Sessions** — Generate dynamic hosted checkout sessions or shareable payment links from your app and embed them into invoices, quotes, emails, or SMS.
- **Marketplace split payments engine** — Create payments with payment routes and connect balance transfers to disburse funds across multiple sellers and automatically deduct a platform fee per order.
- **Recurring billing with SEPA/mandate management** — Create Mollie customers, capture mandates, and provision subscriptions from your billing UI, with lifecycle updates (pause, cancel, update) exposed to your users.
- **In-app refunds, chargebacks, and dispute tracking** — Let merchants issue refunds and review chargebacks on payments directly from your dashboard, keeping support workflows inside your product.
- **Automated settlement reconciliation** — Pull settlements along with their underlying payments, refunds, captures, and chargebacks to reconcile payouts against orders and invoices in your accounting module.

## FAQs

### How do end users authenticate their Mollie account?

Truto handles Mollie's OAuth2 flow end-to-end. Your users click connect, authorize your app on Mollie, and Truto stores and refreshes the token—no API key handling on your side. Token creation and bulk revocation are both supported.

### Does this support Mollie Connect for marketplaces and platforms?

Yes. Once a merchant connects via OAuth, you can create client links, create payments with payment routes, initiate connect balance transfers between organizations, and manage profiles, onboarding, and capabilities on their behalf.

### Can we receive real-time payment events?

Yes. You can programmatically register Mollie webhooks per profile/payment, retrieve events, and send test pings. Truto normalizes webhook delivery so you receive events reliably in your backend without managing signature verification per tenant.

### Which payment operations are supported?

The full payment lifecycle is covered: create/list/get/update/cancel payments, captures, refunds, chargebacks, payment links, sessions, and release authorizations. You can also list available payment methods per profile, including enabling or disabling methods and configuring issuers.

### Can we support in-person payments via Mollie terminals?

Yes. You can list terminals, create and manage pairing codes to associate a physical terminal with a merchant profile, and route card-present payments through the same Mollie account as online transactions.

### How do we reconcile settlements and payouts?

You can list settlements (including open and next), fetch a settlement's payments, refunds, captures, and chargebacks, and pull balance transactions and balance reports. Payouts to a merchant's verified bank account can also be created and retrieved programmatically.

### How is pagination handled across list endpoints?

Truto abstracts Mollie's cursor-based pagination behind a consistent interface, so listing payments, customers, settlements, or subscriptions works the same way regardless of the underlying resource.
