Create draft transfer

post

https://api.mollie.com/v2/business-accounts/draft-transfers

🚧
Beta feature
This feature is currently in beta testing, and the final specification may still change.

Creates a draft transfer. The draft transfer immediately enters pending-review and appears in the initiator's queue in Mollie Apps. It carries no legal weight and moves no funds until a human initiator approves it there.

Test mode

Creating a draft transfer always returns a synthetic draft in pending-review, using synthetic data, same as in live mode. No real funds move and nothing is sent to Mollie Apps.

Shortly after, you can simulate the initiator's decision by adjusting the transfer amount:

Amount	Simulated outcome	Webhook sequence
`13.00`	Declined by the initiator, with a free-text reason	`business-account-draft-transfer.created` → `business-account-draft-transfer.declined`
Other	Approved by the initiator	`business-account-draft-transfer.created` → `business-account-draft-transfer.approved`

The webhooks fire asynchronously, with a short delay between them to mimic real timing. Get and list reflect the simulated outcome once it lands.

Cancelling (via DELETE) is unaffected by the amount: it always transitions the draft to declined with statusReason.code set to deleted-by-creator, the same as in live mode.

🔑
Access with
Advanced access token with business-account-draft-transfers.writeOAuth access with business-account-draft-transfers.write

Body Params

debtorIban

string

^[A-Z]{2}[0-9]{2}[A-Z0-9 ]+$

The IBAN of the debtor's (sender) Mollie Business Account. Defaults to your organization's primary account if omitted.

creditor

object

required

The creditor (recipient) of the draft transfer, including their name and account details.

amount

object

required

The amount of the draft transfer, e.g. {"currency":"EUR", "value":"100.00"} if you would want to transfer €100.00.

Only EUR is supported.

description

string | null

required

A short description of the draft transfer. Once approved, this will appear on the bank statement of both the debtor and creditor.

scheduledExecutionDate

date | null

The date on which the resulting transfer will be executed, once approved. Defaults to same-day if omitted, in ISO 8601 date format.

testmode

boolean | null

Whether to create the entity in test mode or live mode.

Most API credentials are specifically created for either live mode or test mode, in which case this parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting testmode to true.

Responses

Language

Credentials

Loading…

Response

Choose an example:

application/hal+json

201The newly created draft transfer object.

422The request contains issues. For example, if a required field is missing, or if the creditor IBAN is invalid.

429Rate Limit has been reached.