LElemonway
MoneyIns | Local Payments

Initialize iDeal Payment

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

Headers

Authorizationstring required

Authorization bearer (OAuth 2)

PSU-Accept-Languagestring

Response language accepted by final client (PSU). English by default

PSU-IP-Addressstring required

IP address of the final client (PSU).

PSU-User-Agentstring

User-agent of the final client (PSU).

Request body

returnUrlstring 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.

issuerIdstring 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
referencestring

Unique ID of the call, generated by your server. This ID can be used as a search field when looking for operation details

accountIdstring required

Payment Account ID to Credit

totalAmountinteger

Amount to Debit Amounts are given as integer numbers in cents

commissionAmountinteger

Your Fee Amounts are given as integer numbers in cents

commentstring

Comment Regarding the Transaction

autoCommissionboolean

If true:

  1. [amountCom] will be ignored and will be replaced with Lemonway's fee
  2. You will not receive any fee

Example request

{
  "returnUrl": "https://www.yoursite.com/payment_return.php/?id=367GBD",
  "issuerId": "161",
  "reference": "Dze8778",
  "accountId": "33612345678",
  "totalAmount": 1500,
  "commissionAmount": 100,
  "comment": "Order number 2457765AX2",
  "autoCommission": false
}

Response

OK

idinteger

Transaction ID. You will this this value to confirm the transaction

actionUrlstring

Redirected URL for the client on the iDeal page payment

Changes

No recorded changes to this operation across all 1 revision of this API.