FAQs

1. Can I use other payment methods?

Yes, our architecture supports adding more APMs, but availability depends on Lemonway's roadmap.

2. How do I test these payment methods?

Request a sandbox APM activation from Lemonway. Your technical integration remains the same in sandbox and production.

3. When does the user return to my website?

After the APM result is known, Lemonway redirects the user to:

• returnUrl → payment succeeded
• cancelUrl → user cancelled
• errorUrl → payment failed/refused

4. Why must countryCode match the payment method?

Because the underlying schemes require it:

• iDEAL is restricted to Dutch customers
• Bancontact is restricted to Belgian customers
• Multibanco is restricted to Portuguese customers
• Mbway is restricted to Portuguese customers

Any other value causes the API to reject the request.

5. How long does the payer have to complete a Multibanco payment?

Multibanco is a post-pay method. By default, the payer has 7 days to complete the payment. You can shorten this period with the optional timeoutInMinutes parameter.

6. Are chargebacks possible?

No. These payment methods do not support chargebacks through Lemonway. Refunds must be issued via /refund/{transactionId}.

7. What happens if the payer abandons the payment?

If the payment is not completed before it expires, Lemonway finalizes the transaction as Cancelled.

8. How do I know the final status?

Use any combination of:

• Your notification endpoint
• Lemonway GET /v2/moneyins or your Dashboard for payment statuses
• The user redirect path (returnUrl / cancelUrl / errorUrl)