MoneyIn3DConfirm
How it works
This method finalizes the credit of a wallet by card after 3D Secure authentication of the client
- By calling Initiate a Direct Payment (PCI-DSS compliant only), you receive an Authentication URL and a Transaction Id. If you want to register a card for future payments set registerCard=1.
- With the Authentication URL, you are able to redirect the end-user to the ACS (Bank Authentication Server) Page
- After 3D Secure Authentication, you will be called back on the ReturnURL
- If the authentication was done then, you then need to call Finalize a Direct Payment (PCI-DSS compliant only) specifying the returned Transaction Id to finalize the payment.
For Subscriptions with equal recurring amounts: for the initial subscription payment, use Initiate a Direct Payment (PCI-DSS compliant only) and then MoneyIn3DAuthenticate and MoneyIn3DConfirm. Ensure that you set: registerCard=1. Use Charge a Registered Card for all subsequent payments.
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>
<cardId>char</cardId>
<cardType>string</cardType>
<cardNumber>string</cardNumber>
<cardCode>string</cardCode>
<cardDate>string</cardDate>
<isPreAuth>string</isPreAuth>
<specialConfig>string</specialConfig>
<delayedDays>string</delayedDays>
</MoneyIn3DConfirm>
<?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
{
"wlLogin":"string",
"wlPass":"string",
"language":"string",
"version":"string",
"walletIp":"string",
"walletUa":"string",
"transactionId":"string",
"MD":"string",
"PaRes":"string",
"cardId":"char",
"cardType":"string",
"cardNumber":"string",
"cardCode":"string",
"cardDate":"string",
"isPreAuth":"string",
"specialConfig":"string",
"delayedDays":"string"
}
{
"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"
}
}
}
}
Request Input Description
Item | Description | Mandatory | Format | Example |
---|---|---|---|---|
transactionId | Transaction ID to finalize | No | int | 255 |
MD | "MD" Date returned by 3D Secure authentication website | No | string | 1Ok9dCP55UUkWfdJwEid |
PaRes | "PaRes" data returned by the 3D Secure authentication website | No | string | eJxVkdtSwjAQhl+l wwM0SY+EWTKDgsKM ICIgXGbaVaq0hbS1 8PYmpYheZb89Zfd fWO4U4vAVo0qhg CkWhfxAK4n7nYDz0 HNZR8B8sMCjgG9UR ZJngtnUdoBcURep aCezUoCMjneTmfB4 GAYhkBYhRTUZChZQ 1nV9j/ |
cardId | Associated with a transaction on a registered card | No | char | 1Ok9dCP55UUkWfdJwEid |
cardType | Card type | No | [1] char | 0: CB |
1: Visa | ||||
2: Mastercard | ||||
cardNumber | Card number | No | [13:19] char | 4.972E+15 |
cardCode | CVV: Code at the back of the card | No | [3] char | 123 |
cardDate | Card expiration date | No | MM/yyyy | Dec-13 |
isPreAuth | Atos only: Indicates if the request is for a pre-authorization only. | No | [0:1] char | 0 |
If empty: the default behaviour 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 | ||||
specialConfig | Leave empty | No | [0:max] char | |
delayedDays | Atos only: if isPreAuth was not set to 1, this will be ignored. | No | Between 1 and 6 | 3 |
Indicates the number of days of the deferred payment. Between 0 and 6 days to have guaranteed payment. | ||||
registerCard | Register the card used for the current payment. A cardId will be returned for you to make future payments and set up recurring payments. You will then be able to debit the card by calling MoneyInWithCardId. | No | [0:1] boolean | 1 = True |
0 = False |
Response Output Description
Version | Item | Description | Example |
---|---|---|---|
1 | ID | Transaction ID | 255 |
1 | MLABEL | Non used | |
1 | DATE | Request Date | 10/9/2011 18:09 |
1 | SEN | Non used in this case | |
1 | REC | Wallet to credit | Pizza56 |
1 | DEB | 0.00 in this case | 0 |
1 | CRED | Amount to credit to the wallet (total less fee) | 15 |
1 | COM | Your fee | 2 |
1 | MSG | Comment | Order number 2457765AX2 |
1 | STATUS | 3 if a successful payment | 3 |
16 if successful pre-authorized payment | |||
>= 1.1 | EXTRA | Contains extra data | |
>= 1.1 | EXTRA.IS3DS | Indicates if the operation is 3D Secure: | 1 |
-0 if no -1 if yes | |||
>= 1.1 | EXTRA.CTRY | Country code of the card | FRA |
>= 1.1 | EXTRA.AUTH | Authorization number | 43245 |