MoneyInWithCardId: Charge a Registered Card

Version

Description

1.0


1.1

Output: new extra data added with card and payment information

How does it work?

This method can be used for Subscriptions or Payments Upon Delivery.

For Partners using the Web PSP Payment Mode: 

  • For Subscriptions with equal recurring amounts: for the initial subscription payment, use MoneyInWebInit and ensure that you set: registerCard =1, then use MoneyInWithCardID for all subsequent equal amounts payments. 
  • For Payments Upon Delivery: use MoneyInWebInit to pre-authorize the amount you will charge upon delivery. Ensure that you set the delayedDays field between 1 to 6 days. Depending on if you want to guarantee the payment or not, use MoneyInValidate or MoneyInWithCardID to capture the funds (details on the Card Payment Guide)

For PCI-DSS Partners using Direct Payment Mode (no PSP page):

For more information see, By Card


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 complaints directly coming to our Customer Service from your customers, or from banks, or from the police, or from Visa/Mastercard, or from the regulator.


Request


XML

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

JSON

{   
    "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 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.com Monthly 03/2014

autoCommission

This should be set to No (0).
If  set to Yes:

  • [amountCom] will be ignored and will be replaced with Lemonway's fee
  • You will not receive any fee

Yes

[1] char

0: No (by default)
1: Yes

isPreAuth

Except for 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 for 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

<?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> 
 

JSON

{  
    "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

Your fee

2.00

1.0

MSG

Comment

Order number 2457765AX2

1.0

STATUS

3 if a 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