{
  "info": {
    "_postman_id": "daf3-taas-escrow-api-collection-v2",
    "name": "DAF3 TaaS & Escrow API Platform (Official Postman Collection)",
    "description": "Comprehensive Postman Collection for the DAF3 Platform (Trust-as-a-Service, Escrow Milestones, Wallet Balances, Invoices, Real-time Chats, and Subscriptions).\n\n### Authentication\nAll `/api/*` endpoints are protected by `ApiAuthorizationMiddleware` which expects an `Authorization: Bearer <API_KEY>` header. Set the collection variable `api_key` to your active key generated from the Developer Portal (`/developer/dashboard`).",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "http://127.0.0.1:8000",
      "type": "string",
      "description": "Base URL of the DAF3 application (e.g., http://127.0.0.1:8000 or https://daf3.com)"
    },
    {
      "key": "api_key",
      "value": "daf3_live_test1234567890abcdef1234567890ab",
      "type": "string",
      "description": "Developer API Key passed in Authorization: Bearer <key>"
    },
    {
      "key": "user_id",
      "value": "1",
      "type": "string",
      "description": "Target user ID for tests"
    },
    {
      "key": "listing_id",
      "value": "1",
      "type": "string",
      "description": "Sample listing ID"
    },
    {
      "key": "milestone_id",
      "value": "1",
      "type": "string",
      "description": "Sample milestone ID"
    },
    {
      "key": "chat_id",
      "value": "1",
      "type": "string",
      "description": "Sample chat ID"
    },
    {
      "key": "invoice_id",
      "value": "1",
      "type": "string",
      "description": "Sample invoice ID"
    },
    {
      "key": "package_id",
      "value": "1",
      "type": "string",
      "description": "Sample package ID"
    }
  ],
  "item": [
    {
      "name": "1. Authentication & Profile Management",
      "description": "Endpoints for user registration, login, profile updates, password recovery, and account termination.",
      "item": [
        {
          "name": "Register User",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/register",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "register"
              ]
            },
            "description": "Create a new user account as either an individual or company buyer/seller.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Tariq Al-Harbi\",\n  \"email\": \"tariq.buyer@example.com\",\n  \"phone\": \"+966501112233\",\n  \"password\": \"Password@123\",\n  \"confirm_password\": \"Password@123\",\n  \"type\": \"individual\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "User Login",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/login",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "login"
              ]
            },
            "description": "Authenticate with email and password to receive full user and wallet profile.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"tariq.buyer@example.com\",\n  \"password\": \"Password@123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Social Login (Google)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/google-login",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "google-login"
              ]
            },
            "description": "Social OAuth login synchronization with verified email address.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"developer@daf3.com\",\n  \"type\": \"google\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Forgot Password (Send OTP)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/forget-password",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "forget-password"
              ]
            },
            "description": "Dispatch a 6-digit password reset OTP to the registered email address.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"tariq.buyer@example.com\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Update Password with User ID",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/update-password/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "update-password",
                "{id}"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Set a new password for the account.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"password\": \"NewSecretPassword@123\",\n  \"confirm_password\": \"NewSecretPassword@123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get User Profile Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-user/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-user",
                "{id}"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Fetch comprehensive user model including relations (countries, cities, transactions)."
          },
          "response": []
        },
        {
          "name": "Update User Profile",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/update-profile/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "update-profile",
                "{id}"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Update profile details, contact info, and custom invoice branding. Supports multipart/form-data for file uploads: `profile` (avatar image), `invoice_logo` (custom logo printed on generated invoices), and `remove_invoice_logo` (set to 1 to revert to default DAF03 logo).",
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "name",
                  "value": "Tariq Al-Harbi Updated",
                  "type": "text"
                },
                {
                  "key": "email",
                  "value": "tariq.buyer@example.com",
                  "type": "text"
                },
                {
                  "key": "phone",
                  "value": "+966509998877",
                  "type": "text"
                },
                {
                  "key": "type",
                  "value": "seller",
                  "type": "text"
                },
                {
                  "key": "invoice_logo",
                  "description": "Custom invoice logo image (PNG/JPG/WEBP, max 4MB). Printed across all invoices instead of default DAF03 logo.",
                  "type": "file",
                  "src": []
                },
                {
                  "key": "remove_invoice_logo",
                  "value": "0",
                  "description": "Set to 1 to remove custom invoice logo and revert to default DAF03 logo.",
                  "type": "text"
                }
              ]
            }
          },
          "response": []
        },
        {
          "name": "Delete Account",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/delete-account",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "delete-account"
              ]
            },
            "description": "Permanently deactivate and delete user account after password verification.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1,\n  \"password\": \"Password@123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "2. Geography & Platform Metadata",
      "description": "System lookup tables for supported countries, cities, and bank settlement configurations.",
      "item": [
        {
          "name": "Get Supported Countries",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-countries",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-countries"
              ]
            },
            "description": "List all active countries supported by Daf3 payment services."
          },
          "response": []
        },
        {
          "name": "Get Cities by Country ID",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-cities/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-cities",
                "{id}"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Retrieve list of cities for a selected country ID."
          },
          "response": []
        },
        {
          "name": "Get Platform Bank Accounts",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-bank-details",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-bank-details"
              ]
            },
            "description": "Retrieve official Daf3 escrow bank details for wire transfers and manual deposits."
          },
          "response": []
        }
      ]
    },
    {
      "name": "3. Listings & Escrow Products",
      "description": "Create, retrieve, complete, and cancel secure escrow transactions and product agreements.",
      "item": [
        {
          "name": "Create New Listing",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/create-listing/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "create-listing",
                "{id}"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Publish an escrow product listing or contract service offer.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"title\": \"Cloud Infrastructure Migration\",\n  \"description\": \"Full enterprise AWS/GCP cloud migration with secure Daf3 escrow release.\",\n  \"price\": 7500.0,\n  \"currency\": \"SAR\",\n  \"type\": \"service\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get User Listings",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-user-listing/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-user-listing",
                "{id}"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Fetch all active, completed, and pending listings created by user ID."
          },
          "response": []
        },
        {
          "name": "Get Buyer Listings",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/buyer/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "buyer",
                "{id}"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Retrieve buyer-specific contracted listings."
          },
          "response": []
        },
        {
          "name": "Get Seller Listings",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/seller/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "seller",
                "{id}"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Retrieve seller-specific published listings."
          },
          "response": []
        },
        {
          "name": "Accept Buyer Listing",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/acceptedBuyerListing",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "acceptedBuyerListing"
              ]
            },
            "description": "Accept buyer offer on an active escrow listing.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"listing_id\": 1,\n  \"buyer_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Mark Listing as Complete",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/listing/markAsComplete",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "listing",
                "markAsComplete"
              ]
            },
            "description": "Signal satisfactory contract fulfillment to begin final settlement.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"listing_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Cancel Listing",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/cancel-listing",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "cancel-listing"
              ]
            },
            "description": "Request contract cancellation and initiate refund review.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"listing_id\": 1,\n  \"reason\": \"Mutual agreement to cancel project before execution.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Share Listing Link",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/share-link",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "share-link"
              ]
            },
            "description": "Generate and email an encrypted shareable direct payment link to a buyer.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"listing_id\": 1,\n  \"receiver_email\": \"client@enterprise.sa\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "4. Milestones & Conditional Escrow",
      "description": "Manage phased escrow contracts, fund releases, partial disbursements, and milestone disputes.",
      "item": [
        {
          "name": "Create Escrow Milestone",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/milestone/store",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "milestone",
                "store"
              ]
            },
            "description": "Create and schedule a conditional milestone agreement linked to a listing.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"listing_id\": 1,\n  \"title\": \"Phase 1: Architecture Blueprint & API Specification\",\n  \"amount\": 2500.0,\n  \"currency\": \"SAR\",\n  \"description\": \"Payout released upon signing off architecture diagrams.\",\n  \"due_date\": \"2026-11-15\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get Buyer Milestones by Listing ID",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/buyer/milestones/{listing_id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "buyer",
                "milestones",
                "{listing_id}"
              ],
              "variable": [
                {
                  "key": "listing_id",
                  "value": "{{listing_id}}",
                  "description": "Value for listing_id"
                }
              ]
            },
            "description": "Fetch all milestone stages and payment progress for a given listing."
          },
          "response": []
        },
        {
          "name": "Seller Milestone Action / Status Update",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/milestone/{id}/status",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "milestone",
                "{id}",
                "status"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Seller action to accept, request release, or update progress on a milestone.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"status\": \"requested\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Release Full Milestone Payout",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/milestone/release",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "milestone",
                "release"
              ]
            },
            "description": "Authorize instant disbursement of escrow funds to seller's verified wallet.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"milestone_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Partial Release Milestone Funds",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/milestone/partial-release",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "milestone",
                "partial-release"
              ]
            },
            "description": "Release a specific partial portion of milestone escrow funds.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"milestone_id\": 1,\n  \"release_amount\": 1000.0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get Single Milestone Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/milestone/{milestone_id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "milestone",
                "{milestone_id}"
              ],
              "variable": [
                {
                  "key": "milestone_id",
                  "value": "{{milestone_id}}",
                  "description": "Value for milestone_id"
                }
              ]
            },
            "description": "Fetch detailed status, history, and funds held for milestone ID."
          },
          "response": []
        },
        {
          "name": "Cancel Milestone Agreement",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/milestones/cancel",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "milestones",
                "cancel"
              ]
            },
            "description": "Cancel an unreleased milestone agreement and return funds to buyer.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"milestone_id\": 1,\n  \"reason\": \"Scope adjusted by mutual client consent.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get All User Milestones",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-user-milestones",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-user-milestones"
              ]
            },
            "description": "List all milestones across all listings for a given user.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "5. Wallet, Deposits & Withdrawals",
      "description": "Manage user wallet balances, internal transfers, manual bank deposits, and cashouts.",
      "item": [
        {
          "name": "Get User Wallet & Recent Receipts",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/wallet-receipt/{user_id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "wallet-receipt",
                "{user_id}"
              ],
              "variable": [
                {
                  "key": "user_id",
                  "value": "{{user_id}}",
                  "description": "Value for user_id"
                }
              ]
            },
            "description": "Fetch real-time available wallet balance, escrow holds, and ledger receipts."
          },
          "response": []
        },
        {
          "name": "Wallet-to-Wallet Direct Transfer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/wallet-to-wallet-transfer",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "wallet-to-wallet-transfer"
              ]
            },
            "description": "Transfer funds instantly between two registered Daf3 platform wallets.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"sender_id\": 1,\n  \"receiver_email\": \"recipient@daf3.com\",\n  \"amount\": 500.0,\n  \"notes\": \"Consulting fee payment\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Register User Bank Details",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/bank-details",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "bank-details"
              ]
            },
            "description": "Store verified Saudi IBAN and beneficiary details for withdrawal payouts.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1,\n  \"bank_name\": \"Al Rajhi Bank\",\n  \"account_number\": \"SA6080000000000000000001\",\n  \"iban\": \"SA6080000000000000000001\",\n  \"account_holder\": \"Tariq Al-Harbi\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Update User Bank Account",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/user-wallet-update",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "user-wallet-update"
              ]
            },
            "description": "Update banking settlement credentials.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1,\n  \"bank_name\": \"Saudi National Bank (SNB)\",\n  \"iban\": \"SA4410000000000000000002\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get User Withdrawal History",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/withdraw/{user_id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "withdraw",
                "{user_id}"
              ],
              "variable": [
                {
                  "key": "user_id",
                  "value": "{{user_id}}",
                  "description": "Value for user_id"
                }
              ]
            },
            "description": "Retrieve history of payout withdrawal requests and settlement statuses."
          },
          "response": []
        },
        {
          "name": "Submit Withdrawal Request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/withdraw",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "withdraw"
              ]
            },
            "description": "Request payout disbursement from available wallet balance to linked bank account.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1,\n  \"amount\": 2500.0,\n  \"bank_name\": \"Al Rajhi Bank\",\n  \"account_number\": \"SA6080000000000000000001\",\n  \"iban\": \"SA6080000000000000000001\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Record Direct Deposit",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/deposit",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "deposit"
              ]
            },
            "description": "Record a wallet deposit transaction.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1,\n  \"amount\": 5000.0,\n  \"payment_method\": \"mada\",\n  \"transaction_ref\": \"TXN_MADA_987654321\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get Manual Top-up Requests",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-manual-top-ups",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-manual-top-ups"
              ]
            },
            "description": "List pending and approved wire transfer receipts submitted for verification.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Submit Manual Top-up Deposit Proof",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/store-manual-top-up",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "store-manual-top-up"
              ]
            },
            "description": "Submit bank transfer slip for manual wallet replenishment.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1,\n  \"amount\": 10000.0,\n  \"bank_name\": \"Alinma Bank\",\n  \"reference_no\": \"WIRE-20261019-994\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "6. Transactions & Financial Ledger",
      "description": "Double-entry accounting transaction records, debit/credit audit trail.",
      "item": [
        {
          "name": "Get User Financial Transactions",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/transactions/{user_id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "transactions",
                "{user_id}"
              ],
              "variable": [
                {
                  "key": "user_id",
                  "value": "{{user_id}}",
                  "description": "Value for user_id"
                }
              ]
            },
            "description": "Fetch chronological ledger entries including escrow holds, releases, deposits, and service fees."
          },
          "response": []
        }
      ]
    },
    {
      "name": "7. Invoices & Billing",
      "description": "Generate commercial invoices, payment tracking, and automated PDF/Excel exports.",
      "item": [
        {
          "name": "Create Seller Commercial Invoice",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/store-invoice",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "store-invoice"
              ]
            },
            "description": "Generate a formal commercial invoice with itemized line items.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"seller_id\": 1,\n  \"buyer_email\": \"client@enterprise.sa\",\n  \"amount\": 4200.0,\n  \"currency\": \"SAR\",\n  \"description\": \"Dedicated Cloud Hosting & Support Q4 2026\",\n  \"due_date\": \"2026-11-30\",\n  \"items\": [\n    {\n      \"description\": \"DevOps Setup\",\n      \"qty\": 1,\n      \"rate\": 2200.0\n    },\n    {\n      \"description\": \"Managed Maintenance\",\n      \"qty\": 2,\n      \"rate\": 1000.0\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get User Invoices",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-invoices",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-invoices"
              ]
            },
            "description": "Retrieve list of paid, unpaid, and draft invoices for a user.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1,\n  \"status\": \"all\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get Single Invoice Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/invoice/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "invoice",
                "{id}"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Fetch complete invoice schema, tax breakdown, and status."
          },
          "response": []
        },
        {
          "name": "Delete Invoice",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/delete/{id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "delete",
                "{id}"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{id}}",
                  "description": "Value for id"
                }
              ]
            },
            "description": "Delete a draft or cancelled invoice by ID."
          },
          "response": []
        },
        {
          "name": "Export Invoices to Excel",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/export-invoices-excel",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "export-invoices-excel"
              ]
            },
            "description": "Download spreadsheet containing full billing and invoice history.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Export Invoices to PDF",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/export-invoices-pdf",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "export-invoices-pdf"
              ]
            },
            "description": "Compile and render official PDF tax invoice statements.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Export Milestones to Excel",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/export-milestones-excel",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "export-milestones-excel"
              ]
            },
            "description": "Download Excel report of milestone settlements.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Export Milestones to PDF",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/export-milestones-pdf",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "export-milestones-pdf"
              ]
            },
            "description": "Download PDF report of milestone escrow agreements.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "8. Payment Gateway Integrations (HyperPay)",
      "description": "Hosted checkout and status polling for Mada, Visa, Mastercard, and Apple Pay.",
      "item": [
        {
          "name": "Initiate HyperPay Payment Session",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/payment/hyperpay",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "payment",
                "hyperpay"
              ]
            },
            "description": "Prepare checkoutId for secure HyperPay card payment widget.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1,\n  \"amount\": 1500.0,\n  \"currency\": \"SAR\",\n  \"entity_id\": \"8a8294174d0595bb014d05d829e701d1\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Check HyperPay Settlement Status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/payment/hyperpay/status/{checkoutId}/{user_id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "payment",
                "hyperpay",
                "status",
                "{checkoutId}",
                "{user_id}"
              ],
              "variable": [
                {
                  "key": "checkoutId",
                  "value": "{{checkoutId}}",
                  "description": "Value for checkoutId"
                },
                {
                  "key": "user_id",
                  "value": "{{user_id}}",
                  "description": "Value for user_id"
                }
              ]
            },
            "description": "Verify settlement outcome and update user wallet/milestone upon capture."
          },
          "response": []
        }
      ]
    },
    {
      "name": "9. Real-Time Chat & Notifications",
      "description": "In-app peer-to-peer messaging between escrow counterparties and notification counters.",
      "item": [
        {
          "name": "Fetch Messages by User ID",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/chats/{user_id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "chats",
                "{user_id}"
              ],
              "variable": [
                {
                  "key": "user_id",
                  "value": "{{user_id}}",
                  "description": "Value for user_id"
                }
              ]
            },
            "description": "Retrieve active chat threads and conversations for user ID."
          },
          "response": []
        },
        {
          "name": "Fetch Messages by Chat ID",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/chats/{chat_id}/messages",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "chats",
                "{chat_id}",
                "messages"
              ],
              "variable": [
                {
                  "key": "chat_id",
                  "value": "{{chat_id}}",
                  "description": "Value for chat_id"
                }
              ]
            },
            "description": "Retrieve chronological message history for a specific chat room."
          },
          "response": []
        },
        {
          "name": "Open Chat for Listing",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/chat-listing",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "chat-listing"
              ]
            },
            "description": "Establish or fetch chat session linked to an escrow listing.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"listing_id\": 1,\n  \"sender_id\": 1,\n  \"receiver_id\": 2\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Send Chat Message",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/send-message",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "send-message"
              ]
            },
            "description": "Dispatch text message or file attachment into chat room.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chat_id\": 1,\n  \"sender_id\": 1,\n  \"receiver_id\": 2,\n  \"message\": \"Hello! I have completed Milestone 1 deliverable, please inspect.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Mark Chat Message as Seen",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/seen-message",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "seen-message"
              ]
            },
            "description": "Update read receipt for incoming chat messages.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chat_id\": 1,\n  \"user_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Mark General Notification as Seen",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/seen-general-message",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "seen-general-message"
              ]
            },
            "description": "Acknowledge system broadcast notification.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"notification_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Update Chat Notification",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/update-notification",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "update-notification"
              ]
            },
            "description": "Clear pending chat alerts.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chat_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Update General Notification",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/general-update-notification",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "general-update-notification"
              ]
            },
            "description": "Clear general platform notification badge.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"notification_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Enter Chat Room",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/enter-chat",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "enter-chat"
              ]
            },
            "description": "Signal online presence in conversation.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chat_id\": 1,\n  \"user_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Leave Chat Room",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/leave-chat",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "leave-chat"
              ]
            },
            "description": "Signal departure from conversation room.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chat_id\": 1,\n  \"user_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get Chat Unread Notification Count",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/notifications/latest-count",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "notifications",
                "latest-count"
              ]
            },
            "description": "Fetch badge counter for unread direct messages."
          },
          "response": []
        },
        {
          "name": "Get General Notification Count",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/notifications/general-latest-count",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "notifications",
                "general-latest-count"
              ]
            },
            "description": "Fetch badge counter for system notifications."
          },
          "response": []
        }
      ]
    },
    {
      "name": "10. Packages & Subscriptions",
      "description": "Tiered enterprise subscription plans, quota limits, and multi-user package assignments.",
      "item": [
        {
          "name": "Get All Packages",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-packages",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-packages"
              ]
            },
            "description": "Retrieve list of available membership packages, feature tiers, and pricing."
          },
          "response": []
        },
        {
          "name": "Subscribe to Package",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/subscribe-package",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "subscribe-package"
              ]
            },
            "description": "Activate package subscription for user account.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1,\n  \"package_id\": 1,\n  \"payment_type\": \"wallet\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get User Current Active Package",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-user-current-package",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-user-current-package"
              ]
            },
            "description": "Inspect user active subscription tier, limits, and expiry.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Update Subscription Value",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/update-subscription-value",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "update-subscription-value"
              ]
            },
            "description": "Administrative override for subscription status or quota adjustments.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"subscription_id\": 1,\n  \"status\": \"active\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get Package Listings",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-package-listings",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-package-listings"
              ]
            },
            "description": "Fetch listing templates tied to package tier.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"package_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Create Package Listings",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/create-package-listings",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "create-package-listings"
              ]
            },
            "description": "Configure bundled listings under package plan.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"package_id\": 1,\n  \"listing_title\": \"Enterprise TaaS Bundle\",\n  \"description\": \"Unlimited milestone escrows up to 500,000 SAR\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get Package Details",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-package-details",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-package-details"
              ]
            },
            "description": "Inspect single package configuration schema.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"package_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Create Package Milestones",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/create-package-milestones",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "create-package-milestones"
              ]
            },
            "description": "Attach milestone templates to package plan.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"package_id\": 1,\n  \"title\": \"Onboarding & Integration\",\n  \"amount\": 1000.0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get Users Assigned to Package",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-users-for-package",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-users-for-package"
              ]
            },
            "description": "Fetch list of team accounts enrolled under active package."
          },
          "response": []
        },
        {
          "name": "Add User to Package Seat",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/add-users-to-package",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "add-users-to-package"
              ]
            },
            "description": "Assign seat license to additional team member.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"package_id\": 1,\n  \"user_id\": 2\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get Milestone Users",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/get-milestone-users",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "get-milestone-users"
              ]
            },
            "description": "Fetch assigned collaborators for package milestone.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"milestone_id\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Release Package Milestone for User",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/release-milestone-for-user",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "release-milestone-for-user"
              ]
            },
            "description": "Disburse package milestone payout to designated user seat.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"milestone_id\": 1,\n  \"user_id\": 2\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "11. Desktop License Validation",
      "description": "Hardware-fingerprinted license validation for Daf3 desktop/POS software clients.",
      "item": [
        {
          "name": "Validate Desktop License Key",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/validate-license-key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "validate-license-key"
              ]
            },
            "description": "Verify software license key against registered device hardware ID.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"license_key\": \"DAF3-POS-8899-X91A-2026\",\n  \"device_id\": \"HW-9988-7766-5544\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "12. Customer Support & Contact",
      "description": "Inquiries, incident reporting, and developer support ticket submission.",
      "item": [
        {
          "name": "Submit Contact / Support Message",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/contact",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "contact"
              ]
            },
            "description": "Dispatch customer support request to admin desk.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Abdullah Developer\",\n  \"email\": \"abdullah.dev@tech.sa\",\n  \"phone\": \"+966503334444\",\n  \"subject\": \"Webhook integration inquiry\",\n  \"message\": \"Testing webhook listener endpoint response times.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "13. Developer Portal & Keys Management",
      "description": "Developer self-service API credentials, webhooks, and OTP verification endpoints.",
      "item": [
        {
          "name": "Developer Sign In Check",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/developer/login-check",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "developer",
                "login-check"
              ]
            },
            "description": "Authenticate developer account to receive console session.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"test_dev_auto@daf3.com\",\n  \"password\": \"password123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Developer Sign Up Store",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/developer/signup-store",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "developer",
                "signup-store"
              ]
            },
            "description": "Register developer credentials and trigger 6-digit OTP email.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Nawaf Al-Mutairi\",\n  \"company_name\": \"Saudi Fintech Labs\",\n  \"email\": \"nawaf@fintech.sa\",\n  \"phone_number\": \"+966504445555\",\n  \"password\": \"Password@123\",\n  \"confirm_password\": \"Password@123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Verify Developer 6-Digit Code",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/developer/verify-code",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "developer",
                "verify-code"
              ]
            },
            "description": "Validate 6-digit email confirmation code to activate developer status.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"code\": \"123456\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Resend 6-Digit Verification Code",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/developer/resend-code",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "developer",
                "resend-code"
              ]
            },
            "description": "Request a fresh 6-digit code dispatch to registered email address."
          },
          "response": []
        },
        {
          "name": "Regenerate Developer API Credentials",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/developer/regenerate-keys",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "developer",
                "regenerate-keys"
              ]
            },
            "description": "Roll and regenerate live client public key and secret token."
          },
          "response": []
        },
        {
          "name": "Update Developer Webhook Endpoint",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/developer/update-webhook",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "developer",
                "update-webhook"
              ]
            },
            "description": "Set public HTTPS endpoint for receiving real-time asynchronous event payloads.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"webhook_url\": \"https://api.yourdomain.com/daf3/webhook\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Download Complete API Documentation PDF",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/developer/download-pdf",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "developer",
                "download-pdf"
              ]
            },
            "description": "Download the complete 74-endpoint PDF manual."
          },
          "response": []
        }
      ]
    }
  ]
}