GetMoneyInTransDetails: Retrieve Payment Details

Version

Description

1.1

Input: transactionMerchantToken has been added. It's the wkToken variable used in the entry of MoneyInWebInit

1.2

Output: new value for STATUS

1.3

Output: new EXTRA value with more card data information

1.4

Output: new INT_MSG value with error codes and messages from Lemonway

1.5

Output: authorization number added to existing EXTRA values

1.6

Output: MLABEL with IBAN when Money-in by iDEAL or SDD

1.8

Output: more card info added

2.2Output: Adding field INT_STATUS instead of STATUS
From 28/07/2020Output: Adding status "Cancelled" in field INT_STATUS
From 01/04/2021Output: Adding field "ThreeDs", which has two outputs associated with 3-D Secure v2. These outputs are: threeDSModeRequested and threeDSResult.

How does it work?

Retrieves the details of a Payment that has previously been initiated.

  • card (Citelis, Atos, Payxpert)
  • iDeal
  • Fund transfer
  • SDD


Request


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> <!-- since 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

Item

Description

Mandatory

Format

Example

>= 1.0

transactionId

Money-in ID

No

int

255

>= 1.0

transactionComment

Money-in Comment

No

[0 :140] char

Order number 245776

>= 1.1

transactionMerchantToken

Token from wkToken variable, used in entry of MoneyInWebInit (v 1.0)

No

[0 : 50] char

312232

>= 1.0

startDate

Date in UTC seconds, in order to return transactions initialized after startDate

No

[0 :10] int

1373448225

>= 1.0

endDate

Date in UTC seconds, in order to return transactions initialized before startDate

No

[0 :10] int

1373448225

Note

You have to fill in at least one parameter

Answer


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>
		<THREEDS> <!--FROM 01/04/21 -->																					<THREEDSMODEREQUESTED>string</THREEDSMODEREQUESTED>
			<THREEDSRESULT>string</THREEDSRESULT>
		<EXTRA> <!--since version 1.3 -->
			<IS3DS>string</IS3DS>
			<CTRY>string</CTRY>
			<AUTH>string</AUTH> <!--since version 1.5 -->
			<NUM>string</NUM> <!--since version 1.8 -->
			<EXP> string </EXP><!--since version 1.8 -->
			<TYP> string </TYP><!--since version 1.8 -->
		</EXTRA>
		<INT_MSG>string</INT_MSG>
		<MLABEL>string</MLABEL><!--since version 1.6 -->
		<SCHEDULED_DATE>string</SCHEDULED_DATE>
	</HPAY>
	...
	<HPAY>
		...
	</HPAY>
</TRANS>

JSON

{
    "transactions": {
        "value": [
            {
                "receiverAccountId": "5d476b08-9961-43b5-a206-e6a195e2ea29",
                "creditAmount": 1400,
                "scheduledNumber": null,
                "maskedLabel": "",
                "card": {
                    "id": 0,
                    "is3DS": false,
                    "expiration": "2025/01",
                    "type": "VISA"
                },
                "refundAmount": 0.0,
                "bankReference": null,
                "ChequeSendingAddress_CorporateName": null,
                "ChequeSendingAddress_Street": null,
                "ChequeSendingAddress_City": null,
                "ChequeSendingAddress_PostCode": null,
                "threeDS": {
                    "threeDSModeRequested": "NO_PREFERENCE",
                    "threeDSResult": "CHALLENGE"
                },
                "id": 480782,
                "method": 0,
                "date": 1617037555,
                "commissionAmount": 100,
                "comment": "Order number 2457765AX2",
                "status": 0,
                "executionDate": 1617037649,
                "lemonWayCommission": {
                    "idp2p": "322676",
                    "amount": 57
                },
                "reference": "66239bc6-3ecc-42de-9e07-983d1201ce66"
            }
        ]
    }
}

Version

Item

Description

Example

>= 1.0

HPAY

Money-in


>= 1.0

SCHEDULED_DATE

If it's a money-in by SDD, and if you gave a collection date

2015/12/31

>= 1.0

ID

Money-in ID

255

>= 1.0

DATE

Money-in Date

10/09/2011 18:09:27

>= 1.0

SEN

Empty in this case


>= 1.0

REC

The wallet that did the Money-in

pizza

>= 1.0

DEB

0 in this case

0.00

>= 1.0

CRED

Amount to credit to the wallet (total less fee)

15.00

>= 1.0

COM

  • Partner commission in case autoCom = 0
  • or Lemonway commission if the autoCom was = 1

2.00

>= 1.0

MSG

Comment
(For Bank Transfers, comment includes the customer name when banks provide it + the comment entered by the customer during wire transfer order. Contact Support to turn on/off "Debtor Name" & "Comment" parsing). 

Order number 245776

>= 1.0

STATUS (deprecated, use INT_STATUS instead)

3: money-in successful
4: error
0: waiting for finalization (since version 1.2)
16: Reservation made successfully, awaiting validation. (Only with differed payments)

3

>= 1.3

EXTRA

Optional card info


>= 1.3

EXTRA.IS3DS

3DS authentication:

  • 0 if No
  • 1 if Yes

1

>= 1.3

EXTRA.CTRY

The country that emitted the card

FRA

>= 1.4

INT_MSG

Error codes from our partners and messages from Lemonway
Codes are at the end of this document

05-00-05 ERR_PSP_REFUSED

>= 1.5

EXTRA.AUTH

Authorization number

455622

>= 1.6

MLABEL

IBAN when money-in by iDEAL or SDD


>= 1.8

EXTRA.NUM

Masked card number

4972XXXXXXXXXX03

>= 1.8

EXTRA.EXP

Expiration date if available


>= 1.8

EXTRA.TYP

VISA or MASTERCARD

VISA

>= 2.2INT_STATUS

0: success
4: pending
6: error
7: canceled (by the customer or dropped)
16: wait for validation / finalization

0
01/04/2021THREEDS

threeDSModeRequested (string, optional) 3DS exemption request. Possible values : 

  • NO_PREFERENCE : The issuing Bank can choose to activate or not 3DS v2 

threeDSResult (string, optional) 3DS authentication result. Possible values : 

  • CHALLENGE : 3DS v2 was activated and the payer was asked to be strongly authenticated
  • FRICTIONLESS : 3DS v2 was not activated
  • NONE : we could not get the result of SCA