Developer docs

Get delivery rates

POST /delivery/rates — quote Terminal.africa carrier rates for a managed-delivery escrow.

HTTP

POST https://www.harrenapay.com/api/public/v1/delivery/rates

Use when delivery_mode on initiate is managed. Returns rates plus address/parcel ids you pass to attach.

Body

Field	Type	Notes
pickup	object	name, phone, line1, city, state (+ optional phone2, landmark).
dropoff	object	Same shape as pickup.
parcel	object	description, weight_kg, value_naira; optional length_cm, breadth_cm, height_cm.

cURL

curl -X POST https://www.harrenapay.com/api/public/v1/delivery/rates \
  -H "Authorization: Bearer hpay_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup": {
      "name": "Ada Store",
      "phone": "08012345678",
      "line1": "12 Marina",
      "city": "Lagos",
      "state": "Lagos"
    },
    "dropoff": {
      "name": "Buyer",
      "phone": "08087654321",
      "line1": "4 Admiralty Way",
      "city": "Lekki",
      "state": "Lagos"
    },
    "parcel": {
      "description": "Sneakers",
      "weight_kg": 1.2,
      "value_naira": 25000
    }
  }'

200 response

JSON

{
  "rates": [/* carrier options from Terminal */],
  "pickup_address_id": "…",
  "delivery_address_id": "…",
  "parcel_id": "…"
}

Next: Attach a rate to your escrow reference.