MoneyIn3DConfirm: Finalize a Direct Payment (PCI-DSS compliant only)

Version

Description

1.0


1.1

Output: new EXTRA data added with card and payment information

Why not upgrade your viewing experience! An updated version of this article is on our new documentation portal 👉 here

How does it work?

This method finalizes the credit of a wallet by card after 3D Secure authentication of the client

  1. By calling MoneyIn3DInit, you receive an Authentication URL and a Transaction Id. If you want to register a card for future payments set registerCard=1.

  2. With the Authentication URL, you are able to redirect the end-user to the ACS (Bank Authentication Server) Page

  3. After 3D Secure Authentication, you will be called back on the ReturnURL

  4. If the authentication was done then, you then need to call MoneyIn3DConfirm specifying the returned Transaction Id to finalize the payment.

For Subscriptions with equal recurring amounts: for the initial subscription payment, use the MoneyIn3DInit and then MoneyIn3DAuthenticate and MoneyIn3DConfirm. Ensure that you set: registerCard=1. Use MoneyInWithCardID for all subsequent payments.

Request

XML

<MoneyIn3DConfirm xmlns="Service_mb">

  <wlLogin>string</wlLogin>

  <wlPass>string</wlPass>

  <language>string</language>

  <version>string</version>

  <walletIp>string</walletIp>

  <walletUa>string</walletUa>

  <transactionId>string</transactionId>

  <MD>string</MD>

  <PaRes>string</PaRes>

  <cardType>string</cardType>

  <cardNumber>string</cardNumber>

  <cardCode>string</cardCode>

  <cardDate>string</cardDate>

  <isPreAuth>string</isPreAuth>

  <specialConfig>string</specialConfig>

  <delayedDays>string</delayedDays>

</MoneyIn3DConfirm>

JSON

{   
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "transactionId":"string",
    "MD":"string",
    "PaRes":"string",
    "cardType":"string",
    "cardNumber":"string",
    "cardCode":"string",
    "cardDate":"string",
    "isPreAuth":"string",
    "specialConfig":"string",
    "delayedDays":"string"
}

Item

Description

Mandatory

Format

Example

transactionId

Transaction ID to finalize

Yes

int

255

MD

"MD" Date returned by 3D Secure authentication website

Yes if Payxpert contract

string

1Ok9dCP55UUkWfdJwEid

PaRes

"PaRes" data returned by 3D Secure authentication website

Yes if Payxpert contract

string

eJxVkdtSwjAQhl+l wwM0SY+EWTKDgsKM ICIgXGbaVaq0hbS1 8PYmpYheZb89Zfd fWO4U4vAVo0qhg CkWhfxAK4n7nYDz0 HNZR8B8sMCjgG9UR ZJngtnUdoBcURep aCezUoCMjneTmfB4 GAYhkBYhRTUZChZQ 1nV9j/

cardType

Card type

Yes if Payxpert contract

[1] char

0: CB
1: Visa
2: Mastercard

cardNumber

Card number

Yes if Payxpert contract

[13 :19] char

4972000011112222

cardCode

CVV Code at the back of the card

Yes if Payxpert contract

[3] char

123

cardDate

Card expiration date

Yes if Payxpert contract

MM/yyyy

12/2013

isPreAuth

Atos only: Indicates if the request is for a pre-authorization only.

  • If empty: the default behavior is no pre-authorization (unless you requested the contrary)
  • If = 1: payment will only be pre-authorized, you will have to call MoneyInValidate within 6 days in order to request the card debit.
  • If other value: the card will be debited

No

[0:1] char

0

specialConfig

Leave empty

No

[0 :max] char


delayedDays

Atos only: if isPreAuth was not set to 1, this will be ignored.
Please use with caution, if delayedDays > 6, it will be forced to 6 because it is not possible to delay this 3D Secure payment for more than 6 days.

No

Between 1 and 6

3

Answer

XML

<?xml version="1.0" encoding="utf-8"?>
<MONEYIN3DCONFIRM>
	<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>
</MONEYIN3DCONFIRM> 

JSON

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

Transaction ID

255

1.0

MLABEL

Non used


1.0

DATE

Request Date

10/09/2011 18:09:27

1.0

SEN

Non used in this case


1.0

REC

Wallet to credit

Pizza56

1.0

DEB

0.00 in this case

0.00

1.0

CRED

Amount to credit to the wallet (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

Contains extra data


>= 1.1

EXTRA.IS3DS

Indicates if the operation is 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