Set Delivery Option

Updates the selected delivery or shipping option for a pending order’s cart.

Endpoint

POST https://partners.waffarx.com/api/ValuCheckout/setdeliveryoption

Request Headers

Header	Description
wxc-id	Your WaffarX Client Id
wxc-auth	Signature auth header for the request
wxc-date	UTC timestamp of the request, e.g. 2025-04-30T15:00:00Z
Accept-Language	Response language preference (e.g. en | ar)
Content-Type	Must be application/json

Note

wxc-id: The WaffarX client ID specified in your integration data.

Request Parameters

Name	Type	Required	Description
PendingOrderId	String		The identifier of the pending order whose cart address is being updated.
OptionId	String		Unique identifier the chosen shipping or delivery option, retrieved from the list of available shipping options for the cart.

Note

• OptionId must exactly match one of the values returned from the update cart address.

• Updating the delivery option may recalculate totals, including shipping fees and taxes.

Request Body

Example Request Body

 {
     "PendingOrderId": "68cf3cca5a0f3e1f5e0dc0c8",
     "OptionId": "c511d14f513a754494f7a97c1d8d9527"
 }

cURL Example

curl --location 'https://partners.waffarx.com/api/ValuCheckout/setdeliveryoption' \
     --header 'Content-Type: application/json' \
     --header 'Accept-Language: en' \
     --header 'wxc-id: {YOUR_CLIENT_ID}' \
     --header 'wxc-date: 2025-09-21T00:42:17Z' \
     --header 'wxc-auth: d40a0e226a8ab15b2ef94454ca36734387ef7b653545b1f5540d423f7456da25' \
     --data '{"PendingOrderId":"68cf3cca5a0f3e1f5e0dc0c8","OptionId":"c511d14f513a754494f7a97c1d8d9527"}'

Responses

Success (HTTP 200)

Success Response Example

   {
       "code": null,
       "status": "Success",
       "data": {
           "pendingOrderId": "68e6d2526e12591bce5075df",
           "message": "order addresses and shipping updated successfully",
           "partnerTotalPrice": 1215.00,
           "currency": "EGP",
           "paymentSummary": {
               "totalPrice": 875.00,
               "shippingFees": 75.00,
               "products": [
                   {
                       "storeName": "Test Valu",
                       "storeLogo": "https://waffarxcdn-akcrhqbhbah9gpcc.z01.azurefd.net/waffarx-cdn/siteimages/stores/advlogo202509101016121612.jpeg",
                       "brand": "waffar",
                       "name": "Iphone 14 Pro Max",
                       "price": 800,
                       "oldPrice": 650,
                       "heroProduct": false
                   }
               ]
           },
           "storeSettings": {
               "vendorID": "VDR0410212931",
               "productID": "EGMHOC23DP1",
               "partnerStoreID": "121283146",
               "heroVendorID": "HeroVDR0410212931",
               "heroProductID": "HeroEGMHOC23DP1",
               "heroPartnerStoreID": "Hero121283146"
           }
       },
       "message": null,
       "errors": null
   }

Error (HTTP 4XX/5XX)

Error Response Example

   {
     "Status": "Error",
     "Data": null,
     "Message": null,
     "Errors": []
   }