MoneyInWithCardId: credit of a payment account with a tokenized card

Version

Description

1.0

1.1

Output: new EXTRA data added with card and payment information

How it works

Use MoneyInWithCardId to ask to credit a wallet with a card linked to the wallet :

  1. Your WHITE BRAND application sends the payment account ID to credit, the card ID, and the amount to credit, and a Comment explaining the rebill

    Why this card is rebilled : is it a monthly payment for a service, which service, which website, which command, with which Email. Please make sure you add all information regarding the Rebill on this comment field. We may ask you to add more information on this field to answer complains directly coming to our Customer Service from your customers, or from banks, or from the police, or from Visa/Mastercard, or from the regulator.
  2. Lemon Way answers

Request

<MoneyInWithCardId xmlns="Service_mb">

  <wlLogin>string</wlLogin>

  <wlPass>string</wlPass>

  <language>string</language>

  <version>string</version>

  <walletIp>string</walletIp>

  <walletUa>string</walletUa>

  <wallet>string</wallet>

  <cardId>string</cardId>

  <amountTot>string</amount>

  <amountCom>string</amountCom>

  <comment>string</comment>

  <autoCommission>string</autoCommission>

  <isPreAuth>string</isPreAuth>

  <specialConfig>string</specialConfig>

  <delayedDays>string</delayedDays>

</MoneyInWithCardId>

  
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "wallet":"string",
    "cardId":"string",
    "amountTot":"string",
    "amountCom":"string",
    "comment":"string",
    "autoCommission":"string",
    "isPreAuth":"string",
    "specialConfig":"string",
    "delayedDays":"string"
}

Item

Description

Mandatory

Format

Example

wallet

Payment account ID to credit

Yes

[0 : 256] char

33612345678 ou taxi67

cardId

ID of the card associated with the payment account

Yes

[0 : 256] char

243

amountTot

Amount to pay on the card

Yes

2 decimals

15.00

amountCom

Your WHITE BRAND fee for this payment

No

2 decimals

1.00

comment

Comment:

Please explain the exact situation for this rebill: URL of the website, order number, customer number and Email, name of the service.

No

[0 :140] char

PO 24577 toto@free.fr lemonway.Fr Monthly 03/2014

autoCommission

This should be set to No (0) for most WHITE BRAND.
If yes:

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

Yes

[1] char

0: No (by default)
1: Yes

isPreAuth

Except Payxpert: Indicates if the request is delayed and will require validation.

  • If = 1: payment will only be pre-authorized, you will have to call MoneyInValidate within 6 days or [delayedDays] in order to request the card debit.
  • If empty: the default behavior is no delay and no validation necessary (unless stated otherwise in your contract)
  • If other value: the card will be debited without delay and without validation necessary

No

[0:1] char

0

delayedDays

Except Payxpert: if isPreAuth was not set to 1, this will be ignored.
Please use with caution, if delayedDays > 6, it is possible that the payment will be denied when you try to validate it, because a new authorization will be made.

No

Between 1 and 99

30

specialConfig

Leave empty

No

[0 :max] char

Answer

<?xml version="1.0" encoding="utf-8"?>
<TRANS>
	<HPAY>
		<ID>string</ID>
		<MLABEL>string</MLABEL>
		<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> <!--since version 1.1 -->
			<IS3DS>string</IS3DS>
			<CTRY>string</CTRY>
			<AUTH>string</AUTH>
		</EXTRA>
	</HPAY>
</TRANS> 
{  
    "TRANS":{  
        "HPAY":{  
            "ID":"string",
            "MLABEL":"string",
            "DATE":" string ",
            "SEN":" string ",
            "REC":" string ",
            "DEB":" string ",
            "CRED":" string ",
            "COM":" string ",
            "MSG":" string ",
            "STATUS":" string",
            "EXTRA":{  
                "IS3DS":"string",
                "CTRY":"string",
                "AUTH":"string"
            }
        }
    }
}

Version

Item

Description

Example

1.0

ID

Request ID

255

1.0

MLABEL

Masked Card Number

XXXX XXXX XXXX 9854

1.0

DATE

Request Date

10/09/2011 18:09:27

1.0

SEN

Empty in this case

1.0

REC

Beneficiary payment account

Pizza56

1.0

DEB

0.00 in this case

0.00

1.0

CRED

Amount to credit to the payment account (total less fee)

15.00

1.0

COM

WHITE BRAND fee

2.00

1.0

MSG

Comment

Order number 2457765AX2

1.0

STATUS

3 if successful payment
16 if successful pre-authorized payment

3

>= 1.1

EXTRA

Extra data

>= 1.1

EXTRA.IS3DS

Indicates if the operation was 3D Secure:

  • 0 if no
  • 1 if yes

1

>= 1.1

EXTRA.CTRY

Country code of the card

FRA

>= 1.1

EXTRA.AUTH

Authorization number

43245