MoneyIn3DInit: Initiate a Direct Payment (PCI-DSS compliant only)

Version

Description

1.0


1.1

Atos version (to use after December 2013)


Want a better viewing experience on a modern and easy to navigate site? Have a look at the same article on our new documentation portal 👉 here

How does it work?

Payment with a New Card

  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 TransactionId to finalize the payment.

Payment with a Registered Card

  1. Ensure you have a cardId then call MoneyIn3DInit specifying the cardID parameter (card number, date, type, card code). If you want to improve the transaction success rate add the CVV code in the parameters.
  2. Refer to steps 2, 3 and  4  stated above.

Important: To ensure that the client’s card has been registered, call the following method before you initiative payments on a registered card: GetCard 

Note: This id is displayed when you finalized your first payment with the registered card using MoneyIn3DConfirm or MoneyInWebInit

Note: If you receive an error message during the verification process, refer to DirectKit Errors.

Subscription Payments

A prerequisite to setting up a subscription is that you have previously made a payment with a card and registered the card using MoneyIn3DInit.

Note: Initial transaction for a subscription can be for a predetermined or an undetermined length of time.

After you have registered a card refer to: MoneyInWithCardId to begin setting up a subscription or payment by delivery system.

Important: To ensure the likelyhood of frictionless payments you must setup payments of equal recurring amounts.

Request

Item

Description

Mandatory

Format

Example

wallet

Wallet ID to credit

Yes

[0 : 256] char

33612345678 ou taxi67

amountTot

Amount to debit from card

Yes

2 decimals

15.00

amountCom

Fee amount for you

No

2 decimals

1.00

comment

Comment

No

[0 :140] char

Order number 2457765AX2

wkToken

Unique ID of the call, generated by your server. This ID can be used as a search field when looking for operation details

No

[0 : 50] char

5652772

cardType

Card type

Yes

[1] char

0: CB
1: Visa
2: Mastercard

cardNumber

Card number

Yes

[13 :19] char

4972000011112222

cardCode

CVV Code at the back of the card

Yes

[3] char

123

cardDate

Card expiration date

Yes

MM/yyyy

12/2013

autoCommission

This should be set to No (0).
If 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

returnUrl

URL of return of the 3D Secure website. Your client will be redirected on this URL, which should be your website URL.

Yes if Atos contract


https://www.mysite.com/payment/?id=356

specialConfig

Leave empty

No

[0 :max] char


Answer

The answer contains data to pass thru the 3D Secure authentication gateway.

Item

Description

Example

ACS

Encapsulate data sent by the system that emits the card


ACS>actionUrl

Redirect URL for the CLIENT on the 3D Secure web site

https%3a%2f%2facs.modirum.com%2fmdpayacs%2fpareq

ACS>actionMethod

Only if Payxpert contract.
Method to use to transmit information to the 3DS authentication platform using GET or POST

POST

ACS>pareqFieldName

Only if  Payxpert contract.
Name of the field to use to transmit "pareq" data

PaReq

ACS>pareqFieldValue

Only if Payxpert contract.
Pareq data to send

eJxVkdtSwjAQhl+F4QGapPTILJlBYZQZW7XCoNxl2tVWe4C0tfD2JqWIXmW/PWX3X1inEnHxgnErkUOAdS0+cJQls7FLKaMeG3N4mkd44PCNss6qkjODGiaQC6oiGaeibDiI+HCzCrnlu67jAhkQCpSrBWcOZd7EtphNXZ/6QM5uKEWB/

ACS> termurlFieldName

Only if Payxpert contract.
The field name to use to transmit your return URL

TermUrl

ACS>mdFieldName

Only if Payxpert contract.
Name of the field to transmit the "md" variable

MD

ACS>mdFieldValue

Only if Payxpert contract.
"md" variable to transmit

18V64ziCeuvLFKPdne7G

ACS>mpiResult

Not used anymore


TRANS>HPAY

Encapsulate a summary of the initialized transaction


TRANS>HPAY>ID

Transaction ID, to save to  at confirmation step

677

TRANS>HPAY>MLABEL

Non used for your brand


TRANS>HPAY>DATE

Init date


TRANS>HPAY>SEN

Non used


TRANS>HPAY>REC

Wallet to credit

Pizza56

TRANS>HPAY>DEB

0.00 in this case

0.00

TRANS>HPAY>CRED

Amount to credit to the wallet(total less fee)

15.00

TRANS>HPAY>COM

Your fee

2.00

TRANS>HPAY>MSG

Comment

Order number 2457765AX2

TRANS>HPAY>STATUS

Non used in your KIT

0


Example of form to use to redirect the Client on the authentication website:

  • Payline or Payxpert:

    '<form action="https://acs.modirum.com/mdpayacs/pareq" method="post">
<input type="text" name="'.$pareqFieldName .'" value="'.$pareqFieldValue.'">
<input type="text" name="'.$termurlFieldName.'" value="'.$myReturnUrl.'">
<input type="text" name="'.$mdFieldName.'" value="'.$mdFieldValue.'">
<input type="submit" name="submit" class="submit" value="Go to 3DS"></form>'

  • Atos (simple redirection to actionUrl):

    <?php
/*
$actionUrl : URL to 3DS authentication website
*/
header('Location: '.$actionUrl);
?>

Search