Dalenys Hosted Forms - Stored card payment to multiple recipients

Resources

CardPayment

PropertyTypeMandatoryDescription

Amount
Long
O
Payment amount (in cents)

Fee
Long
N
Fee amount (the amount value does not include the fee amount)

ThreeDSecurePreference
Int
O
0 = ask for a
strong authentication
1 = ask for a
frictionless authentication
2 = ask for no preference,
the decision will be made by issuer;
3 = ask for no
authentication

OrderId
String
O
Payment identifier in the third-party application

Id
Long
/
Payment ID

availableCards
String
O
List of cards to be displayed on the payment page.
Possible values ( to separate with ’ ;’ ) :
CB
MASTERCARD
MAESTRO
VISA
VISA_ELECTRON

IsMine
Bool
O
True, if the account holder is also the bank card holder (it refers to
an account top-up and not a payment), False if the bank card holder is not
the owner of the account holder

Message
String
O
Payment message

urlReturn
String
O
Url of callback client requested at the end of a card payment

urlCallback
String
O
Specify url of callback server requested at the end of adding card
(the domain must be the same as the one of the callback URL provided
initially)

Status
Int
O
Operation status
-1 = unknow
0 = waiting
1 = completed
2 = refunded
3 = refused
4 = Waiting for validation
5 = Cancelled
6 = Waiting to be sent

ErrorCode
Int
O
0 = 0XXX
operation succeeded or still processing
10 = 1XXX
operation rejected because of bad request configuration
11 = 2XXX
operation rejected because of bad reference usage
12 = 3XXX operation
rejected because of bad account configuration
13 = 4XXX
operation rejected because of the bank or the supplier
14 = 5XXX
operation rejected because of a system error
15 = 6XXX
operation rejected because of anti-fraud engine

Href
String
O
The "href" parameter includes the url, to which the
third-party application should redirect the client’s browser to complete a
card payment .

PaymentDate
DateTime


Payment date
Ex : 2013-09-10
T15:49:58 .791121+02:00

Type
Int
/
Payment types:
0 = Payment
1 = Refund

Payments

PropertyTypeMandatoryDescription

OrderId
Long
/
SubPayment identifier in the third-party application

Id
Long
/
Sub Operation OrderId

Amount
Long
O
SubPayment amount (in cents)

Fee
Long
N
Subpayment fee amount (the amount value does not include the fee
amount)

Message
String
N
Subpayment message

Status
Int
O
Sub operation status
-1 = unknow
0 = waiting
1 = completed
2 = refunded
3 = refused
4 = Waiting for validation
5 = Cancelled
6 = Waiting to be sent

Card

PropertyTypeMandatoryDescription

AppCardId
String
O
Card identifier in the third-party application

Href
Uri
/
Uri for the details of the bank card

Beneficiary

PropertyTypeMandatoryDescription

Id
Long
/
Account identifier.

AppAccountId
String
O
Account identifier provided by the third-party application.

DisplayName
Long
/
Account display name

Email
String
/
Account email

Phonenumber
String
/
Account phone number

Href
Uri
/
Uri for the account details

Extraparameters

PropertyTypeMandatoryDescription

ProfilName
String
O
Value “3DSV2” to
call 3D-Secure 2.0
By default,
without profil, 3DS V1 will be called

PayerInfo

PropertyTypeMandatoryDescription

Name
String
O
The holder’s full name (as described on the payment method).

mail
String
O
The user’s email.

Billing

PropertyTypeMandatoryDescription

City
String
O
The billing city.

Country
String
O
The country code (ISO_3166-1_alpha-2).

Address
String
O
The billing address (max length 50). Be careful not to integrate any line breaks.

PostalCode
String
O
The billing postal code.

Billingaddressstate
String
N
The billing address state.

ShipTo

PropertyTypeMandatoryDescription

City
String
O*
The
shipping city.
Mandatory if
AdresseType is not EDELIVERY

Country
String
O*
The country code (ISO_3166-1_alpha-2 format)
Mandatory if
AdresseType is not EDELIVERY

Address
String
O*
The shipping address. (max length 50)
Mandatory if
AdresseType is not EDELIVERY

PostalCode
String
O*
The shipping postal code.
Mandatory if
AdresseType is not EDELIVERY

AddressType
Int
O
Shipping indicator.
0 = eDelivery
1 = Verified
2 = New
3 = Billing
4 = Store Pickup
5 = Travel Pickup
6 = Other
The
parameter DELIVERYEMAIL is
mandatory when EDELIVERY mode
is set. The other ship to address fields are
optional when ‘storepickup’, travelpickup or other is set.

AddressState
String
N
The shipping address state.

AddressDate
String
N
Date when the shipping address used for this transaction was first
used with the 3DS Requestor.

Delivery

PropertyTypeMandatoryDescription

email
String
O*
Mandatory if ShipToAddressType value is eDelivery
For Electronic delivery,
the email address to which the merchandise was delivered.

timeframe
String
N
Possible values : electronic,
sameday, overnight, longer

ClientScreen

PropertyTypeMandatoryDescription

ColorDepth
Int
N
Value representing the bit depth of the colour palette for displaying
images, in bits per pixel. Obtained from Cardholder browser using the
screen.colorDepth property.
Ex : 32

ScreenHeight
Int
N
Total height of the Cardholder’s screen in pixels. Value is returned
from the screen.height property.
Ex : 1280

ScreenWidth
Int
N
Total width of the cardholder’s screen in pixels. Value is returned
from the screen.width property.
Ex : 1024

ThreeDsOptData

PropertyTypeMandatoryDescription

ClientAuthMethod
String
N
guest: No merchant authentication occurred (i.e. cardholder “logged
in” as guest);
credentials: Login to the cardholder account at the merchant system
using merchant’s own credentials;
federated: Login to the cardholder account at the merchant system
using federated ID;
issuer: Login to the cardholder account at the merchant system using
issuer credentials;
thirdparty: Login to the cardholder account at the merchant system
using third-party authentication;
fido: Login to the cardholder account at the merchant system using FIDO
Authenticator;

AccountChangeDate
Date
N
Date that the cardholder’s account with the 3DS Requestor was last
changed, including Billing or Shipping address, new payment account, or new
user(s) added.

AccountCreationDate
Date
N
Date that the cardholder opened the account with the 3DS Requestor.

Passwordchangedate
Date
N
Date that cardholder’s account with the 3DS Requestor had a password
change or account reset.

Last6MonthsPurchaseCount
Int
N
Number of purchases with this cardholder account during the previous
six months.

Last24hoursaddcardattempts
Int
N
Number of “Add Card” attempts in the last 24 hours.

Last24hourstransactioncount
Int
N
Number of transactions (successful and abandoned) for this cardholder
account with the 3DS Requestor across all payment accounts in the previous 24
hours.

Last12Monthstransactioncount
Int
N
Number of transactions (successful and abandoned) for this cardholder
account with the 3DS Requestor across all payment accounts in the previous
year.

Cardenrolldate
date
N
Date that the payment account was enrolled in the cardholder’s account
with the 3DS Requestor.

Suspiciousaccountactivity
Boolean
N
Indicates whether the 3DS Requestor has experienced suspicious
activity (including previous fraud) on the cardholder account.

Homephone
string(max 32)
N
The home phone number provided by the Cardholder in international
(E.164) format.

Mobilephone
string(max 32)
N
The mobile phone number provided by the Cardholder in international
(E.164) format.

Workphone
string(max 32)
N
The work phone number provided by the Cardholder in international
(E.164) format.

Preorderdate
date
N
For a pre-ordered purchase, the expected date that the merchandise
will be available.

Itemavailability
Boolean
N
Indicates whether Cardholder is placing an order for merchandise with
a future availability or release date.

Reorderingitem
Boolean
N
Indicates whether the cardholder is reordering previously purchased
merchandise.

Recurringexpiry
date
N
Date after which no further authorisations shall be performed in a
recurring payment workwlow.

recurringfrequency
Int
N
Indicates the minimum number of days between authorisations.
Ex : 10

GiftCard

PropertyTypeMandatoryDescription

Amount
Int
N
For prepaid or gift card purchase, the purchase amount total of
prepaid or gift card(s) in minor units (cents).

Count
Int
N
For prepaid or gift card purchase, total count of individual prepaid
or gift cards/codes purchased.

Currency
String
N
For prepaid or gift card purchase, the currency code of the card as
defined in ISO 4217.

ExtraResults

PropertyTypeMandatoryDescription

threedsecure
Boolean
/
True / False

threedsecureauthstatus
Int
/
0 = Yes
1 = No
2 = unavaible
3 = Attempted

threedsecuresignaturestatus
Int
/
0 = Yes
1 = No

threedsecureglobalstatus
Int
/
0 = Yes
1 = Not_enrolled
2 = unavaible
3 = Not_required

ThreeDsCardEnrolled
Int
/
0 = Yes
1 = No
2 = unavaible

ExecCode
String
(4)
/
The operation result code

ExecMessage
String
/
The operation result description linked to EXECCODE

warrantyresult
String
/
Yes / no

3dsecureversion
Int
/
The kind of 3-D Secure protocol version.
Ex : 1

3dsecuremode
Int
/
Applied
authentification mode:
0 = ask for a
strong authentication
1 = ask for a
frictionless authentication

bankauthresult
Int
/
Return code of the authorisation request returned by the issuing bank

Create a stored card paiement to multiple recipients with 3DS V2

Create a stored card paiement to multiple recipients without 3DS V2

Note :
Depending on the value of the ThreeDsecurePreference parameter, the mandatory status of 3d secure authentication changes.
For the value ThreeDsecurePreference : 4, 3d Secure authentication will not be asked.
This kind of transactions are only for server to server transactions like subscription, capture…

Retrieve a stored card paiment to multiple recipients