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