Webservice - doCaptureRequest

S’abonner

La fonction « doCapture » réalise une demande de validation d’une autorisation acceptée. Une fois la validation prise en compte, un fichier contenant toutes les validations est remis à la banque du commerçant ; Payline effectue une remise des demandes de paiement à votre établissement bancaire.

Requête à envoyer

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

Élément

Description

Requis

Type

Exemple

 
versionVersion des web services PaylineouiN2A valoriser avec la dernière version : voir le tableau des versions.Requis depuis 2011
transactionIDIdentifiant de la transaction d’autorisationouiAN50  
paymentInformations sur le paiementouiObject - payment

voir les éléments ci-dessous

 

privateDataList

 

Vos propres informations personnelles

non

privateDataList object

voir les éléments ci-dessous

 
sequenceNumberNuméro de séquence utilisée lors de la transactionnonAN50  
media

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

Les valeurs possibles de cette balise sont :

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

nonAN25Mobile 

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 privateDataList

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

 

Object privateData


Field

Description

Mandatory

Format

Example

key

Key name of value

Yes

AN50

user

value

Key value

Yes

AN50

Martin

 

Réponse en retour

Le message « doCaptureResponse » est la réponse faite par Payline à une demande de validation d’une autorisation de débit. La réponse a la structure suivante :

 

Élément

Description

Requis

Format

Exemple

result

Information sur le résultat de la demande de validationoui

result object

cf. liste complète en annexe « Code retour et message Payline »

transactionInformation sur la transactionouitransaction object 
reAuthorizationCet indicateur permet de savoir un ré-autorisation a été réalisée:

1 = Re-autorisation réalisée
0 = Aucune re-autorisation réalisée

nonN1

1

Les éléments de référence

Object result


Field

Description

Format

Condition

code

The return code of the web service: See details of Payline Return Codes

Accepted transaction: 00000, 02400, 02500, 02501, 02517, 02520, 02616, 03000, 04000.
Other code: Transaction not accepted.

N5


shortMessage

Short message of the result of the transaction. See the list of values

AN50


longMessage

Message of the result of the transaction

AN255


partnerCodeReturn code from partner (payment method) and SAA acquirerAN50From version 14
partnerCodeLabelPartner's wordingAN255From version 14

 

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

Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk