MoneyOut : Virement externe
Version | Description |
|---|---|
1.1 | Entrée : il est possible de renseigner un identifiant d'IBAN en entrée |
1.3 | Entrée : la valeur « autoCommission » permet maintenant à la marque blanche de déduire automatiquement une commission du virement, cette commission étant égale à celle due à Lemonway |
Cinématique
Cette méthode permet de solder entièrement ou partiellement un wallet en faisant un virement externe du wallet vers un compte bancaire, en prélevant les commissions du marchand (marque blanche) et de Lemonway.
- Une fois la requête envoyée, le wallet associé est de suite débité du montant. Les virements partent ensuite en banque tous les matins ouvrés à 10h30, heure de Paris.
- Le dernier IBAN actif associé au wallet est utilisé si aucun identifiant d'IBAN n'est donné en entrée.
- Il est possible de nous demander de paramétrer votre plateforme pour que votre commentaire personnalisé soit associé au libellé bancaire que recevra votre client.
- Le libellé complet sera du format suivant : "XXXX-YYYY ZZZZ", où :
- XXXX est le nom de votre environnement
- YYYY est l'identifiant de l'opération de money-out tel que vous le voyez dans notre backoffice
- ZZZZ est votre commentaire
- Le message entier ne peut pas dépasser 35 caractères (il sera coupé si c'est le cas), et uniquement les caractères alphanumériques sont autorisés (tout autre caractère sera remplacé par un espace avant d'être envoyé en banque)
- Le libellé complet sera du format suivant : "XXXX-YYYY ZZZZ", où :
Requête
XML
<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> <!-- à partir de la version 1.1 -->
<autoCommission>string</autoCommission> <!-- à partir de la version 1.3 -->
</MoneyOut>
JSON
{
"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 | Element | Description | Requis | Format | Exemple |
|---|---|---|---|---|---|
>= 1.0 | wallet | Identifiant du wallet à débiter | Oui | [0 : 256] car | 33612345678 ou taxi67 |
>= 1.0 | amountTot | Montant total à débiter du wallet. | Oui | 2 décimales | 15.00 |
>= 1.0 | amountCom | Montant de la commission prélevée par la MARQUE BLANCHE | Non | 2 décimales | 3.00 |
>= 1.0 | message | Commentaire du paiement | Non | [0 :140] car | Commande numéro 245 |
>= 1.1 | ibanId | Identifiant de l'IBAN à créditer. Si aucun identifiant n'est renseigné, l'opération s'effectuera sur le dernier IBAN activé du wallet | Non | entier | 253 |
>= 1.3 | autoCommission | Si oui :
| Oui | 0 ou 1 | 0 : ne pas déduire la commission automatiquement. |
Réponse
XML
<?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<MLABEL>string</MLABEL>
<MID>string</MID> <!--à partir de la 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>
JSON
{
"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 | Element | Description | Exemple |
|---|---|---|---|
>= 1.0 | ID | identifiant de la demande | 255 |
>= 1.0 | MLABEL | IBAN sur lequel le virement sera effectué | FR5830002012300000116235A61 |
>= 1.1 | MID | ID De l'IBAN sur lequel le virement sera effectué | 5 |
>= 1.0 | DATE | Date de la demande | 10/09/2011 18:09:27 |
>= 1.0 | SEN | Wallet effectuant le virement | Pizza56 |
>= 1.0 | REC | Vide dans ce cas | |
>= 1.0 | DEB | Montant à débiter du wallet | 15.00 |
>= 1.0 | CRED | 0 dans ce cas | 3.00 |
>= 1.0 | COM | Commission prélevée par la MARQUE BLANCHE | 0.00 |
>= 1.0 | MSG | Commentaire | Commande numéro 245 |
>= 1.0 | STATUS | 3 : transaction effectuée avec succès | 3 |