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
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.
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 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 |
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.
| 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. | 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 | 3 |
>= 1.1 | EXTRA | Contains extra data | |
>= 1.1 | EXTRA.IS3DS | Indicates if the operation is 3D Secure: | 1 |
>= 1.1 | EXTRA.CTRY | Country code of the card | FRA |
>= 1.1 | EXTRA.AUTH | Authorization number | 43245 |