Mappage des services REST aux actions de paiement en vitrine

Le magasin type Aurora utilise les services REST dans le processus de règlement des achats. Les actions pour chaque page correspondent à un service REST.

Page Panier (B2C)

Actions de paiement :
Actions de paiement
Actions de page Adresse URL HTTP Paramètres exemple Informations complémentaires
Modifier les attributs POST AjaxRESTOrderItemDelete
calculationUsage=-1,-2,-3,-4,-5,-6,-7
catalogId=10052
langId=-1
orderId=.
orderItemId=40001
requesttype=ajax
storeId=10001
AjaxRESTOrderItemDelete supprime l'article de la commande pour lequel les attributs doivent être modifiés.
POST AjaxRESTOrderItemAdd
calculationUsage=-1,-2,-3,-4,-5,-6,-7
catEntryId=10056
catalogId=10052
langId=-1
orderId=.
quantity=1
requesttype=ajax
storeId=10001
AjaxRESTOrderItemAdd ajoute un nouvel article de commande à l'aide de la SKU pour les attributs modifiés.
Sélectionner votre cadeau POST AjaxRESTOrderRewardOptionUpdate
calculationUsage=-1,-2,-5,-6,-7
catEntryId=10094
catEntryId=10040
orderId=15001
quantity=1
requesttype=ajax
rewardOptionId=1
storeId=10001
  • AjaxRESTOrderRewardOptionUpdate ajoute la SKU sélectionnée comme cadeau gratuit dans le panier.
  • Plusieurs cadeaux peuvent être appliqués en répétant le paramètre catEntryId.
Continuer le paiement GET RESTOrderItemUpdate
URL=https://hostname/webapp/wcs/stores/
servlet/UnregisteredCheckoutView?catalogId=10052
allocate=***
backorder=***
calculateOrder=1
calculationUsage=-1,-2,-3,-4,-5,-6,-7
check=*n
errorViewName=AjaxOrderItemDisplayView
guestChkout=1
langId=1
orderId=.
orderItemId=30004
remerge=***
storeId=10001
  • Paiement en tant qu'invité.
  • RESTOrderItemUpdate effectue le calcul des commandes et les vérifications des stocks.
  • Les paramètres suivants contrôlent le stock ATP : allocate, backorder, check. Pour plus d'informations, voir URL OrderItemUpdate.
  • Les abréviations d'ordre suivantes sont utilisées : ***, *n. Pour plus d'informations, voir Abréviations de commande.
  • UnregisteredCheckoutView est la première page du flux de paiement de l'utilisateur invité. Il permet aux utilisateurs d'entrer des informations d'expédition et de facturation pour la commande.
Connexion et paiement POST Logon
URL=https://hostname/webapp/wcs/stores/
servlet/RESTMoveOrderItem?updatePrices=0
&calculationUsageId=-1&createIfEmpty=1
&deleteIfEmpty=*&continue=1&toOrderId=.
&fromOrderId=*
&URL=RESTOrderCalculate%3FURL=https://hostname
/webapp/wcs/stores/servlet/OrderShippingBillingView
?shipmentType=single&catalogId=10052&langId=-1&storeId
=10001&calculationUsageId=-1&calculationUsageId=-2
&calculationUsageId=-7
catalogId=10052
errorViewName=AjaxOrderItemDisplayView
logonId=xxxx
logonPassword=xxxxxxx
reLogonURL=AjaxOrderItemDisplayView
storeId=10001
  • Paiement en tant qu'utilisateur enregistré.
  • Utilisez le paramètre URL pour former une chaîne de commandes. D'abord Logon, puis RESTMoveOrderItem fusionne le panier invité avec le panier de l'utilisateur enregistré, puis OrderShippingBillingView affiche le panier.
Mappage entre l'URL et l'API :
Mappage entre l'URL et l'API
URL Ressource REST Méthode REST Lien vers l'API Mappage de commandes
RESTOrderItemUpdate cart PUT /store/{storeId}/cart/@self/update_order_item panier OrderItemUpdateCmd
RESTMoveOrderItem cart PUT /store/{storeId}/cart/move_order_item panier OrderItemMoveCmd
AjaxRESTOrderItemDelete cart PUT /store/{storeId}/cart/@self/delete_order_item panier OrderItemUpdateCmd
AjaxRESTOrderItemAdd cart POST /store/{storeId}/cart panier OrderItemAddCmd
AjaxRESTOrderRewardOptionUpdate cart PUT /store/{storeId}/cart/@self/update_reward_option panier RewardChoiceUpdateCmd

Page des commandes en cours (B2B)

Actions de paiement :
Actions de paiement
Actions de page Adresse URL HTTP Paramètres exemple Informations complémentaires
Modifier les attributs POST AjaxRESTOrderItemDelete
calculationUsage=-1,-2,-3,-4,-5,-6,-7
catalogId=10052
langId=-1
orderId=.
orderItemId=40001
requesttype=ajax
storeId=10001
AjaxRESTOrderItemDelete supprime l'article de la commande pour lequel les attributs doivent être modifiés.
POST AjaxRESTOrderItemAdd
calculationUsage=-1,-2,-3,-4,-5,-6,-7
catEntryId=10056
catalogId=10052
langId=-1
orderId=.
quantity=1
requesttype=ajax
storeId=10001
AjaxRESTOrderItemAdd ajoute un nouvel article de commande à l'aide de la SKU pour les attributs modifiés.
Sélectionner votre cadeau POST AjaxRESTOrderRewardOptionUpdate
calculationUsage=-1,-2,-5,-6,-7
catEntryId=10094
orderId=15001
quantity=1
requesttype=ajax
rewardOptionId=1
storeId=10001
AjaxRESTOrderRewardOptionUpdate ajoute la SKU sélectionnée comme cadeau gratuit dans le panier.
Réserver GET RESTOrderItemUpdate
remerge=***
check=*n
allocate=***
backorder=***
calculationUsage=-1,-2,-3,-4,-5,-6,-7
calculateOrder=1
orderItemId=35001
errorViewName=AjaxOrderItemDisplayView
orderId=.
URL=https://localhost/webapp/wcs/stores/servlet/
OrderShippingBillingView?shipmentType=single
&catalogId=10251&langId=-1&storeId=10801
  • Paiement en tant qu'utilisateur B2B enregistré.
  • RESTOrderItemUpdate effectue le calcul des commandes et la vérification des stocks.
  • Les paramètres suivants contrôlent l'inventaire ATP : allocate, backorder, check. Pour plus d'informations, consultez la rubrique URL OrderItemUpdate
  • Les abréviations d'ordre suivantes sont utilisées : ***, *n. Pour plus d'informations, voir Abréviations de commande.
  • Le paramètre URL est utilisé pour établir une chaîne de commandes. Par exemple, lorsque RESTOrderItemUpdate est terminé, il transmet vers OrderShippingBillingView pour afficher le panier.
Mappage entre l'URL et l'API :
Mappage entre l'URL et l'API
URL Ressource REST Méthode REST Lien vers l'API Mappage de commandes
RESTOrderItemUpdate cart PUT /store/{storeId}/cart/@self/update_order_item panier OrderItemUpdateCmd
AjaxRESTOrderItemDelete cart PUT /store/{storeId}/cart/@self/delete_order_item panier OrderItemUpdateCmd
AjaxRESTOrderItemAdd cart POST /store/{storeId}/cart panier OrderItemAddCmd
AjaxRESTOrderRewardOptionUpdate cart PUT /store/{storeId}/cart/@self/update_reward_option panier RewardChoiceUpdateCmd

Page Mode d'expédition et de facturation (B2C)

Actions de paiement :
Actions de paiement
Actions de page Adresse URL HTTP Paramètres exemple Informations complémentaires
Sélectionner votre cadeau POST AjaxRESTOrderRewardOptionUpdate
calculationUsage=-1,-2,-3,-4,-5,-6,-7
catEntryId=18044
orderId=14001
quantity=1
requesttype=ajax
rewardOptionId=3
storeId=10801
AjaxRESTOrderRewardOptionUpdate change la SKU en tant que cadeau dans le panier.
Appliquer le code de promotion POST AjaxRESTPromotionCodeApply
catalogId=10251
finalView=AjaxOrderItemDisplayView
langId=-1
orderId=14001
promoCode=gggt
requesttype=ajax
storeId=10801
taskType=A
  • AjaxRESTPromotionCodeApply applique un code de promotion à la commande actuelle (panier).
  • taskType = A désigne une opération Apply.
Suivant POST AjaxRESTOrderPrepare
catalogId=10251
langId=-1
requesttype=ajax
storeId=10801
AjaxRESTOrderPrepare finalise la commande, y compris le prix, l'expédition, la taxe et les promotions. Ensuite, il verrouille la commande de sorte qu'elle soit prête pour la soumission.
POST AjaxRESTOrderPIAdd
account=4111111111111111
authToken=3006%2CQB64kwGO0u0CPr9d%2FMdUA9ZOoxw%3D
billing_address_id=12304
catalogId=10251
cc_brand=MasterCard
cc_cvc=555
expire_month=09
expire_year=2024
langId=-1
payMethodId=Master Card
piAmount=13.09000
requesttype=ajax
storeId=10801
AjaxRESTOrderPIAdd crée une instruction de paiement, y compris le mode de paiement et le montant. Une commande peut être payée en utilisant plusieurs modes de paiement, chacun couvrant une partie du montant total de la commande.
Mappage entre l'URL et l'API :
Mappage entre l'URL et l'API
URL Ressource REST Méthode REST Lien vers l'API Mappage de commandes
AjaxRESTPromotionCodeApply assigned_promotion_code POST /store/{storeId}/cart/@self/assigned_promotion_code assigned_promotion_code PromotionCodeAddRemoveControllerCmd
AjaxRESTOrderPrepare cart PUT /store/{storeId}/cart/@self/precheckout panier OrderPrepareCmd
AjaxRESTOrderPIAdd payment_instruction POST /store/{storeId}/cart/@self/payment_instruction payment_instructions PIAddCmd
AjaxRESTOrderRewardOptionUpdate cart PUT /store/{storeId}/cart/@self/update_reward_option panier RewardChoiceUpdateCmd

Page Mode d'expédition et de facturation (B2B)

Actions de paiement :
Actions de paiement
Actions de page Adresse URL HTTP Paramètres exemple Informations complémentaires
Changer votre cadeau POST AjaxRESTOrderRewardOptionUpdate
calculationUsage=-1,-2,-3,-4,-5,-6,-7
catEntryId=18044
orderId=14001
quantity=1
requesttype=ajax
rewardOptionId=3
storeId=10801
AjaxRESTOrderRewardOptionUpdate change le SKU en tant que cadeau dans le panier.
Appliquer le code de promotion POST AjaxRESTPromotionCodeApply
catalogId=10251
finalView=AjaxOrderItemDisplayView
langId=-1
orderId=14001
promoCode=gggt
requesttype=ajax
storeId=10801
taskType=A
  • AjaxRESTPromotionCodeApply applique un code de promotion à la commande actuelle (panier).
  • taskType = A désigne une opération Apply.
Suivant POST AjaxRESTOrderPrepare
catalogId=10251
langId=-1
requesttype=ajax
storeId=10801
AjaxRESTOrderPrepare finalise la commande, y compris le prix, l'expédition, la taxe et les promotions. Ensuite, il verrouille la commande de sorte qu'elle soit prête pour la soumission.
POST AjaxRESTOrderPIAdd
account=4111111111111111
authToken=3006%2CQB64kwGO0u0CPr9d%2FMdUA9ZOoxw%3D
billing_address_id=12304
catalogId=10251
cc_brand=MasterCard
cc_cvc=555
expire_month=09
expire_year=2024
langId=-1
payMethodId=Master Card
piAmount=13.09000
requesttype=ajax
storeId=10801
AjaxRESTOrderPIAdd crée une instruction de paiement, y compris le mode de paiement et le montant. Une commande peut être payée en utilisant plusieurs modes de paiement, chacun couvrant une partie du montant total de la commande.
Mappage entre l'URL et l'API :
Mappage entre l'URL et l'API
URL Ressource REST Méthode REST Lien vers l'API Mappage de commandes
AjaxRESTPromotionCodeApply assigned_promotion_code POST /store/{storeId}/cart/@self/assigned_promotion_code assigned_promotion_code PromotionCodeAddRemoveControllerCmd
AjaxRESTOrderPrepare cart PUT /store/{storeId}/cart/@self/precheckout panier OrderPrepareCmd
AjaxRESTOrderPIAdd payment_instruction POST /store/{storeId}/cart/@self/payment_instruction payment_instruction PIAddCmd
AjaxRESTOrderRewardOptionUpdate cart PUT /store/{storeId}/cart/@self/update_reward_option panier RewardChoiceUpdateCmd

Page Récapitulatif de la commande (B2C)

Actions de paiement :
Actions de paiement
Actions de page Adresse URL HTTP Paramètres exemple Informations complémentaires
Ordre POST AjaxRESTOrderSubmit
catalogId=10052
langId=-1
notifyMerchant=1
notifyOrderSubmitted=1
notifyShopper=1
orderId=13001
requesttype=ajax
storeId=10001
  • AjaxRESTOrderSubmit soumet la commande en réservant le stock en autorisant le paiement et en modifiant le statut de la commande.
  • Les paramètres suivants avisent d'autres personnes de la commande : notifyMerchant, notifyOrderSubmitted, notifyShopper.
Mappage entre l'URL et l'API :
Mappage entre l'URL et l'API
URL Ressource REST Méthode REST Lien vers l'API Mappage de commandes
AjaxRESTOrderSubmit cart POST /store/{storeId}/cart/@self/checkout panier OrderProcessCmd

Page Récapitulatif de la commande (B2B)

Actions de paiement :
Actions de paiement
Actions de page Adresse URL HTTP Paramètres exemple Informations complémentaires
Ordre POST AjaxRESTOrderSubmit
catalogId=10052
langId=-1
notifyMerchant=1
notifyOrderSubmitted=1
notifyShopper=1
orderId=13001
requesttype=ajax
storeId=10001
  • AjaxRESTOrderSubmit soumet la commande en réservant le stock en autorisant le paiement et en modifiant le statut de la commande.
  • Les paramètres suivants avisent d'autres personnes de la commande : notifyMerchant, notifyOrderSubmitted, notifyShopper.
Mappage entre l'URL et l'API :
Mappage entre l'URL et l'API
URL Ressource REST Méthode REST Lien vers l'API Mappage de commandes
AjaxRESTOrderSubmit cart POST /store/{storeId}/cart/@self/checkout panier OrderProcessCmd

Page Commande rapide

Actions de paiement :
Actions de paiement
Actions de page Adresse URL HTTP Paramètres exemple Informations complémentaires
Ordre POST AjaxRESTOrderAddPreConfigurationToCart
calculateOrder=0
catalogId=10052
langId=-1
partNumber_1=HVT038_380201
quantity_1=1
requesttype=ajax
storeId=10001
AjaxRESTOrderAddPreConfigurationToCart ajoute un article au panier. L'élément peut être un kit dynamique configuré, mais peut également être une SKU normale. Dans cet exemple, il s'agit d'une SKU normale.
Mappage entre l'URL et l'API :
Mappage entre l'URL et l'API
URL Ressource REST Méthode REST Lien vers l'API Mappage de commandes
AjaxRESTOrderAddPreConfigurationToCart cart POST /store/{storeId}/cart/@self/add_preconfiguration_to_cart panier OrderProcessCmd

Page Cadeau

Actions de paiement :
Actions de paiement
Actions de page Adresse URL HTTP Paramètres exemple Informations complémentaires
Appliquer POST AjaxRESTOrderRewardOptionUpdate
calculationUsage=-1,-2,-3,-4,-5,-6,-7
catalogId=10052
langId=-1
orderId=.
orderItemId=80001
requesttype=ajax
storeId=10001
AjaxRESTOrderItemDelete ajoute la SKU sélectionnée comme cadeau gratuit dans le panier.
Mappage entre l'URL et l'API :
Mappage entre l'URL et l'API
URL Ressource REST Méthode REST Lien vers l'API Mappage de commandes
AjaxRESTOrderRewardOptionUpdate cart PUT /store/{storeId}/cart/@self/update_reward_option panier RewardChoiceUpdateCmd

page Paiement rapide

Actions de paiement :
Actions de paiement
Actions de page Adresse URL HTTP Paramètres exemple Informations complémentaires
Sélection de l'adresse de livraison POST AjaxRESTOrderShipInfoUpdate
addressId=11801
allocate	=***
backorder=***
calculateOrder=1
calculationUsage=-1,-2,-3,-4,-5,-6,-7
catalogId=10052
check=*n
langId=-1
orderId=.
remerge=***
requesttype=ajax
storeId=10001
  • addressId désigne l'ID d'adresse sélectionné.
  • Les paramètres suivants contrôlent l'inventaire ATP : allocate, check, backorder, remerge. Pour plus d'informations, voir URL OrderItemUpdate.
  • Les abréviations d'ordre suivantes sont utilisées : ***, *n. Pour plus d'informations, voir Abréviations de commande.
Sélectionner le mode d'expédition POST AjaxRESTOrderShipInfoUpdate
allocate=***
backorder=***
calculateOrder=1
calculationUsage=-1,-2,-3,-4,-5,-6,-7
catalogId=10052
check=*n
langId=-1
orderId=.
remerge=***
requesttype=ajax
shipModeId=10053
storeId=10001
  • shipModeId désigne l'ID de mode d'expédition sélectionné.
  • Les paramètres suivants contrôlent l'inventaire ATP : allocate, check, backorder, remerge. Pour plus d'informations, voir URL OrderItemUpdate.
  • Les abréviations d'ordre suivantes sont utilisées : ***, *n. Pour plus d'informations, voir Abréviations de commande.
Appliquer le code de promotion POST AjaxRESTPromotionCodeApply
catalogId=10251
finalView=AjaxOrderItemDisplayView
langId=-1
orderId=14001
promoCode=gggt
requesttype=ajax
storeId=10801
taskType=A
  • AjaxRESTPromotionCodeApply applique un code de promotion à la commande actuelle (panier).
  • taskType = A désigne une opération Apply.
Retour GET RESTOrderCalculate
calculationUsageId=-1&updatePrices=1&catalogId=10052
&errorViewName=AjaxCheckoutDisplayView&orderId=.&langId=-1
&storeId=10001&URL=https://localhost/webapp/wcs/stores
/servlet/AjaxCheckoutDisplayView
Recalcule la commande, puis la transmet à la page Panier.
Suivant POST AjaxRESTOrderPrepare
catalogId=10251
langId=-1
requesttype=ajax
storeId=10801
AjaxRESTOrderPrepare finalise la commande, y compris le prix, l'expédition, la taxe et les promotions. Ensuite, il verrouille la commande de sorte qu'elle soit prête pour la soumission.
POST AjaxRESTOrderPIAdd
account=4111111111111111
authToken=3006%2CQB64kwGO0u0CPr9d%2FMdUA9ZOoxw%3D
billing_address_id=12304
catalogId=10251
cc_brand=MasterCard
cc_cvc=555
expire_month=09
expire_year=2024
langId=-1
payMethodId=Master Card
piAmount=13.09000
requesttype=ajax
storeId=10801
AjaxRESTOrderPIAdd crée une instruction de paiement, y compris le mode de paiement et le montant. Une commande peut être payée en utilisant plusieurs modes de paiement, chacun couvrant une partie du montant total de la commande.
Mappage entre l'URL et l'API :
Mappage entre l'URL et l'API
URL Ressource REST Méthode REST Lien vers l'API Mappage de commandes
AjaxRESTOrderShipInfoUpdate assigned_promotion_code POST /store/{storeId}/cart/@self/assigned_promotion_code assigned_promotion_code OrderItemUpdateCmd
AjaxRESTPromotionCodeApply cart PUT /store/{storeId}/cart/@self/precheckout panier PromotionCodeAddRemoveControllerCmd
RESTOrderCalculate payment_instruction POST /store/{storeId}/cart/@self/payment_instruction payment_instruction OrderCalculateCmd
AjaxRESTOrderPrepare cart PUT /store/{storeId}/cart/@self/update_reward_option panier OrderPrepareCmd
AjaxRESTOrderPIAdd payment_instruction POST /store/{storeId}/cart/@self/payment_instruction payment_instruction PIAddCmd