Webservice - doImmediateWalletPaymentRequest

S’abonner

La fonction « doImmediateWalletPayment » réalise un paiement à partir d’un portefeuille virtuel.

Vous pouvez utiliser les modes de paiement comptant CPT et différé DIF avec cette fonction. Payline retourne un code résultat 02308 : mode de paiement non accepté pour les autres modes.

La réponse à votre demande de paiement vous est communiquée en temps réel (synchrone).

Le paiement est refusé dans les cas suivants :

  • L’identifiant du portefeuille virtuel fourni n’existe pas ou le portefeuille est inactif
  • La demande d’autorisation est refusée
  • Le mode de paiement n’est pas accepté

Requête à envoyer


La requête « doImmediateWalletPaymentRequest » doit avoir la structure suivante :

Élément

Description

Requis

Type

Exemple

version

Version des web services Payline

oui

N2

A valoriser avec la dernière version : voir le tableau des versions.

paymentInformations sur le paiementouiObject - payment

Voir les éléments ci-dessous

order

Information sur la commande

ouiObject - orderVoir les éléments ci-dessous

buyer

Information sur l’acheteur

non

Object - buyer

Voir les éléments ci-dessous

walletIdl’identifiant unique du portefeuille virtuel. C’est l’identifiant que vous avez communiqué lors de la demande de création du portefeuille.ouiAN50 
cardIndCe champ est obligatoire si vous utilisez les multiwalletnonN2L’index de la carte, valeur par défaut ‘01’
cvx

Contrôle du CVV ou vCVV (cvv virtuel) lors de la réalisation du paiement

nonN3123

privateDataList

Information sur les informations personnelles

non

Object PrivateDataList

 Voir les éléments ci-dessous

media

Détection du média utilisé lors du paiement.

Les valeurs possibles de cette balise sont :

-       Computer
-       Mobile
-       Tablet
-       TV
-       Console
-       Undefined

non

AN25

Mobile

authentication3DSecure

Information sur les opérations 3DSecure

non

Object - authentication3DSecure

Voir les éléments ci-dessous
subMerchantInformation sur le Payment FacilitatornonsubMerchant objectVoir les éléments ci-dessous

 

Les éléments de référence

Object payment


Field

Description

Prerequisites

Format

Example

Condition

amount

Information passed when calling the doWebPayment function. The value 100 corresponds to 1 €

Yes

N12

100


currency

Currency of payment

Yes

N3

978


action

Action Code

Yes

N3

100

see the table

mode

Payment mode

Yes

AN3

CPT

see the table

contractNumber

Contract number

Yes

AN50

1234567

doWebPayment (defined point of sale), doCapture / doRefund (contractNumber returned by getPaymentDetails / getWebPaymentDetails).

differedActionDate

Date on which payment will be made. 
Format : dd/mm/yy

No

AN8

07/04/2016

If the mode = DIF field, then the DifferedActionDate date is required otherwise this field must be empty.

method

Name of card issuer

No

AN20

CB

version 10 or higher

Ex : CB, PAYSAFECARD

softDescriptor

Information displayed on the account statement of the buyer, limited with certain means of payment. This information will be displayed on the payment ticket. 
Special characters (not A..Z and 1..9) are specific to each acquirer / payment method.

NoAN64www.boutique.frversion 13 or higher
cardBrand

Indicates the mark used for the operation, see the values. 
It is taken into account only if the means of payment allows the choice of the mark.

NoAN15

version 15 or higher

see table


registrationToken

Token used in response in services. 
It allows the partner to return a token to identify a consumer and finds this data when making a payment request.
NoAN

version 18 ou supérieure

RELEASE 4.53


Object order


Field

Description

Mandatory

Type

Example

Condition

ref

Reference of order. This reference must be unique because it is used for control in duplicate request. 
The \ character is forbidden.


AN50

12345678


origin

Origin of the order. If you have subscribed to the Mail Order and Telephone Order option then the values ​​are MO or TO.

No

AN50

SVI_#12


country

Code of the country in which the order was made, see the list.

Yes

AN2

FR


taxes

The amount of taxes on the order in smallest unit of currency. 
An amount of 1 € corresponds to 100

No

N12

100


amount

The amount of order in smallest unit of currency. Usually the same amount as payment.amount. 
An amount of 60 € corresponds to 600

Yes

N12

6000


currency

The ISO code of payment currency:

978: euros 
840: US dollars

cf. complete list in the appendix table "List of currencies"

Yes

N3

978

date

The merchant order date.  Format : dd / mm / yyyy HH24: MI

Yes

AN16

07/04/2016 11:00

details

Information about the ordered items

No

Object OrderDetails



deliveryTime

Delivery time :

1 = express 
2 = standard

No

N

1


deliveryMode

Delivery method :

1: Withdrawal of goods from the merchant 
2: Use of network of points-withdrawal third (type kiala, alveol, etc.) 
3: Withdrawal in airport, station or travel agency 
4: Carrier (La Poste , Colissimo, UPS, DHL ... or any private carrier) 
5: Issuing an electronic ticket, downloads

No

N

4


deliveryChargeAmount of delivery charges in smallest unit of currency, example 250 for 2.50 eurosNoN
version 18 ou supérieure
deliveryExpectedDate

Expected delivery date must be greater than the current date. Format: dd/mm/yyyy

NoAN1807/04/2016Posted to Limonetik
deliveryExpectedDelayExpected delivery time (in days)NoN210Posted to Limonetik

 

Object buyer


Field

Description

Mandatory

Type

Example

Condition
titleTitle of civilityNoAN1


See the table of values

lastName

Name of the buyer

No

AN100



firstName

Buyer's name

No

AN100



email

Buyer's email address

No

AN150


Do not put more than 12 consecutive digits (eg test123456789101@test.test )

shippingAdress

Delivery address.

No

Object Address



billingAddress

Billing address

No

Object Address



accountCreateDate

The date of creation of the buyer's account. Format  : dd/mm/yy 

No

AN10

01/04/16


accountAverageAmount

The average amount of this buyer's purchases

No

N10



accountOrderCount

The number of orders placed by this buyer

No

N10



walletId

The identifier of the virtual wallet of your client.

No

AN50


Mandatory for wallet payment

walletDisplayed

Management of the display of the means of payment of your customer.

To not display the customer payment data, enter the value "none".

To display the customer payment data, the tag must be empty or absent.

No

AN5



walletSecured

Nature of the control added to the payment kinematics WEB.

No

AN12


See the table of values

walletCardInd

Specifies the index of the map to use.

No

AN2

1

The index of the map, default value "1" 

ip

The IP address of the buyer. Format : IPv4 or IPv6 

No

AN50



mobilePhone

The mobile number of the buyer

No

N15

0033691666666



customerId

Customer ID

No

AN50

894492568

Clearsale: This data can be an identifier or an email
legalStatusType of status of the actor: person or companyNoN11Clearsale: see the table of value.
legalDocumentIdentification number of the official documentNoAN100X5446119U
birthDateBirth date. Format: yyyy-mm-dd NoAN10

2016-04-27


fingerprintIDDevice ID fingerprintNoAN50

deviceFingerprintDeviceFingerPrint information.NoAN
from version 15
isBotDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
isIncognitoDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
isBehindProxyDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
isFromTorDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
isEmulatorDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
isRootedDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15
hasTimezoneMismatchDeviceFingerPrint information. Possible value: Y or NNoAN1
from version 15

 

Object privateDataList


Field

Description

Mandatory

Format

Example

privateData

List containing privateData

Number of items 0 to 100

Yes

Object - privateData


 

Object privateData


Field

Description

Mandatory

Format

Example

key

Key name of value

Yes

AN50

user

value

Key value

Yes

AN50

Martin

 

Object authentication3DSecure


Field

Description

Mandatory

Type

Example

Condition

md

Referred to POST by ACS

No

AN20



pares

Referred to POST by ACS

No

AN



xid

Unique transaction identifier

No

AN20



eci

Electronic Commerce Indicator. To pass in the authorization

No

AN2



cavv

Cardholder Authentication Verification Value determined by the ACS.

No

AN28



cavvAlgorithm

Positive integer specifying the algorithm used for CAVV generation. The current possible values ​​are:

0 = HMAC (SET ™ TransStain), 
1 = CVV, 
2 = CVV with ATN, 
3 = AAV MasterCard

W = Cryptogram generated by a Wallet solution

No

N1


W : Wallet UEP

vadsResult

Summary of 3DSecure operations in hexadecimal. This field is no longer used.

No

AN8



typeSecurisationField used as information for authentication.This field is no longer used.NoAN102020 :  VADS
else  9 : VAD
PaResStatus

To use a non-Payline MPI, you must fill in this field.

Values ​​are: 
Y: Successful authentication 
N: Erroneous authentication 
A: Planned passage through ACS 
U: Call to ACS performed 
empty: Time out on ACS

NoAN1

VeResStatus

To use a non-Payline MPI, you must fill in this field.

Values ​​are: Y / N / U or empty

NoAN1


Object subMerchant

Erreur du rendu de la macro 'excerpt-include' : No link could be created for 'subMerchant object'.


Réponse en retour

La réponse a la structure suivante :

Élément

Description

Requis

Format

Exemple

Condition

result

Information sur le résultat de la demande de paiement par wallet :

00000 : Transaction approved
02302 : Transaction invalid
02503 : Wallet does not exist
02505 : Wallet is disabled
02308 : Payment Mode invalid

oui

Object result

Voir les éléments ci-dessous


transaction

Information sur la transaction

oui

transaction object

Voir les éléments ci-dessous


authorization

Information sur l'autorisation

oui

Object - authorization

Voir les éléments ci-dessous


Les éléments de référence

Object result

Erreur du rendu de la macro 'excerpt-include' : No link could be created for 'Object result'.


Object transaction


FieldDescriptionFormatExampleCondition
idUnique identifier of the Payline transactionAN50

dateDate and time of Payline transaction. Format : dd/mm/yyyy HH24:MIAN1701/01/2018 12:00
isDuplicated

This indicator is returned by Payline in the case of a duplicate transaction:

1 = duplicate transaction 
0 = no duplicate detected

AN11
isPossibleFraud

This indicator is calculated according to the criteria defined by the merchant:

1 = There is a risk of fraud 
0 = No risk of fraud detected

AN11
fraudResultFraud CodeAN50

fraudResultDetailsFraud DetailsObject - fraudResultDetails

explanationReason for refusal in case of fraudAN50

threeDSecure

This indicator lets you know if the transaction is 3DSecure or not:

Y = 3DS Transaction 
N = Non-3DS Transaction 
D = Demotion Case (Version 14 or higher)

AN1

softDescriptor

Information displayed on the account statement of the buyer, limited with certain means of payment. This information will be displayed on the payment ticket.

Special characters (not A..Z and 1..9) are specific to each acquirer / payment method.

AN64www.boutique.fr

version 13 or higher.

version 16 or higher for Paypal.

scoreScoring the possibility of fraud: Score from 0 to 10N52
externalWalletTypeType of wallet used during the transaction. Ex : V.Me, MasterpassAN20Masterpass
externalWalletContractNumberVAD contract number associated with Wallet paymentAN50

PartnerAdditionalData

Information returned to the merchant from the partners:

AN


version 16 or higher


avsAVS Address Verification Serviceobject avs
version 17 or higher


Object authorization


Field

Description

Mandatory

Format

Example

number

Authorization number issued by the acquirer authorization server. This field is filled in if the authorization request is granted1.

Yes

N6

123456

date

Date and time of authorization : Format : dd/mm/yyyy HH24:MI

Yes

AN17

18/05/18 16:12:29



 

Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk