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. |
| transactionID | Identifiant de la transaction d’autorisation à ré-autoriser | oui | AN50 | |
| payment | Information sur le paiement | oui | Object - payment | Voir les éléments ci-dessous |
| order | Information sur la commande | non | Object - order | Voir les éléments ci-dessous |
| 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 :
| non | AN25 |
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 | |
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. | 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. | No | AN64 | www.boutique.fr | version 13 or higher |
| cardBrand | Indicates the mark used for the operation, see the values. | No | AN | 15 | version 15 or higher |
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. | No | AN | 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. | 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. | No | N12 | 100 | |
amount | The amount of order in smallest unit of currency. Usually the same amount as payment.amount. | Yes | N12 | 6000 | |
currency | The ISO code of payment currency: 978: euros 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 | |||
deliveryTime | Delivery time : 1 = express | No | N | 1 | |
deliveryMode | Delivery method : 1: Withdrawal of goods from the merchant | No | N | 4 | |
| deliveryCharge | Amount of delivery charges in smallest unit of currency, example 250 for 2.50 euros | No | N | version 18 ou supérieure | |
| deliveryExpectedDate | Expected delivery date must be greater than the current date. Format: dd/mm/yyyy | No | AN18 | 07/04/2016 | Posted to Limonetik |
| deliveryExpectedDelay | Expected delivery time (in days) | No | N2 | 10 | Posted to Limonetik |
Object privateDataList
Field | Description | Mandatory | Format | Example |
|---|---|---|---|---|
privateData | List containing privateData Number of items 0 to 100 | Yes |
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 | |
| result | Informations sur le résultat de la demande de ré-autorisation | oui | result object | ||
transaction | Informations sur la transaction | oui | transaction object | Voir 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 - extendedCardType | Voir 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. | 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 | |
| partnerCode | Return code from partner (payment method) and SAA acquirer | AN50 | From version 14 |
| partnerCodeLabel | Partner's wording | AN255 | From version 14 |
Object transaction
| Field | Description | Format | Example | Condition |
|---|---|---|---|---|
| id | Unique identifier of the Payline transaction | AN50 | ||
| date | Date and time of Payline transaction. Format : dd/mm/yyyy HH24:MI | AN17 | 01/01/2018 12:00 | |
| isDuplicated | This indicator is returned by Payline in the case of a duplicate transaction: 1 = duplicate transaction | AN1 | 1 | |
| isPossibleFraud | This indicator is calculated according to the criteria defined by the merchant: 1 = There is a risk of fraud | AN1 | 1 | |
| fraudResult | Fraud Code | AN50 | ||
| fraudResultDetails | Fraud Details | Object - fraudResultDetails | ||
| explanation | Reason for refusal in case of fraud | AN50 | ||
| threeDSecure | This indicator lets you know if the transaction is 3DSecure or not: Y = 3DS Transaction | 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. | AN64 | www.boutique.fr | version 13 or higher. version 16 or higher for Paypal. |
| score | Scoring the possibility of fraud: Score from 0 to 10 | N5 | 2 | |
| externalWalletType | Type of wallet used during the transaction. Ex : V.Me, Masterpass | AN20 | Masterpass | |
| externalWalletContractNumber | VAD contract number associated with Wallet payment | AN50 | ||
| PartnerAdditionalData | Information returned to the merchant from the partners:
| AN | version 16 or higher | |
| avs | AVS Address Verification Service | object 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 |
Commentaires