Funding

Fund by bank (iDEAL / open banking)

The preferred way to fund a wallet in the Netherlands and supported EU countries. Redirects the user to their bank via ibanXS.

get_fund_by_bank_countries

List countries where bank-funded top-ups are available.

get_fund_by_bank_countries(page?: number, pageSize?: number)

---

get_fund_by_bank_banks

List supported banks for a given country.

get_fund_by_bank_banks(
  countryCode: string,   // ISO 3166-1 alpha-2, e.g. "NL"
  page?: number,
  pageSize?: number
)

---

create_fund_by_bank_session

Start a bank funding session. Minimum €5.00. Returns a redirect URL to send the user to their bank.

create_fund_by_bank_session(
  countryCode: string,
  bankId: string,           // From get_fund_by_bank_banks
  amount: number,           // Minimum 5.00
  redirectUrl: string,      // Where to redirect after bank flow
  accountCode: string,      // Destination EURD account
  bankTransferDescription?: string,
  callbackUrl?: string      // Webhook when funding completes
)

Returns: { sessionReference, redirectUrl }

---

get_fund_by_bank_session_status

Check whether a funding session completed.

get_fund_by_bank_session_status(sessionReference: string)

Status values: Pending · Completed · Failed · Expired

---

get_last_successful_funding

Retrieve the most recent bank/country combination the user successfully funded from. Useful for pre-filling the funding form.

get_last_successful_funding()

---

retry_fund_by_bank_session

Retry a failed funding session, for example when IBAN-name verification failed.

retry_fund_by_bank_session(
  sessionId: string,
  redirectUrl: string,
  overrideCreditorName?: string
)

---

Funding requests

Use funding requests when you want an external party to fund an account via SEPA bank transfer — without going through the iDEAL flow.

create_funding_request

create_funding_request(
  accountCode: string,
  amount: number,
  message?: string,
  expiresOn?: string,             // ISO 8601
  allowDifferentAmount?: boolean,
  reference?: string,             // Max 100 chars
  callbackURL?: string,
  fundingReason?: string,
  metadata?: string
)

---

list_funding_requests

list_funding_requests(
  status?: "Open" | "Received" | "Expired" | "Cancelled",
  accountCode?: string,
  startDate?: string,
  endDate?: string,
  page?: number,
  pageSize?: number
)

---

get_funding_request

get_funding_request(fundingRequestCode: string)

---

delete_funding_request

Cancel an open funding request.

delete_funding_request(fundingRequestCode: string)