Place Order

Order medications from any pharmacy in the Famasi network. Choose delivery or pickup, pay securely, and track your order in real-time.

Create Order

Place an order for medications at a specific pharmacy.

# Place an order for 2 packs of Amoxicillin
place_order({
  pharmacyId: "PH-456",
  medicationId: "MED-123",
  quantity: 2,
  deliveryType: "delivery",
  address: {
    street: "12 Admiralty Way",
    city: "Lekki",
    state: "Lagos"
  },
  notes: "Call when you arrive"
})

Parameters:

Parameter	Type	Required	Description
`pharmacyId`	string	Yes	Pharmacy ID from search
`medicationId`	string	Yes	Medication ID
`quantity`	number	Yes	Number of units to order
`deliveryType`	string	Yes	`"delivery"` or `"pickup"`
`address`	object	No	Required for delivery
`address.street`	string	No	Street address
`address.city`	string	No	City
`address.state`	string	No	State
`notes`	string	No	Special instructions

Response:

{
  "success": true,
  "orderId": "ORD-789",
  "status": "pending_payment",
  "total": 5000,
  "currency": "NGN",
  "items": [
    {
      "medicationId": "MED-123",
      "name": "Amoxicillin 500mg",
      "quantity": 2,
      "price": 2500,
      "total": 5000
    }
  ],
  "pharmacy": {
    "id": "PH-456",
    "name": "GreenCross Pharmacy",
    "phone": "+2348012345678"
  },
  "delivery": {
    "type": "delivery",
    "fee": 500,
    "eta": "30-45 minutes"
  },
  "checkoutUrl": "https://pay.famasi.ai/checkout/ORD-789"
}

Get Checkout Link

Get a secure payment link to complete the order.

# Get payment checkout link
get_checkout_link({
  orderId: "ORD-789"
})

Parameters:

Parameter	Type	Required	Description
`orderId`	string	Yes	Order ID from place_order response

Response:

{
  "checkoutUrl": "https://pay.famasi.ai/checkout/ORD-789",
  "expiresAt": "2026-04-19T12:00:00Z"
}

Payment Methods

The checkout supports multiple payment options:

Card — Visa, Mastercard, Verve
Bank Transfer — Direct bank transfer
USSD — Mobile banking codes
Wallet — Famasi wallet balance

Order States

Status	Description
`pending_payment`	Awaiting payment
`payment_received`	Payment confirmed
`processing`	Pharmacy preparing order
`ready_for_pickup`	Ready for collection
`out_for_delivery`	With delivery partner
`completed`	Delivered/picked up
`cancelled`	Order cancelled

Example: Complete Order Flow

# Step 1: Place the order
place_order({
  pharmacyId: "PH-456",
  medicationId: "MED-123",
  quantity: 2,
  deliveryType: "delivery",
  address: {
    street: "12 Admiralty Way",
    city: "Lekki",
    state: "Lagos"
  }
})
# → Returns orderId: "ORD-789"

# Step 2: Get checkout link
get_checkout_link({ orderId: "ORD-789" })
# → Returns payment URL

# Step 3: Complete payment on checkout page
# (User pays via card, transfer, or USSD)

# Step 4: Track order
# Use check_order_status or get_order_history

Bulk Orders

Order multiple medications at once:

place_order({
  pharmacyId: "PH-456",
  items: [
    { medicationId: "MED-123", quantity: 2 },
    { medicationId: "MED-124", quantity: 1 }
  ],
  deliveryType: "pickup"
})

Next steps

Track Order — Monitor your order status
Request Refill — Reorder quickly
Search Medications — Find more medications