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

Version

Description

1.0


1.1

Atos version (to use after December 2013)

How does it work?

  1. By calling MoneyIn3DInit, you  receive a 3D Secure Authentication URL and a Transaction Id
  2. With this URL, you are able to redirect the end-user to the 3D Secure Authentication Page
  3. After 3D Secure Authentication, with the callback ReturnURL specified as input
  4. They need to call Authenticate 

You then need  to call MoneyIn3DConfirm specifying the returned Transaction Id to finalize the payment and ask for the debit of the card.

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 Payline or Payxpert contract.
Method to use to transmit information to the 3DS authentication platform using GET or POST

POST

ACS>pareqFieldName

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

PaReq

ACS>pareqFieldValue

Only if Payline or Payxpert contract.
Pareq data to send

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

ACS> termurlFieldName

Only if Payline or Payxpert contract.
Field name to use to transmit your return URL

TermUrl

ACS>mdFieldName

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

MD

ACS>mdFieldValue

Only if Payline or 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 web site:

  • 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);
    ?>