Initializes an APM transaction.

How it works

Lemonway currently provides services for four APMs:

  • iDEAL

  • Bancontact

  • Multibanco

  • MBWay

    All Alternative Payment Methods (APMs) follow the same redirect-based flow, whichever payment method you choose:
  1. Initialize the payment: your platform calls POST /v2/moneyins/apm/init with the transaction details, the payer's details, and your redirect URLs.
  2. Redirect the payer: Lemonway returns a transaction id and a redirectUrl. Your platform redirects the payer to this URL exactly as provided. No token exchange is required.
  3. The payer completes the payment: the payer is shown the payment page for the selected method and completes the payment.
  4. Get the result: Lemonway updates the transaction status, sends a notification to your platform, and redirects the payer to your returnUrl, cancelUrl or errorUrl.

For detailed information about each APM method, see: https://documentation.lemonway.com/docs/apm

Body Params

Represents the input data for initializing an APM transaction.

transaction
object

Transaction

paymentUrls
object

PaymentUrls

customer
object

Customer

string

Preferred language for the payment flow (e.g., fr, nl, de, en).

string

URL used for app-to-app redirection.

int32

Timeout for the transaction in minutes.

Headers
string
required

Authorization bearer (OAuth 2)

string

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

string
required

IP address of the final client (PSU).

string

User-agent of the final client (PSU).

Responses

401

Unauthorized

500

InternalServerError

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json