Webservice - doReAuthorizationRequest

S’abonner

Cette méthode permet de rejouer une transaction acceptée. Les règles sont définies ci-dessous :

  • Les autorisations (validée partiellement ou entièrement) ou autorisation+valide  acceptées peuvent être ré-autorisée ;
  • Une ré-autorisation peut être ré-autorisée ;
  • Aucune règle sur le montant pour une ré-autorisation mais une règle existe la validation d’une ré-autorisation, Payline utilise la même méthode qu’une autorisation normale avec les offset de capture ;
  • La nouvelle autorisation doit avoir la même devise que celle d’origine sinon une erreur est renvoyée sans stockage en base : 02620 « Currency must be the same as the original authorization » ;
  • Une ré-autorisation peut être effectuée sur des autorisations allant jusqu'à 11 mois après sa date de création ;
  • La référence de la ré-autorisation est récupérée de la transaction d’origine si elle n’a pas de nouvelle référence associée ;
  • La ré-autorisation est une transaction à part entière, donc si la ré-autorisation est effectuée à moins de 24h de la transaction d’origine alors elle sera considérée comme un doublon sauf si la référence de la commande est différente de celle de la transaction d’origine ;
  • L’option ré-autorisation doit être activée dans un contrat pour pouvoir faire une ré autorisation, sinon un code erreur est renvoyé : 02619 «You don't have the reauthorization option».

Requête à envoyer


Élément

Description

Requis

Type

Exemple

version

Version des web services Payline

oui

AN2

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

transactionIDIdentifiant de la transaction d’autorisation à ré-autoriserouiAN50
paymentInformation sur le paiementouiObject - paymentVoir les éléments ci-dessous
orderInformation sur la commandenonObject - orderVoir les éléments ci-dessous
privateDataListInformation sur les informations personnellesnonObject - privateDataListVoir 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
nonAN25

Les références

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 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

Réponse en retour

Élément

Description

Requis

Type

Exemple

 
resultInformations sur le résultat de la demande de ré-autorisationouiresult object

Voir les éléments ci-dessous

 

transaction

Informations sur la transaction

oui

transaction objectVoir les éléments ci-dessous 

card

Informations sur la carte

non

Object - cardOut Voir les éléments ci-dessous 

extendedCard

Informations supplémentaire sur la carte

non

Object - extendedCardTypeVoir les éléments ci-dessous 

Les éléments de références

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

 

Object cardOut


Field

Description

Mandatory

Format

Example

Condition

number

Card marked according to PCI DSS

non

AN

111122XXXXXX4444

If the token field is populated, the number field must be empty.

type

Type of card: CB, VISA, MASTERCARD, MAESTRO, AMEX

non

AN

CB


expirationDate

Expiration date of the card

non

AN

0311


cardholder

Cardholder's name

non

AN20

Pierre Dupont


token

Alias ​​of the card number.

The version must be greater than or equal to 3

non

AN19

1111gPNzHtyu4444


 

Object extendedCardType


Field

Description

Mandatory

Example

country

Card country issuer : CODE ISO 

AN2

FR

isCvd

The card is it a Carte Bleue : Y or N

AN1

Y

bank

The bank of the card used for payment

AN

Crédit Lyonnais

type

The type of payment card

AN20

MASTERCARD

network

Refers to attachment of card to an entity managing the acceptance of card at national or international level

AN20

MASTERCARD

product

Indicates the category to which the card type belongs: see product codes

AN

Gold/Premier

 

 


Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk