paymentRequest

L'objet paymentRequest permet de transmettre des informations liées au paiement.

Il possède les attributs suivants :

Tableau 1. Objet paymentRequest
paymentRequest
Attribut Requis Format
transactionId

Identifiant de la transaction lors de la création ou la modification d'une transaction de paiement.

Sa valeur est unique sur une même journée.

  • Soit cet identifiant est généré par la plateforme. Dans ce cas, ce paramètre ne doit pas être renseigné.
  • Soit cet identifiant est généré par le site marchand. Dans ce cas, ce paramètre doit être renseigné avec la valeur de l’identifiant souhaité. Attention, il incombe au site marchand de s’assurer de l’unicité des identifiants. Toute demande d'enregistrement contenant un identifiant déjà existant, sera rejetée, et retournera un code d’erreur 12.

    Remarque : cet attribut ne peut être envoyé à vide.

  an..6
retryUuid

Permet de spécifier l'identifiant unique de la transaction afin de réitérer la demande du paiement refusée.

Pour effectuer ce rejeu, veillez à récupérer la valeur de la référence unique de la transaction refusée véhiculée par l'attribut transactionUuid de l'objet paymentResponse.

  string
amount

Montant de la transaction dans sa plus petite unité monétaire (le centime pour l'euro) .

Remarque :

  • Ne doit pas être envoyé à vide ou être à 0.
  • Ne doit pas être supérieur au montant initial (cas du remboursement).
n..12
currency

Code de la devise de la transaction (norme ISO 4217).

Ex : 978 pour l'euro (EUR)

n3
expectedCaptureDate

Date de remise demandée exprimée au format ISO 8601 définit par W3C.

Exemple : 2016-07-16T19:20:00Z.

Ce paramètre est utilisé pour effectuer un paiement différé.

Si le nombre de jours entre la date de remise demandée et la date actuelle est supérieur à la durée de validité de l'autorisation , une autorisation de 1 EUR (ou demande de renseignement sur le réseau CB si l'acquéreur le supporte) sera réalisée le jour de la transaction. Ceci afin de vérifier la validité de la carte.

L’autorisation pour le montant total sera effectuée :

  • fonctionnement par défaut : le jour de la date de remise en banque souhaitée,
  • fonctionnement avec autorisation anticipée : selon le moyen de paiement sélectionné, à J- le nombre de jours correspondant à la durée de validité d'une autorisation avant la date de remise en banque souhaitée.

Si vous souhaitez être notifié du résultat de cette demande d’autorisation, vous devez configurer la règle de notification URL de notification sur autorisation par Batch dans le Back Office Marchand (Paramétrage > Règles de notifications).

Remarque : si le délai avant remise est supérieur à 365 jours dans la requête de paiement, il est automatiquement repositionné à 365 jours.

  dateTime ans..40
manualValidation

Permet de valider manuellement une transaction tant que la date de remise en banque souhaitée n’est pas dépassée.

Pour cela, cet attribut doit être valorisé à 1 (validation manuelle).

Valorisé à 0, la validation sera automatique.

  n1
paymentOptionCode.

Permet de définir le code de l'option de paiement à utiliser.

   
acquirerTransientData

Permet de transmettre des informations utiles à l'acquéreur pour réaliser des contrôles anti-fraude:

URL de la boutique, nom de la boutique, numéro de commande, frais de port, méthode de livraison, etc..

Exemple :

acquirerTransientData = {VISANET={ "field91": "10XXXXXXX", "field92": "Lyra Peru", "field93": "specific data" }}

  json