NAV Navbar
Logo

- Guide rapide -

Mise à jour pour la DSP2

Ce qu'il faut mettre à jour afin d'être compatible pour la DSP2


Quel langage de programmation préférez-vous?

| PHP | Python |

Pour naviguer dans la présentation, appuyez sur les flèches directionnelles ou sur la touche espace de votre clavier.

Principales étapes

1# Vous devez mettre à jour votre bibliothèque :

PayPlug PHP library version 3.0.0 ou supérieure

PayPlug Python library version 1.2.2 ou supérieure

2# Dans votre code permettant de créer des paiement, effectuez les 2 étapes suivantes :

  • Supprimer la clé customer.
  • Ajouter les clés billing et shipping.

les informations de facturation (Billing)

Dans billing, les clés suivantes sont recommandées pour favoriser l’authentification sans friction :

first_name Le prénom du payeur (100 caractères max).
last_name Le nom de famille du payeur (100 caractères max).
email L’adresse email du payeur (255 caractères max).
address1 L’adresse postale du payeur (255 caractères max).
postcode Le code postal du payeur (16 caractères max).
city La ville du payeur (100 caractères max).
country Le pays du payeur, basé sur la norme ISO 3166.

Les informations d’expédition (Shipping)

Dans shipping, les clés suivantes sont recommandées pour favoriser l’authentification sans friction :

first_name Le prénom du destinataire (100 caractères max).
last_name Le nom de famille du destinataire (100 caractères max).
email L’adresse email du destinataire (255 caractères max).
address1 L’adresse postale du destinataire (255 caractères max).
postcode Le code postal du destinataire (16 caractères max).
city La ville du destinataire (100 caractères max).
country Le pays du destinataire, basé sur la norme ISO 3166.
delivery_type Le mode de livraison. (Plus de détails concernant le delivery_type sur la page suivante)

Le type de livraison (Delivery type)

Avec la clé delivery_type vous devez choisir l’une des valeurs suivante :

BILLING L’expédition se fait vers l’adresse de facturation du payeur.
VERIFIED L’expédition se fait vers une adresse vérifiée par le marchand.
NEW L’expédition se fait vers une adresse différente de celle de facturation.
SHIP_TO_STORE La collecte s’effectue dans un point de livraison (l’adresse doit être renseignée dans la variable address de la clé shipping).
DIGITAL_GOODS Tous les biens numériques (sans expédition).
TRAVEL_OR_EVENT Ventes de tickets concernant l’événementiel ou les voyages (pas d’expédition).
OTHER Autre (tous les services en ligne sans expédition).

Les champs optionnels

Une avancée significative de la DSP2 est la possibilité de recueillir plus de données afin de favoriser l’authentification sans friction.

Dans cette perspective, vous pouvez inclure des champs optionnels dans votre code :

mobile_phone_number Le numéro de mobile du destinataire ou du payeur (formattage intrnational standard E.164). Par exemple, un numéro de mobile français sera sous la forme +33611111111.
landline_phone_number Le numéro fixe du destinataire ou du payeur (formattage intrnational standard E.164). Par exemple, un numéro fixe français sera sous la forme +33111111111.
language La langue du destinataire ou du payeur en 2 lettres au format ISO 639-1 code. Langages supportés : fr, en, it.

Si vous utilisez directement les endpoints

Si vous avez développé votre intégration en vous basant sur les endpoints (donc sans utiliser une bibliothèque), vous devez inclure le numéro de version de l’API dans le header.

L’API PayPlug est compatible avec la DSP2 à partir de la version 2019-08-06.

Vous pouvez suivre l’exemple ci-dessous :

$ curl -X GET https://api.payplug.com/v1/payments \
   -H "Authorization: Bearer sk_live_43b7e007298f57f732800a52" \
   -H "PayPlug-Version: 2019-08-06"