Périmètre

BackOffice Djust

Améliorations graphiques et optimisations de design

Dans la continuité de la refonte globale du Back Office de Djust, un redesign de la page des customers tags a été revu afin de simplifier l'expérience utilisateur.
Cette page est accessible via l’interface de Settings > Customer Tag Management.

API

📘
NEW

Djust PAY

Onboarding KYC/KYB

Afin de garantir la conformité réglementaire et faciliter la gestion des paiements, une nouvelle route d’administration d’onboarding pour les utilisateurs de Djust Pay a été créée :

ADM-PAY-100 - POST /v1/legal/onboarding-links

Le body contient les éléments pour assurer la redirection vers le parcours d’onboarding géré par notre partenaire Adyen :

{   
  "redirectUrl": "https://djust.backoffice.url/", 
  "locale": "en-US" 
}

Le retour de l’API donne en résultat le lien généré par Adyen afin que le Backoffice Djust fasse la redirection nécessaire.

⚠️
Attention
Cette route n’est pas utilisable en dehors du Backoffice Djust.

Initialisation du widget de paiement front

Un nouveau widget front de paiement va être prochainement intégrable pour les clients sous contrat Djust PAY.

L’initialisation de ce widget commence par la récupération des moyens de paiement éligibles. L’API suivante permet cette récupération dans un contexte donné :

PAY-501 - GET /v1/shop/payments/payment-methods

Les attributs d’entrée sont :

Query parameter	Required	Type	Description
`countryCode`		string	Code pays sur deux lettres
`locale`		string	La combinaison d'un code de langue et d'un code de pays pour spécifier la langue à utiliser dans le paiement
`reference`	✅	string	Référence de la commande

La réponse renvoie la liste des moyens de paiement utilisables pour le contexte d’entrée donné qui est à transmettre au widget front :

{
	"adyenPaymentMethods": [
		{
			"name": "SEPA Direct Debit",
			"type": "sepadirectdebit"
		},
		{
			"name": "SEPA Bank Transfer",
			"type": "bankTransfer\_IBAN"
		},
		{
			"name": "Visa Checkout",
			"type": "visacheckout"
		}
	]
}

Paiement CB (avec paramètres nécessaires à la gestion du 3DS) :

Le paiement CB est initié lorsqu’une demande d’autorisation est faite. Le client renseigne ses informations de CB et une demande est faite à sa banque émettrice pour savoir si les fonds sont disponibles ou non. La demande est faite via l’API suivante :

PAY-101 - POST /v1/shop/payments

Le body contient les paramètres suivants :

Query parameter	Required	Type	Description
reference	✅	string	Référence de la commande
paymentMethodData	✅	object	L’objet paymentMethod a terme aura d’autres attributs. Chacun des attributs est potentiellement propre à un moyen de paiement donné.
returnUrl	✅	string	URL de retour post paiement (OK ou KO)
customerUserIP	✅	string	Adresse IP du customer user connecté qui passe la commande.
browserInfo	✅	object	L’objet browserInfo contient l’ensemble des éléments issus du browser du client. Il provient de l’élément state.data.browserInfo du widget de Drop-In de paiement.

La réponse contient les éléments nécessaires au traitement de l’autorisation et de l'éventuel challenge 3DS qui suit :

{
	"pspReference": "string",
	"resultCode": "string",
	// Contexte redirection 3DS CB :
	"action": {
	  "paymentMethodType": "scheme",
	  "url": "<https://checkoutshopper.test.com/checkoutshopper/threeDS/redirect>...",
	  "method": "GET",
	  "type": "redirect"
	}
}

ℹ️
Note
La gestion complète du 3DS est en cours et sera livrée dans la release suivante.

👍
UPDATE

Djust PAY

Nouveau statut de paiement possible à l'initialisation :

Un nouveau statut de paiement est ajouté lorsqu’une commande est créé. Par défaut le statut de départ sera mis en INIT_PAYMENT.

⚠️
Attention
Seuls les utilisateurs de Djust PAY sont pour le moment touchés par ces changements.

Les routes concernées par ce nouveau statut sont :

GET /v1/logistic-orders
POST /v1/logistic-orders
POST /v1/logistic-orders/export
GET /v1/logistic-orders/{orderLogisticId}
GET /v1/logistic-orders/{orderLogisticId}/approvals
GET /v1/supplier-quotes/{supplierQuoteId}/orders


ORDER-560 - GET /v1/shop/commercial-orders
ORDER-100 - POST /v1/shop/commercial-orders
ORDER-500 - GET /v1/shop/commercial-orders/{orderCommercialId}
ACCOUNT-550 - GET /v1/shop/customer-accounts/orders
ACCOUNT-555 - GET /v1/shop/customer-accounts/organisations/{organisationId}/orders
N/A - GET /v1/shop/logistic-orders
ORDER-550 - POST /v1/shop/logistic-orders
ORDER-501 - GET /v1/shop/logistic-orders/{orderLogisticId}
ORDER-205 - PATCH /v1/shop/logistic-orders/{orderLogisticId}
ORDER-200 - PUT /v1/shop/logistic-orders/{orderLogisticId}/approve
ORDER-556 - GET /v1/shop/logistic-orders/{orderLogisticId}/approvers
ORDER-201 - PUT /v1/shop/logistic-orders/{orderLogisticId}/cancel
ORDER-203 - PUT /v1/shop/logistic-orders/{orderLogisticId}/confirm-reception
ORDER-204 - PUT /v1/shop/logistic-orders/{orderLogisticId}/disapprove
ORDER-107 - POST /v2/shop/supplier-quotes/{supplierQuoteId}/initialize-orders

Nouveau provider de paiement pour la création de commande cart v1 :

Les routes suivantes évoluent avec l'ajout d'une nouvelle valeur possible dans la liste des fournisseurs de paiement : DJUSTPAY.

ORDER-100 - POST /v1/shop/commercial-orders
ORDER-212 - PUT /v1/shop/commercial-orders/{orderCommercialId}/created
ORDER-507 - GET /v1/shop/commercial-orders/{orderCommercialId}/payment-page
ORDER-105 - POST /v1/shop/commercial-orders/{orderCommercialId}/preauthorization
ORDER-104 - POST /v1/shop/commercial-orders/{orderCommercialId}/card-registration

Search

La route PRODUCT-552 - GET /v2/shop/search évolue pour autoriser la remontée des produits sans offres dans les résultats du search.

Le champ currency est également rendue facultatif.

Stores

Il est maintenant possible d'ajouter des customs fields au store.

Pour cela, on peut utiliser les apis d'administration suivantes pour configurer les custom fields aux stores :

GET /v1/custom-fields
POST /v1/custom-fields

⚠️
Attention
L’interface de configuration dans le back-office Djust n’est pas encore disponible

Les routes suivantes d'administration permettent d'ajouter, d'éditer ou supprimer des valeurs de custom fields aux stores :

GET /v1/stores
POST /v1/stores
PUT /v1/stores/{storeExternalId}
GET /v1/stores/{storeId}

La route front suivante permet aussi de récupérer les valeurs configurées ainsi que tout le contenu d'un store dédié :

STORE-500 - GET /v1/shop/stores/{storeId}