Update Cart Address

Updates the billing and shipping address details for a pending order’s cart.

Endpoint

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

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.
Address	Object		Customer address details to be associated with the cart

Address Object

Name	Type	Required	Description
Email	String		Customer email address.
FirstName	String		Customer’s first name.
LastName	String		Customer’s last name.
Address1	String		Primary street address.
Address2	String		Secondary address (e.g., apartment, suite).
CityId	String		City Id of the address.
CountryId	String		Country Id
ProvinceId	String		Province Id
Zip	String		Postal or ZIP code.
Phone	String		Customer phone number.
Company	String		Optional company name.

Request Body

Example Request Body

 {
     "PendingOrderId": "68fa19046075a0c08d9a3817",
     "Address": {
         "Email": "[email protected]",
         "firstName": "Bakly",
         "lastName": "Kamal",
         "address1": "Hassan Sab",
         "address2": "Apt sB",
         "CityId": "306",
         "CountryId": "68c04f694b3cff720039559b",
         "ProvinceId": "68c05461309c2cff8025d4b8",
         "zip": "11511",
         "phone": "01027752277",
         "company":"Test Company"
     }
 }

cURL Example

curl --location 'https://partners.waffarx.com/api/ValuCheckout/updatecartaddress' \
     --header 'Content-Type: application/json' \
     --header 'Accept-Language: en' \
     --header 'wxc-id: {YOUR_CLIENT_ID}' \
     --header 'wxc-date: 2025-09-19T00:56:05Z' \
     --header 'wxc-auth: b4f3aab235faf27ee5f9ce2802dd974a3237f95422a0b14676f0644a2400a907' \
     --data-raw '{
       "PendingOrderId": "68ccbaf99656bcc4c7675cf9",
       "Address": {
             "Email": "[email protected]",
             "firstName": "Bakly",
             "lastName": "Kamal",
             "address1": "Hassan Sab",
             "address2": "Apt sB",
             "CityId": "306",
             "CountryId": "68c04f694b3cff720039559b",
             "ProvinceId": "68c05461309c2cff8025d4b8",
             "zip": "11511",
             "phone": "01027752277",
             "company":"Test Company"
           }
     }'

Responses

Success (HTTP 200)

Success Response Example

     {
       "code": null,
       "status": "Success",
       "data": {
           "pendingOrderId": "68fa19046075a0c08d9a3817",
           "addressAdded": true,
           "message": "Address added/updated successfully",
           "deliveryOptions": [
               {
                   "optionId": "68fa1a2d6075a0c08d9a381e",
                   "title": "Free Shipping",
                   "description": "Shipping takes 1-5 working days",
                   "price": 0,
                   "currency": "EGP"
               }
           ],
           "hasDeliveryOptions": true,
           "paymentSummary": {
               "totalPrice": 2792.43,
               "shippingFees": 0,
               "currency": null,
               "products": [
                   {
                       "name": "Sony Dual Sense Wireless Controller for PlayStation 5 | White",
                       "price": 2792.43,
                       "oldPrice": 5599,
                       "heroProduct": true
                   }
               ]
           }
       },
       "message": null,
       "errors": null
   }

Error (HTTP 4XX/5XX)

Error Response Example

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