MoneyOut: external fund transfer from a Wallet to a bank account

This method makes a MONEY-OUT: a selected Wallet is debited from a selected amount (total amount or partial amount). This amount is credited onto the IBAN attached to the Wallet.

When the method is called, the Wallet is debited immediatly.

The fund transfer is then processed the same day or the next working day, when Lemon Way proceeds to all fund transfers for all its customers, after 10:30 Paris time.

If MONEY-OUT fees exist, they are collected when this method is called.

Version

Description

1.1

Entry: one IBAN ID can be entered

1.3

Entry: "autoCommission" value is to automatically take Lemon Way fee out of the amount to be sent to the customer

How it works

Choose an IBAN if multiple IBAN exist for the Wallet. Choose an amount, not greater than the balance of the wallet. Call "MoneyOut", and the system performs the fund transfer to the IBAN if everything is clear, or returns an error message.

  • The wallet is debited immediately and the money is then received by the owner, on their bank account after 1 to 3 days, depending on the interbanking system and on the banks (SEPA is faster).
  • You can ask us to configure your platform so that your comment is included in the bank transfer message so your customer will see it on the bank statement. 
    • The full message will be in the following format "XXXX-YYYY ZZZZ", where : 
      • XXXX is the name of your environment
      • YYYY is the ID of the money-out operation as you see it in the backoffice
      • ZZZZ is your comment.
    • The full message cannot be longer than 35 characters (if longer, it will be cut), and only alphanumeric characters will be allowed (other characters will be replaced by spaces before it's sent to the bank).

Request

<MoneyOut xmlns="Service_mb">

  <wlLogin>string</wlLogin>

  <wlPass>string</wlPass>

  <language>string</language>

  <version>string</version>

  <walletIp>string</walletIp>

  <walletUa>string</walletUa>

  <wallet>string</wallet>

  <amountTot>string</amountTot>

  <amountCom>string</amountCom>

  <message>string</message>

  <ibanId>string</ibanId> <!-- since version 1.1 -->

  <autoCommission>string</autoCommission> <!-- since la version 1.3 -->

</MoneyOut>

  
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "wallet":"string",
    "amountTot":"string",
    "amountCom":"string",
    "message":"string",
    "ibanId":"string",
    "autoCommission":"string"
}

Version

Item

Description

Mandatory

Format

Example

>= 1.0

wallet

Wallet ID to be debited

Yes

[0 : 256] char

33612345678 or taxi67

>= 1.0

amountTot

Total amount to debit from the Wallet.
The CLIENT will receive on his bank account [amountTot] minus [amountCom]

Yes

2 decimals

15.00

>= 1.0

amountCom

WHITE BRAND fee

No

2 decimals

3.00

>= 1.0

message

Payment Comment

No

[0 :140] char

Order number 2457765AX2

>= 1.1

ibanId

IBAN ID
If no IBAN is specified, the last verified (validated) IBAN will be used.

No

[0 : 10]

253

>= 1.3

autoCommission

This should be set to No (0) for most White Label.
If yes:

  • [amountCom] will be ignored and will be replaced with Lemon Way's fee
  • The white label will not receive any fee

Yes

0 ou 1

0: fee is not debited automatically
1: fee is automatically debited

Answer

<?xml version="1.0" encoding="utf-8"?>
<TRANS>
	<HPAY>
		<ID>string</ID>
		<MLABEL>string</MLABEL>
		<MID>string</MID> <!--since version 1.1 -->
		<DATE> string </DATE>
		<SEN> string </SEN>
		<REC> string </REC>
		<DEB> string </DEB>
		<CRED> string </CRED>
		<COM> string </COM>
		<MSG> string </MSG>
		<STATUS> string</STATUS>
	</HPAY>
</TRANS>
{  
    "TRANS":{  
        "HPAY":{  
            "ID":"string",
            "MLABEL":"string",
            "MID":"string",
            "DATE":" string ",
            "SEN":" string ",
            "REC":" string ",
            "DEB":" string ",
            "CRED":" string ",
            "COM":" string ",
            "MSG":" string ",
            "STATUS":" string"
        }
    }
}

Version

Item

Description

Example

>= 1.0

ID

Request ID

255

>= 1.0

MLABEL

IBAN for PAY-OUT or MONEY-OUT

FR5830002012300000116235A61

>= 1.1

MID

IBAN ID used for MONEY-OUT

5

>= 1.0

DATE

Request Date

10/09/2011 18:09:27

>= 1.0

SEN

Wallet doing the fund transfer

Pizza56

>= 1.0

REC

Empty in this case

>= 1.0

DEB

Amount to debit from the wallet

15.00

>= 1.0

CRED

0 in this case

3.00

>= 1.0

COM

WHITE BRAND fee

0.00

>= 1.0

MSG

Comment

Order number 245776

>= 1.0

STATUS

3: transaction successful
4: refused
0: waiting for validation