Getting Started with Lemonway

Test Environment and Default Accounts

Introduction

We currently have two versions of our API. API v1 is SOAP based and is being phased out to make way of our REST API that makes it easier to integrate with your code.

Getting Started for Developers

The guide uses PHP syntax but it should be comprehensible for developers using other technologies (Ruby Python, NodeJs, Java, .NET..)
https://github.com/lemonwaysas/php-client-directkit-json2#time-to-play

🚧

Important

We do not send live environment access on Fridays.

The Lemonway Test Environment

The test environment will remain available throughout the duration of the contract.
An environment comes with 3 URLs:

  • Directkit URL to access our webservices
  • Webkit URL for the payment page with card input form, electronic signature
  • Backoffice URL to monitor your payments from your dashboard

Specific data related to the test environment are:

Mercanet V1 (ATOS)

Lemonway's fees (can be changed to match the ones in your signed contract)1% + 0.50 EUR for all Money-In operations
These are mock fees, paid with pretend money.1 EUR for all Money-Out operations
Money-In using Atos v1 (Mercanet)CVV code: 3 digits
Date: any date in the future, before 2030
Number:
For a successful payment without 3D Secure
5017670000005900
5017670000006700
5017670000007500
5017670000008300
For a successful payment in 3D Secure
5017670000001800
5017670000002600
5017670000004200
For a payment refused by the card owner's bank
5.01767E+15
3D Secure authentication: leave the default selected option in order to make a successful authentication.
Amex Card
PAN: A
Cryptogramme (CID): 1234
Date : A future date
Number: 373953192351004 
PAN: B
Cryptogramme (CID): 1234
Date : A future date
Number: 341111599241000

Mercanet V2 (ATOS)

Lemonway's fees (can be changed to match the ones in your signed contract)1% + 0.50 EUR for all Money-In operations
These are mock fees, paid with pretend money.1 EUR for all Money-Out operations
Money-In using Mercanet v2 (Atos )CVV code: 3 digits
Date: any date in the future, before 2030
Number:
5017674000000000
5017674000000010
5017674000000020
3D Secure authentication: leave the default selected option in order to make a successful authentication.
If these test cards are refused, please use other test cards from the merchant website to simulate a different situation

Payxpert

Lemonway's fees (can be changed to match the ones in your signed contract)1% + 0.50 EUR for all Money-In operations
These are mock fees, paid with pretend money.1 EUR for all Money-Out operations
Money-In using PayxpertCVV code: 000
Date: 10/2024
Number:
4111111111111111 for a successful payment in 3D Secure
4012888888881881 for a successful payment without 3D Secure
5105105105105100 for a successful payment without 3D Secure
5555555555554444 for a successful payment without 3D Secure

iDEAL

Lemonway's fees (can be changed to match the ones in your signed contract)1% + 0.50 EUR for all Money-In operations
These are mock fees, paid with pretend money.1 EUR for all Money-Out operations
Money-In using iDEALIssuer Bank: Issuer bank ID: 121

Sofort

Lemonway's fees (can be changed to match the ones in your signed contract)1% + 0.50 EUR for all Money-In operations
These are mock fees, paid with pretend money.1 EUR for all Money-Out operations
Money-In using SofortCountry of your bank: Germany
Sort code or BIC: 88888888
Account number: 234567
PIN: 12345
TAN: 12345

Paytrail

Lemonway's fees (can be changed to match the ones in your signed contract)1% + 0.50 EUR for all Money-In operations
These are mock fees, paid with pretend money.1 EUR for all Money-Out operations
Money-In using PaytrailNordea
ID: 123456
Password: 1234
Osuuspankki
User ID: 123456
Password: 7890
Keynumber: Any number
Danske Bank: Use your own user ID for testing. Payments will not be charged to your bank account.
LähiTapiola
Customer number: 12345678
ID code: 9999
Ålandsbanken
User ID: 12345678
ID code: 1234
SpPop
User ID: 11111111
Password: 123456
Security code: 123456
Handelsbanken
User ID: System fills it for you
ID code: System fills it for you
S-Pankki
Username: 12345678
Password: 9999
Key number: 1234

Payzen

These are mock fees, paid with pretend money.1 EUR for all Money-Out operations
Money-In using PayzenYou select the test card on the test payment page (Select the type of the card then click on the card number in the middle of the bottom text)

Login to Access Our API

We provide an account to get access to our API v1:

  • society login with default 123456 password (that you should change). This login is for developers. You have access to all methods of our API Directkit, and limited access to the Backoffice.

For secure account acccess for v1 and v2 see: Authentication

You may change passwords in the Backoffice/Dashboard as follows:

LoginPassType
society….....mbWsdmin

You can also create more accounts if needed for your business.

Your own technical account SC for fees management

The specific technical account SC, which stands for SOCIETY is used to collect your fees. It is also used by Lemonway to collect our fees. Please be aware this account's balance can only be positive, as any payment account in our system.
This means, if this technical account does not have enough money to pay Lemonway fees, your payments will not be processed and an error will be returned from our API.
You can credit this technical account using your company's Visa or Mastercard card, call the Money-In method in order to do so, or you can also do a fund transfer to our Lemonway bank account, with a specific description of the fund transfer.