Delivery Partner Integration Guide for E-commerce Platforms

This guide explains how to register and integrate delivery services from Pathao, Upaya, and Nepal Can Move (NCM) into your e-commerce platform. It covers merchant registration, obtaining API access, and setting up webhooks for real-time delivery status updates.

---

1. Pathao Merchant Integration

Overview
Pathao is a leading delivery and logistics provider in Nepal. Registering as a Pathao merchant enables your e-commerce business to connect with their delivery network and automate order placement and tracking through their APIs.

Registration Steps

• Visit the Pathao Merchant registration site: https://merchant.pathao.com and click Register.
• Fill out the registration form with your business and owner details, including business name, address, contact information, and business type.
• Upload required documents such as your business registration certificate, VAT/PAN certificate (if applicable), and a government-issued ID of the owner.
• Submit the application and wait for verification. Once approved, log in to your merchant panel at https://merchant.pathao.com.

API and Webhook Setup

• In your merchant panel, navigate to the Developer API section to request your API key and secret.
• Use these credentials to connect your e-commerce platform with Pathao’s API for automatically placing and tracking delivery orders.
• To receive real-time delivery updates (e.g., order picked up, in transit, delivered), register your e-commerce system’s webhook URL in the API settings. Pathao will send automated notifications to this URL.

---

2. Upaya Delivery Service Integration

Overview
Upaya provides delivery, warehousing, and inventory management services with API support, enabling your e-commerce platform to automate order placement and delivery tracking.

Registration and Partnership

• Visit Upaya’s official website and contact their sales or support team.
• Discuss your business needs, such as expected order volume, delivery zones, and any special requirements (e.g., Cash on Delivery, scheduling).
• Finalize the partnership terms and complete the agreement to get onboarded.

API Integration Steps

• After onboarding, Upaya will provide you with API credentials (such as an API key and secret) and documentation.
• Use the API credentials to connect your e-commerce platform with Upaya’s delivery API. Implement API calls to automatically place delivery orders when customers complete checkout and retrieve delivery status updates.
• Ensure you handle API errors and validate responses to ensure a smooth operation.

Webhook Setup for Real-Time Updates

• Upaya supports webhooks, which are automatic HTTP POST notifications sent to your system when delivery events occur.
• To receive these, provide Upaya with your e-commerce platform’s webhook URL. Your platform should implement a webhook listener endpoint that accepts and validates these requests and updates your order status in real time.

---

3. Nepal Can Move (NCM) Delivery Integration

Overview
Nepal Can Move (NCM) is a nationwide courier and logistics provider offering customizable delivery services. Their system supports API and webhook integration for streamlined order management.

Registration and Partnership

• Visit NCM’s website and contact their customer support or an assigned relationship manager.
• Share your business details and discuss your average order volume, delivery zones, and special requirements (e.g., Cash on Delivery).
• Negotiate terms and sign a partnership contract to gain access to their services.

API Integration Steps

• Upon approval, NCM will provide API credentials and documentation.
• Use the provided API credentials to connect your e-commerce platform with NCM’s API. Automate order creation and the retrieval of delivery status updates.
• Ensure robust error handling and data validation for a smooth integration.

Webhook Integration for Delivery Status Updates

• NCM sends delivery status updates via webhook POST requests to notify your platform in real time.
• Create a webhook URL endpoint on your platform to receive and validate incoming notifications. This allows you to automatically update order statuses and notify your customers about their delivery progress.