---
title: "Initialize iDeal Payment"
method: POST
path: "/v2/moneyins/ideal/init"
tags: ["MoneyIns | Local Payments"]
---

# Initialize iDeal Payment

`POST /v2/moneyins/ideal/init`

## Request

- Base URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest`
- URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest/v2/moneyins/ideal/init`
- Auth: none declared. Required headers: `Authorization`, `PSU-IP-Address`

You will need 3 integration points on your code:
<ul><li>One call to Lemonway DirectKit API to init iDeal payment to credit the payment account</li><li>One redirection from your website to the return URL by IDealInit</li><li>One call to Lemonway DirectKit API to finalize the iDeal payment</li></ul>

## Headers

- `Authorization` string, required
- `PSU-Accept-Language` string
- `PSU-IP-Address` string, required
- `PSU-User-Agent` string

## Request body

- MoneyInIDealInitInput
  - `returnUrl` string, required: Your sites return URL, called to terminate the operation and on which the callback will be sent, with data in POST parameters. This URL must contain a unique ID so you know which operation is related to the return.
  - `issuerId` string, required: ID of iDEAL Issuer Resource: 1. 21 for Rabobank 2. 31 for ABN Amro 3. 721 for ING 4. 751 for SNS Bank 5. 161 for Van Lanschot Bankiers 6. 511 for Triodos Bank 7. 761 for ASN Bank 8. 771 for RegioBank 9. 801 for Knab Bank 10. BUNQNL2A pour Bunk Bank
  - `reference` string: Unique ID of the call, generated by your server. This ID can be used as a search field when looking for operation details
  - `accountId` string, required: Payment Account ID to Credit
  - `totalAmount` integer: Amount to Debit Amounts are given as integer numbers in cents
  - `commissionAmount` integer: Your Fee Amounts are given as integer numbers in cents
  - `comment` string: Comment Regarding the Transaction
  - `autoCommission` boolean: If true: 1. [amountCom] will be ignored and will be replaced with Lemonway's fee 2. You will not receive any fee

## Response `200`

OK

- MoneyInIDealInitOutput
  - `id` integer: Transaction ID. You will this this value to confirm the transaction
  - `actionUrl` string: Redirected URL for the client on the iDeal page payment
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string: Get the Error Message from PSP

## Other responses

- `401`: Unauthorized
- `500`: InternalServerError

---

[API](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0.md) - [All operations](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/revisions/82551a0a77b8?raw)