Get started in 5 minutes

1. Generate an API key

In the Lojou dashboard: Settings → API → New API Key. Pick the scopes you need (e.g. orders.read, products.write) and copy the key — it’s only shown once.

Building an app for OTHER sellers to install (not just your own store)? Use OAuth instead of a fixed API key.

2. Test the connection

curl https://api.lojou.app/v1/ping

{ "status": "success", "message": "pong" }

This endpoint doesn’t require authentication — it’s just to confirm the API is up.

3. Confirm who you are

curl https://api.lojou.app/v1/user \
  -H "Authorization: Bearer YOUR_API_KEY"

A 401 means the key is wrong or expired. A 403 means the key exists but doesn’t have the user.read scope — see Authentication.

4. List your products

curl https://api.lojou.app/v1/products \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "status": "success",
  "page": 1,
  "per_page": 20,
  "last_page": 1,
  "total": 3,
  "data": [ ]
}

5. Create an order

Every order needs amount, product_pid, and customer:

curl -X POST https://api.lojou.app/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500,
    "product_pid": "PROD-ABC123",
    "customer": {
      "name": "Jane Doe",
      "email": "[email protected]",
      "mobile_number": "+258840000000"
    }
  }'

The response includes a checkout_url — send that link to your customer to complete payment.

Next steps

Receive events in real time by setting up a webhook (POST /v1/webhooks) instead of polling the order.
Building an app for other sellers? See the OAuth guide.

​1. Generate an API key

​2. Test the connection

​3. Confirm who you are

​4. List your products

​5. Create an order

​Next steps

1. Generate an API key

2. Test the connection

3. Confirm who you are

4. List your products

5. Create an order

Next steps