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

How does it work?

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

  1. After initiating a Direct Payment using MoneyIn3DInit you redirected the end-user to the 3D Secure Authentication Page
  2. You need to then call MoneyIn3DAuthenticate to check the Authentication Status
  3. You should then call MoneyIn3DConfirm specifying the return Transaction ID to finalize the payment, and for the card to be debited.


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

Request

Item

Description

Mandatory

Format

Example

transactionId

Transaction ID to finalize

Yes

int

255

MD

"MD" Date returned by 3D Secure authentication web site

Yes if Payline or Payxpertcontract

String

1Ok9dCP55UUkWfdJwEid

PaRes

"PaRes" data returned by 3D Secure authentication web site

Yes if Payline or Payxpertcontract

string

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

cardType

Card type

Yes if Payline or Payxpertcontract

[1] char

0: CB
1: Visa
2: Mastercard

cardNumber

Card number

Yes if Payline or Payxpertcontract

[13 :19] char

4972000011112222

cardCode

CVV Code at the back of the card

Yes if Payline or Payxpertcontract

[3] char

123

cardDate

Card expiration date

Yes if Payline or Payxpertcontract

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

registerCardSave card and returns an ID for future recurring payments. You will then be able to debit the card by calling MoneyInWithCardId.No[0:1] char

1 = True

0 = False

Answer

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