Complete Order¶

Creates a new order record for a user, linking it to a store, transaction, and loan details.

Endpoint¶

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

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	Description
storeId	String	Identifier of the store from which the order is being placed.
userId	String	Unique identifier of the user placing the order.
transactionId	String	A unique ID representing the payment transaction.
pendingOrderId	String	The identifier for the pending order created earlier in the checkout flow.
loanId	String	Loan or financing identifier if applicable.
partnerStoreID	String	Additional optional reference field.
productID	String	Additional optional reference field.
vendorID	String	Additional optional reference field.

Request Body¶

Example Request Body¶

 {
   "pendingOrderId":"68d09299be28061e42fc920e",
   "transactionId":"transactionId",
   "loanId":"loanId",
   "userId":"12355",
   "storeId":"61a535ad-bf20-4d71-8846-413ebe8bb8ff",
   "vendorID":"id1",
   "productId":"id2",
   "partnerstoreId":"id3"
 }

cURL Example¶

curl --location 'https://partners.waffarx.com/api/ValuCheckout/CompleteOrder' \
     --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 '{"pendingOrderId":"68d09299be28061e42fc920e","transactionId":"transactionId","loanId":"12355","userId":"string","storeId":"61a535ad-bf20-4d71-8846-413ebe8bb8ff","partnerStoreID":"id1","productID":"id2","vendorID":"id3"}'

Responses¶

Success (HTTP 200)¶

Success Response Example¶

   {
     "status": "Success",
     "data": {
         "orderId": "#1227", /* ← Id to be shown to the user in UI */
         "confirmedOrderId": "68d527a17a64b9f3652e6bbb", /* ← Id to be used as order identifier in API requests */
         "merchent": {
             "name": null,
             "hotline": ""
         },
         "products": [
             {
                 "name": "Iphone 17 Pro Max",
                 "brand": "WAFFARX Test",
                 "logoUrl": "https://cdn.shopify.com/s/files/1/0550/1734/1113/files/iphone-17-lineup-STORY-BANNER-850x500.png?v=1757969431",
                 "storeName": null
             }
         ]
     },
     "message": null,
     "errors": null
   }

Error (HTTP 4XX/5XX)¶

Error Response Example¶

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