Périmètre

Back Office

• Ajout de la référence externe de la commande dans la page détail order :

  La référence externe d'une commande est désormais affichée dans son détail.

  
  

API

📘

NEW

Paiement

• Paiement par carte achat niveau 3 (P-Card L3)

Contexte :

Djust PAY va très prochainement prendre en charge le paiement par carte achat (P-Card) au niveau 3.

Cette évolution permet aux entreprises clientes d’utiliser leurs cartes d’achat pour régler leurs commandes B2B tout en bénéficiant du niveau de granularité requis par les programmes de facturation corporate (Level 3), notamment sur les marchés publics en France.

Fonctionnement métier :

• Pour pouvoir mettre en place la saisie des informations de cartes, il est nécessaire avant tout de pouvoir configurer par un administrateur les différentes URLs de redirection possibles pour le bon fonctionnement du paiement :
  • onSuccessPath → chemin relatif pour la redirection succès UX.
  • onErrorPath → chemin relatif pour la redirection échec UX.
  • postbackUrl → URL HTTPS absolue du callback S2S (réception du token de paiement).
  • payPageUrl → URL HTTPS absolue de la PayPage utilisée comme PAY-101.action.url.
• Les données sensibles ne transitent jamais par le front ni par Djust.

Les URLs front sont construites à partir de la base de redirection effective (effectiveRedirectBaseUrl), calculée automatiquement selon la configuration du store view.

APIs correspondantes :

🔍 Récupérer la configuration PCard-L3 (provider ITS couplé à Djust PAY)

ADM-SETTINGS-500 - GET /v1/settings/payments/its

{
  "onSuccessPath": "/payment/return",
  "onErrorPath": "/payment/error",
  "postbackUrl": "https://pay.djust.example/connectors/its/postback",
  "payPageUrl": "https://its.example/PayPage",
  "effectiveRedirectBaseUrl": "https://shop.example",
  "successUrlPreview": "https://shop.example/payment/return",
  "errorUrlPreview": "https://shop.example/payment/error",
  "updatedAt": "2025-09-26T12:34:56Z"
}

✏️ Créer / Mettre à jour la configuration PCard-L3

ADM-SETTINGS-201 - PUT /v1/settings/payments/its

{
  "onSuccessPath": "/payment/return",
  "onErrorPath": "/payment/error",
  "postbackUrl": "https://pay.djust.example/connectors/its/postback",
  "payPageUrl": "https://its.example/PayPage"
}

⚙️ Workflow global

1. Le front appelle PAY-101 avec un returnPath, la locale, le pays et paymentMethodData.type = purchasing_card_l3.
2. Djust PAY appelle ITS (Provider PCard L3) en lui transmettant les trois URLs configurées.
3. L’acheteur saisit sa carte sur la PayPage.
4. L'utilisateur est redirigé vers le front (succès / échec).
5. Djust PAY lance l’autorisation carte ensuite côté serveur.