As An End Customer, I Want To Place An Order
User Story: As an End Customer, I want to place an order for products on the marketplace, so that I can receive my purchased items conveniently and securely.
This feature is vital for enabling seamless transactions, integrating with merchant-preferred payment providers, and ensuring a smooth checkout experience. The platform’s 5% commission is deducted from the merchant’s prepaid wallet.
Acceptance Criteria
Adding Products to Cart and Checkout
- I can add products to a shopping cart, view the cart, and edit quantities or remove items.
- I can proceed to checkout, entering shipping address and contact details in Arabic or English.
- I can select a payment method integrated by the merchant (e.g., Paymob, Fawry), with secure redirection to the payment gateway.
- I can choose a shipping option (e.g., standard, express) provided by the merchant’s logistics partner, with estimated delivery dates.
Order Confirmation and Payment
- The system calculates the total cost (products + shipping) in EGP, excluding the platform’s 5% commission (deducted from the merchant’s prepaid wallet).
- I receive an order confirmation via email and in-app, detailing products, total cost, shipping details, and estimated delivery.
- If a payment fails, the system displays a clear error message and allows retrying or selecting another method.
Checkout Experience and Security
- The checkout process completes in under 2 minutes and supports Arabic and English, with RTL alignment for Arabic.
- The system prevents duplicate orders if I accidentally submit twice.
- If the merchant’s wallet balance is insufficient for the commission, the system notifies the merchant to top up before processing the order.
Notes
- Assumptions: Customers have access to payment methods supported by merchants; shipping options vary by merchant.
- Constraints: Payment integrations depend on third-party APIs (e.g., Paymob, Aramex); commission deductions require a functional prepaid wallet system.
- Suggestions: Future releases could include saved payment methods or guest checkout.
- Reference: See Functional-Requirements in the Wiki for payment and shipping details.
Arabic Version
قصة المستخدم: كعميل نهائي، أريد تقديم طلب للمنتجات على السوق، حتى أتمكن من استلام العناصر التي اشتريتها بسهولة وأمان.
هذه الميزة حيوية لتمكين المعاملات السلسة، التكامل مع مزودي الدفع المفضلين للتاجر، وضمان تجربة دفع سلسة. يتم خصم عمولة المنصة 5% من محفظة التاجر مسبقة الدفع.
Acceptance Criteria (Arabic)
إضافة المنتجات إلى عربة التسوق و الدفع
- يمكنني إضافة المنتجات إلى عربة التسوق، عرض العربة، وتعديل الكميات أو إزالة العناصر.
- يمكنني المتابعة إلى الدفع، مع إدخال عنوان الشحن وتفاصيل الاتصال بالعربية أو الإنجليزية.
- يمكنني اختيار طريقة دفع مدمجة من التاجر (مثل Paymob، Fawry)، مع إعادة توجيه آمن بوابة الدفع.
- يمكنني اختيار خيار شحن (مثل قياسي، سريع) مقدم من شريك اللوجستيات، مع تواريخ التوصيل المتوقعة.
تأكيد الطلب و الدفع
- يحسب النظام التكلفة الإجمالية (المنتجات + الشحن) بالجنيه المصري، باستثناء عمولة المنصة 5% (تُخصم من محفظة التاجر مسبقة الدفع).
- أتلقى تأكيد طلب عبر البريد الإلكتروني وداخل التطبيق، يتضمن المنتجات، التكلفة الإجمالية، تفاصيل الشحن، والتوصيل المتوقع.
- إذا فشلت عملية الدفع، يعرض النظام رسالة خطأ واضحة ويسمح بإعادة المحاولة أو اختيار طريقة أخرى.
تجربة الدفع و الأمان
- تكتمل عملية الدفع في أقل من دقيقتين وتدعم العربية والإنجليزية، مع محاذاة من اليمين إلى اليسار للعربية.
- يمنع النظام الطلبات المكررة إذا قمت بالإرسال مرتين عن طريق الخطأ.
- إذا كان رصيد محفظة التاجر غير كافٍ للعمولة، يخطر النظام التاجر لإعادة التعبئة قبل معالجة الطلب.
ملاحظات (Arabic)
- الافتراضات: العملاء لديهم إمكانية الوصول إلى طرق الدفع التي يدعمها التجار؛ خيارات الشحن تختلف حسب التاجر.
- القيود: تكامل الدفع يعتمد على واجهات برمجية خارجية (مثل Paymob، Aramex)؛ خصم العمولة يتطلب نظام محفظة مسبقة الدفع وظيفي.
- اقتراحات: الإصدارات المستقبلية يمكن أن تتضمن طرق دفع محفوظة أو دفع كضيف.
- المرجع: انظر Functional-Requirements في الـ Wiki لتفاصيل الدفع والشحن.
Frequently Asked Questions
As an end customer, you may have questions about placing an order on our marketplace. Below are some frequently asked questions and answers to help you understand the process.
Q: How do I add products to my cart?
A: To add products to your cart, simply click on the "Add to Cart" button on the product page. You can also add multiple products to your cart by clicking on the "Add to Cart" button for each product.
Q: Can I edit the quantities of products in my cart?
A: Yes, you can edit the quantities of products in your cart by clicking on the "Edit" button next to each product. You can then enter the new quantity you want to purchase.
Q: Can I remove products from my cart?
A: Yes, you can remove products from your cart by clicking on the "Remove" button next to each product.
Q: How do I proceed to checkout?
A: To proceed to checkout, click on the "Checkout" button on the cart page. You will then be prompted to enter your shipping address and contact details.
Q: Can I select a payment method during checkout?
A: Yes, you can select a payment method during checkout. We offer a variety of payment options, including credit cards, debit cards, and online payment methods.
Q: Can I choose a shipping option during checkout?
A: Yes, you can choose a shipping option during checkout. We offer a variety of shipping options, including standard, express, and expedited shipping.
Q: How do I know if my payment has been successful?
A: If your payment has been successful, you will receive an order confirmation email and in-app notification. You will also be able to see the status of your order on the order page.
Q: What if my payment fails?
A: If your payment fails, you will receive an error message and be prompted to try again or select a different payment method.
Q: Can I save my payment method for future use?
A: Yes, you can save your payment method for future use. Simply click on the "Save Payment Method" button during checkout.
Q: Can I use a guest checkout option?
A: Yes, you can use a guest checkout option. Simply click on the "Guest Checkout" button during checkout.
Q: How do I track my order?
A: You can track your order by logging into your account and viewing the order page. You can also receive updates on the status of your order via email and in-app notification.
Q: What if I need to cancel or change my order?
A: If you need to cancel or change your order, please contact our customer support team as soon as possible. We will do our best to accommodate your request.
Q: How do I contact customer support?
A: You can contact our customer support team by email, phone, or through our in-app support chat.
Q: What are the payment and shipping options available?
A: We offer a variety of payment and shipping options, including credit cards, debit cards, online payment methods, standard, express, and expedited shipping.
Q: How do I know if my order has been delivered?
A: You will receive an email and in-app notification when your order has been delivered. You can also track your order by logging into your account and viewing the order page.
Q: What if I receive a damaged or incorrect item?
A: If you receive a damaged or incorrect item, please contact our customer support team as soon as possible. We will do our best to resolve the issue and provide a replacement or refund.
Q: How do I return or exchange an item?
A: If you need to return or exchange an item, please contact our customer support team as soon as possible. We will provide you with a return or exchange form and instructions on how to proceed.
Q: What is the return and exchange policy?
A: Our return and exchange policy is as follows: [insert policy details].
Q: How do I get a refund?
A: If you are eligible for a refund, you will receive a refund to your original payment method. Please contact our customer support team to initiate the refund process.
Q: What if I have a question or concern about my order?
A: If you have a question or concern about your order, please contact our customer support team. We will do our best to resolve the issue and provide a solution.