Alternative Payment Methods (APM)

Lemonway enables its partners to accept payments through Alternative Payment Methods (APMs), offering customers convenient local payment options beyond traditional card payments. The available payment methods include iDEAL in the Netherlands, Bancontact in Belgium, and Multibanco and MB WAY in Portugal. Each method provides a payment experience adapted to local customer preferences, helping partners offer more choice at checkout. APM payments use a redirection flow. When a customer selects a payment method, your platform initiates the transaction through Lemonway's existing REST API using the /apm/init endpoint. Lemonway returns a redirectUrl, which your platform uses to redirect the customer to complete the payment. Once the payment result is known, Lemonway updates the transaction status and notifies your platform. The payment confirmation process depends on the selected method: iDEAL, Bancontact and MB WAY provide real-time confirmation, while Multibanco payments are confirmed after the customer completes the payment, which can take up to seven days.

Overview

Lemonway offers Alternative Payment Methods (APMs), enabling you to accept iDEAL (Netherlands), Bancontact (Belgium), and Multibanco (Portugal) using a seamless redirect-based payment flow.

These APMs operate using Lemonway's existing REST API (Webkit). Your platform only needs to call the /apm/init API and redirect the user.

Payment MethodTechnical CodeRequired countryCodePayer Phone FormatReal-Time Settlement?Refund Window Length
iDEALidealNL (Netherlands)OptionalYes (Instant)Up to 99 days
BancontactbancontactBE (Belgium)OptionalYes (Instant)Up to 12 months
MultibancomultibancoPT (Portugal)OptionalNo (Deferred up to 7 days)Up to 12 months
MBWaymbwayPT (Portugal)Mandatory (+351...)Yes (Instant Mobile Push)Up to 12 months
👍

Refunds

APM refunds behave identically to card refunds, via the /refund/{transactionId} endpoint.

Initiate an APM Payment

POST /apm/init

For a complete list of parameters and additional information, see here.

Example Request:

{
  "transaction": {
    "Reference": "ref-12345",
    "AccountId": "MKP",
    "totalAmount": 15000,
    "PaymentMethod": "multibanco",
    "commissionAmount": 1000,
    "comment": "Online purchase",
    "autoCommission": false
  },
  "paymentUrls": {
    "redirections": {
      "returnUrl": "https://merchant.com/payment/success",
      "errorUrl": "https://merchant.com/payment/error",
      "cancelUrl": "https://merchant.com/payment/cancel"
    }
  },
  "customer": {
    "firstName": "Pierre",
    "lastName": "Dupont",
    "countryCode": "PT",
    "email": "[email protected]",
    "mobilePhone": "+351912345678",
    "birthDate": "1985-05-15"
  }
}

Required Rules

MethodRequired countryCode
ideal"NL" 🇳🇱 only
bancontact"BE" 🇧🇪 only
multibanco"PT" 🇵🇹 only
MBWay"PT" 🇵🇹 only
❗

Important

Any countryCode mismatch triggers an API error.

Example Response

{
  "id": 362529,
  "redirectUrl": "https://webkit.lemonway.com/.../apm/form/{token}"
}
👍

Information

Your platform should use the redirectUrl exactly as provided. There is no token exchange step.


APM Refunds

APM refunds behave identically to card refunds; use the PUT /refund/{transactionId}

iDEAL, Bancontact, Multibanco and MBWAY Payins support:

  • Multiple refunds
  • Partial refunds
  • Full refunds

Did this page help you?