API Reference

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 awaiting-initiation 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

ActionTest-mode behavior
CreateAlways returns a synthetic draft in awaiting-initiation, regardless of most input values
Get / ListAlways returns synthetic awaiting-initiation draft(s), not your real data
CancelAlways returns a synthetic declined draft

There is currently no way to synthesize an initiated draft via test mode alone. Initiation only happens when a real initiator approves in Mollie Apps, which test mode doesn't touch.

🔑

Access with

Advanced access token with business-account-draft-transfers.writeOAuth access with business-account-draft-transfers.write
Body Params
string

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.

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.

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.

Responses

Updated about 2 hours ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Choose an example:
application/hal+json

Updated about 2 hours ago

Did this page help you?