GetMoneyInTransDetails : Rechercher un money-in
Version | Description |
|---|---|
1.1 | Entrée : un paramètre de recherche supplémentaire a été ajouté : transactionMerchantToken, qui correspond au wkToken utilisé en entrée de MoneyInWebInit |
1.2 | Sortie : la donnée STATUS possède une valeur possible supplémentaire |
1.3 | Sortie supplémentaire : balise EXTRA contenant des informations complémentaires sur la carte utilisée |
1.4 | Sortie supplémentaire : balise INT_MSG contenant des codes d'erreurs ou messages de Lemonway |
1.5 | Ajout du numéro d'autorisation AUTH dans la balise EXTRA |
1.6 | Ajout de la balise MLABEL pour afficher IBAN quand money-in par iDeal ou prélèvement |
1.8 | Ajout de plus d'informations carte en sortie |
| 2.1 | Sortie supplémentaire : montant remboursé |
| 2.2 | Remplacement du champs STATUS par INT_STATUS |
| à partir du 23/07/2020 | Ajout du statut "Annulé" comme résultat du champs INT_STATUS |
Cinématique
Avec la méthode « GetMoneyInTransDetails», la MARQUE BLANCHE peut vérifier le statut et les détails d'un money-in effectué par :
- Carte (Citelis, Atos, Payxpert)
- iDeal
- Virement
- Prélèvement
Requête
XML
<GetMoneyInTransDetails xmlns="Service_mb">
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<transactionId>string</transactionId>
<transactionComment>string</transactionComment>
<transactionMerchantToken>string</transactionMerchantToken> <!-- à partir de la version 1.1 -->
<startDate>string</startDate>
<endDate>string</endDate>
</GetMoneyInTransDetails>
JSON
{
"wlLogin":"string",
"wlPass":"string",
"language":"string",
"version":"string",
"walletIp":"string",
"walletUa":"string",
"transactionId":"string",
"transactionComment":"string",
"transactionMerchantToken":"string",
"startDate":"string",
"endDate":"string"
}
Version | Element | Description | Requis | Format | Exemple |
|---|---|---|---|---|---|
>= 1.0 | transactionId | Identifiant du money-in | Non | int | 255 |
>= 1.0 | transactionComment | Commentaire associé au money-in | Non | [0 :140] car | « Commande numéro 245 » |
>= 1.1 | transactionMerchantToken | Token correspondant au paramètre wkToken en entrée de la méthode MoneyInWebInit | Non | [0 : 50] car | 312232 |
>= 1.0 | startDate | Date en secondes UTC, pour retourner les transactions dont l'initialisation a eu lieu après startDate | Non | [0 :10] int | 1373448225 |
>= 1.0 | endDate | Date en secondes UTC, pour retourner les transactions dont l'initialisation a eu lieu avant endDate | Non | [0 :10] int | 1373448225 |
Remarque
Vous devez renseigner au moins un paramètre !
Réponse
XML
<?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
<EXTRA> <!--à partir de la version 1.3 -->
<IS3DS>string</IS3DS>
<CTRY>string</CTRY>
<AUTH>string</AUTH> <!--à partir de la version 1.5 -->
<NUM>string</NUM> <!--à partir de la version 1.8 -->
<EXP> string </EXP><!--à partir de la version 1.8 -->
<TYP> string </TYP><!--à partir de la version 1.8 -->
</EXTRA>
<INT_MSG>string</INT_MSG>
<MLABEL>string</MLABEL><!--à partir de la version 1.6 -->
<SCHEDULED_DATE>string</SCHEDULED_DATE>
<REFUND>string<REFUND><!--à partir de la version 2.1 -->
</HPAY>
...
<HPAY>
...
</HPAY>
</TRANS>
JSON
{
"TRANS":{
"HPAY":[
{
"ID":"string",
"DATE":" string ",
"SEN":" string ",
"REC":" string ",
"DEB":" string ",
"CRED":" string ",
"COM":" string ",
"MSG":" string ",
"STATUS":" string",
"EXTRA":{
"IS3DS":"string",
"CTRY":"string",
"AUTH":"string",
"NUM":"string",
"EXP":" string ",
"TYP":" string "
},
"INT_MSG":"string",
"MLABEL":"string",
"SCHEDULED_DATE":"string"
"REFUND":"string" <!--à partir de la version 2.1 -->
},
...
]
}
}
Version | Element | Description | Exemple |
|---|---|---|---|
>= 1.0 | HPAY | Correspond à un money-in | |
>= 1.0 | ID | Identifiant du money-in | 255 |
>= 1.0 | DATE | Date du money-in | 10/09/2011 18:09:27 |
>= 1.0 | SEN | Vide dans ce cas | |
>= 1.0 | REC | Wallet ayant effectué le money-in | pizza |
>= 1.0 | DEB | 0 dans ce cas | 0.00 |
>= 1.0 | CRED | Montant à créditer au wallet (total moins la commission) | 15.00 |
>= 1.0 | COM | Commission prélevée par la MARQUE BLANCHE | 2.00 |
>= 1.0 | MSG | Commentaire | Commande numéro 245 |
>= 1.0 | STATUS | 3 : money-in effectué avec succès | 3 |
| >= 2.2 | INT_STATUS | 0: succès | 0 |
>= 1.3 | EXTRA | Balise optionnelle contenant des informations carte | |
>= 1.3 | EXTRA.IS3DS | Indique si la transaction a été authentifiée avec 3D Secure :
| 1 |
>= 1.3 | EXTRA.CTRY | Code pays du pays d'émission de la carte | FRA |
>= 1.5 | EXTRA.AUTH | Numéro d'autorisation | 455622 |
>= 1.8 | EXTRA.NUM | Numéro masqué de la carte bancaire | 4972XXXXXXXXXX03 |
>= 1.8 | EXTRA.EXP | Date d'expiration si disponible | |
>= 1.8 | EXTRA.TYP | VISA ou MASTERCARD | VISA |
>= 1.4 | INT_MSG | Codes d'erreur ou messages provenant de Lemonway | 05-00-05 |
>= 1.6 | MLABEL | IBAN quand money-in par iDEAL ou prélèvement | |
>= 1.0 | SCHEDULED_DATE | Pour un money-in par prélèvement, si vous avez renseigné une date de prélèvement | 2015/12/31 |
| >= 2.1 | REFUND | Montant remboursé | 15.00 |