Skip to main content

External API Integrations

Configured External APIs

1. Agent Management System

Purpose: Manage agent locations and configurations

Configuration:

  • Base URL: API_URL_AGENT_ONAGENT
  • Authentication: JWT token
  • Usage: Agent CRUD operations

2. User State Management

Purpose: Track user session and state

Configuration:

  • Base URL: API_URL_USERSTATE
  • Authentication: JWT token
  • Usage: User activity tracking

3. User OnDelivery System

Purpose: User profile management

Configuration:

  • Base URL: API_URL_USERONDELIV
  • Authentication: JWT token
  • Usage: User profile operations

4. Sunshine Location Service

Purpose: Location and area data

Configuration:

  • Base URL: API_URL_SUNSHINE
  • Authentication: API key
  • Usage: Location lookup, province/city data

5. APISAT

Purpose: Satellite tracking (purpose unclear from code)

Configuration:

  • Base URL: API_URL_APISAT and APISAT_LINK
  • Authentication: API key
  • Usage: External tracking integration

6. EatSOK

Purpose: Food delivery partner integration

Configuration:

  • Base URL: API_EATSOK
  • Authentication: Basic Auth
    • API Key: EATSOK_API_KEY
    • Secret: EATSOK_SECRET_KEY_ONDEL
  • Special Features:
    • Separate image directories
    • Custom scanning workflow

7. Xendit Payment Gateway

Purpose: Payment processing and payouts

Features:

  • Payment collection
  • Payout disbursement
  • Transaction tracking

Models:

  • xendit_payment - Payment records
  • xendit_payout - Payout records

8. Blibli Marketplace

Purpose: E-commerce integration

Configuration:

  • Webhook Key: BLIBLI_WEBHOOK_KEY
  • Authentication: Webhook signature validation
  • Features: Order notifications, fulfillment

9. OnMarket Platform

Purpose: Marketplace platform integration

Configuration:

  • Webhook Key: ONMARKET_WEBHOOK_KEY
  • Authentication: Webhook signature validation
  • Features: Multi-marketplace aggregation

API Utility Modules

Location: app/config/api.js

Purpose: Centralized API endpoint configuration

Usage:

const api = require('./config/api');

// Make external API call
const response = await axios.get(api.AGENT_SYSTEM + '/agents');

Webhook Handling

Incoming Webhooks:

  1. Courier Partner Webhooks

    • Endpoint: /api/3p/{partner}/webhook
    • Authentication: Basic Auth or API Key
    • Purpose: Status updates from couriers

  2. Marketplace Webhooks

    • Endpoint: /api/marketplace/webhook
    • Authentication: Webhook signature
    • Purpose: New order notifications

Outgoing Webhooks:

Utility: app/utility/web-hook.js

Purpose: Notify external systems of status changes

Configuration:

  • Configured per partner/customer
  • Triggered on status updates
  • Includes retry logic

Example:

// Trigger webhook on status change
await triggerWebhook({
  awb: "ONX1234567890",
  status: "DELIVERED",
  timestamp: new Date(),
  location: "Jakarta"
});
Back to top