# Kili documentation > How the Kili dashboards work, for everybody who uses one: agents, resellers, corporate accounts, creators and Kili staff. This document contains the full content of all documentation pages for AI consumption. --- ## Approving a partner **URL:** https://docs.usekili.com/docs/approving-partners **Description:** What approval creates, and the one decision that matters. **Audience:** staff ## The decision An application arrives with what the applicant told us: who they are, where, how many travellers a month, how they sell. The decision is which type of partner they should be, because that decides everything afterwards. An audience rather than a counter usually means Creator. A business that wants to hold stock and price it means Agent. A company buying for its own staff means Corporate. Everything else is usually a Reseller. ## What approval does - Creates the organisation with the capabilities its type starts with. - Creates their first referral code. - Creates a draft storefront. - Emails the applicant a sign-in link — there is no password to pass on. **Note:** The capabilities are a starting point. The Access tab on a partner adds or removes individual tools afterwards, and says how this partner differs from the preset for their type. --- ## Earnings and withdrawals **URL:** https://docs.usekili.com/docs/earnings-and-withdrawals **Description:** What you have earned, when it is yours, and how to get it out. **Audience:** reseller, creator, agent ## How commission is recorded Every sale attributed to you creates a commission row at the rate agreed when the sale happened. Changing a rate later never rewrites what you have already earned. Commission moves through three states: earned and waiting, approved, and paid. A refunded order reverses its commission — money we gave back was not earned — and the reversal stays visible rather than disappearing, so the history still adds up. ## Withdrawing 1. Add your bank or telebirr details under Settings, Payouts. Nothing can be paid before this exists. 2. Open Wallet or Earnings and request a withdrawal. 3. Kili checks it against your payout details and pays it. 4. The reference appears on your earnings so you can match it against your statement. **Note:** Only an owner can request a withdrawal or change where the money goes. A manager runs the account day to day; moving money out is deliberately a smaller circle. Two numbers on that panel are worth reading. Ready to withdraw is your approved commission minus anything you have already asked for and we have not yet sent — so asking twice for the same money is not possible. And there may be a smallest payout: below it, the panel says so before you ask rather than after. ## Why a withdrawal might wait - There are no payout details on file, or they are incomplete. - Some of the commission is still inside the refund window. - The payout account changed recently — a change is flagged to staff before anything is paid, which is a protection for you. --- ## The employee portal **URL:** https://docs.usekili.com/docs/employee-portal **Description:** Let your staff ask for data instead of asking you. **Audience:** corporate ## What it is A page at usekili.com/c/your-company that your employees can open without an account. They say where they are going and why; your own approvers say yes; the eSIM is issued and emailed to them, paid for out of your travel credit. It exists so that a trip does not start with somebody finding an admin in a corridor — and so that there is a record of who asked for what, and why the company paid for it. ## Setting the rules Open Employee portal from the sidebar. You choose: - The address — the part after /c/. - Who can ask: an email domain, so only your people can use it. There is no sign-in, so this is the gate. - What they can ask for: the longest plan, and which destinations are open. - What they must tell you: the reason, the dates, a cost centre. - Who approves: any admin, or only the people you have given the Approver role. **Note:** A portal that is switched off is not there at all — somebody with the link sees a page that does not exist, rather than one refusing them. Turn it off while you are still deciding the rules. ## Approving Requests arrive on the Requests page with a red count beside it. Each one shows who asked, where they are going, when, why, and what it will cost. Approving does two things at once: it spends your travel credit and issues the eSIM to the employee immediately. There is no second step to forget. **Note:** Nobody can approve their own request, whatever their role. If you need an eSIM for your own trip, ask a colleague — that is the rule working, not a bug. [Requests](https://www.usekili.com/partner/requests) --- ## eSIMs, for when somebody asks **URL:** https://docs.usekili.com/docs/esim-basics **Description:** Enough to answer the three questions every customer has. **Audience:** everyone ## What a customer receives An email with a QR code and a link. Scanning the QR with the phone's camera, or opening the link on the phone itself, adds the plan. It takes about a minute and needs a Wi-Fi or data connection to complete — which is why installing before flying is better advice than installing on arrival. ## The three questions **Will it work on my phone?** : Most phones from the last five years support eSIM, but not all, and some sold in certain markets have it disabled. The compatibility page lists the models we know about. **Does it replace my number?** : No. The eSIM is a second line for data. Calls and texts carry on arriving on the normal SIM, though roaming charges on that line are still the carrier's business. **When does it start?** : When it first connects to a network at the destination, not when it is bought — so buying a week early is safe. [Device compatibility](https://www.usekili.com/compatibility) ## When it does not work - Installed but no data: check data roaming is on for the Kili line, and that the line is selected for mobile data. - The QR will not scan: open the link on the phone itself instead. - Installed on the wrong phone: an eSIM cannot be moved. It has to be reissued, which is a support job. - Nothing arrived: check the order's status first — awaiting payment means the checkout never completed. --- ## Start here **URL:** https://docs.usekili.com/docs **Description:** How the Kili dashboards work, for everybody who uses one. **Audience:** everyone How the Kili dashboards work, for everybody who uses one. The pages differ by who you are, because the dashboards do: an Agent and a Creator share a sidebar and almost nothing else. ## Start with who you are You top up credit, set your own prices and sell from a counter or your own shop. You send guests to Kili with your code and earn commission on what they buy. You buy data for your own staff and guests, and never resell it. You share links with an audience and earn on every sale they make. You run the console: orders, partners, money, the catalogue. ## Every page ### Getting started - [What Kili is, and what a partner does](/docs/what-kili-is) — The shape of the product, and where you fit in it. - [Signing in](/docs/signing-in) — There is no password. What that means, and what to protect instead. - [Finding your way around](/docs/the-dashboard) — The sidebar, the money card, and what the badges mean. ### Selling - [Selling at the counter](/docs/selling-at-the-counter) — A guest in front of you, an eSIM on their phone before they walk away. - [Your storefront](/docs/your-storefront) — A branded page of plans with your name on it, at a link you can hand out. - [Your page](/docs/your-page) — A page of the plans you recommend, in your words, at one link. - [Your code and your links](/docs/your-code-and-links) — How a sale gets attributed to you, and how to tell which channel is working. - [Issuing eSIMs in bulk](/docs/issuing-in-bulk) — A group, a delegation or a tour — one list, one go. ### Money - [Credit and top-ups](/docs/wallet-and-top-ups) — How prepaid credit works, and how to put more in. - [Earnings and withdrawals](/docs/earnings-and-withdrawals) — What you have earned, when it is yours, and how to get it out. - [Prices and margin](/docs/prices-and-margin) — What you pay, what you charge, and who decides. ### Your organisation - [Your team](/docs/your-team) — Who can sign in, and what each of them can do. - [The employee portal](/docs/employee-portal) — Let your staff ask for data instead of asking you. - [Your account settings](/docs/your-settings) — Your profile, your company details, and where the money goes. ### Running Kili - [The staff console](/docs/staff-console) — What each screen is for, and the order a day runs in. - [Approving a partner](/docs/approving-partners) — What approval creates, and the one decision that matters. - [Moving partner money](/docs/money-queue) — Top-ups, withdrawals and commissions, and what happens on approval. - [eSIMs, for when somebody asks](/docs/esim-basics) — Enough to answer the three questions every customer has. ## Still stuck Tell us the order reference or your partner name and what you expected to happen. That is almost always enough for us to find it: [support@usekili.com](mailto:support@usekili.com). --- ## Issuing eSIMs in bulk **URL:** https://docs.usekili.com/docs/issuing-in-bulk **Description:** A group, a delegation or a tour — one list, one go. **Audience:** agent, corporate ## When to use it When you know the people in advance: a tour group landing on Thursday, a delegation, the sales team going to a conference. You give the list, Kili issues one eSIM per person and emails each of them directly. It spends your credit, the same as a counter sale. The eSIMs are live from the moment they are issued, so issue close to the trip rather than weeks ahead. ## Doing it 1. Open Issue eSIMs from the sidebar. 2. Pick the plan everybody is getting. 3. Add the people — one email address each, and a name if you want the email to greet them properly. 4. Check the total against your credit, then issue. **Note:** Each person gets their own eSIM and their own email. One plan cannot be shared between two phones, and an eSIM cannot be moved once installed. --- ## Moving partner money **URL:** https://docs.usekili.com/docs/money-queue **Description:** Top-ups, withdrawals and commissions, and what happens on approval. **Audience:** staff ## One queue Top-ups & payouts is a single queue over four separate tables — refills, earning requests, commissions and payout runs. They have four different status vocabularies underneath, which is exactly why they are presented as one list: the question is always the same, which is whether this money should move. ## The rules - A balance changes on approval, never when the request is made. - Credit a top-up only once the money has actually arrived — the request is a claim, not a receipt. - A withdrawal is checked against the partner's payout details. If those changed recently, find out why before paying. - Commission inside the refund window is not ready to withdraw. --- ## Prices and margin **URL:** https://docs.usekili.com/docs/prices-and-margin **Description:** What you pay, what you charge, and who decides. **Audience:** agent ## Your cost You buy at an agreed discount off Kili retail, and the Catalog & prices page shows the cost of every plan beside what it sells for. Specific plans can be fixed at a negotiated price; everything else uses your standing rate. ## Your price If your account is set to choose its own prices, what you set is what your customers pay on your storefront and at your counter. If it is not, customers pay Kili retail and your margin comes from the discount. **Note:** Kili will not let a plan be sold below what it costs. It is the one rule that is not negotiable, in either direction, because a sale that loses money is worse than a sale that does not happen. --- ## Selling at the counter **URL:** https://docs.usekili.com/docs/selling-at-the-counter **Description:** A guest in front of you, an eSIM on their phone before they walk away. **Audience:** agent, reseller ## What the counter is for Point of sale is for the person standing in front of you: at a hotel desk, a travel agency counter, an airport kiosk. You pick the plan, take their email, and the eSIM is sent while they are still there. An Agent pays for it out of wallet credit and charges the guest whatever they like — cash, card machine, transfer. A Reseller does not hold credit: the guest pays Kili at Kili's price, and the commission lands on your account. ## Making a sale as an Agent Four questions, because the sale finishes at your desk: the stock is already yours, and the guest leaves with the eSIM. 1. Open Point of sale and pick the plan. Search for anywhere — the whole catalogue is there, not only your shelf. 2. Type the guest's name and the email address the eSIM should go to. Check it out loud; a typo here sends somebody else's data plan to a stranger. 3. Say what you took and how — cash, card machine, transfer. Kili takes none of that money; recording it is what lets you reconcile the drawer at the end of the day. 4. Charge and issue. Your credit is debited, the eSIM is emailed, and the handover screen has the QR if they want to install it there and then. **Note:** The email address is the delivery address. It is the one field worth repeating back to the guest before you press the button. ## Making a sale as a Reseller Three questions, and it finishes on the guest's phone rather than at your desk. You hold no stock, so there is nothing of yours to charge and nothing of Kili's for you to collect — the guest pays Kili directly and your commission follows the order. 1. Open Point of sale and pick where the guest is going. 2. Type the email address the eSIM should go to, and a phone number if they are paying by mobile money. 3. Choose how they are paying, and whether they are paying on their own phone or on your screen. 4. Start the sale. A QR appears — they scan it, pay Kili, and the eSIM arrives in their inbox. The screen notices when the payment lands. **Note:** Nothing is lost if the guest walks away mid-payment. The order sits in Orders as unpaid and the link keeps working, so they can finish it in the taxi. ## If something goes wrong If the eSIM does not arrive, check Orders first: a sale that shows as awaiting payment never completed, and one that shows as needs attention failed on the supplier's side. Tell us the order reference and we will reissue it. Never read an activation code out over the phone — anybody who hears it can use it. --- ## Signing in **URL:** https://docs.usekili.com/docs/signing-in **Description:** There is no password. What that means, and what to protect instead. **Audience:** everyone ## How it works 1. Go to the sign-in page and type the email address your account is on. 2. We email you a six-digit code. It is good for a few minutes and for one use. 3. Type the code. You are in. You can also continue with Google, as long as the Google account uses the same address. There is no password to choose, forget, reuse or have stolen. ## What this means for your security Your inbox is the key to your dashboard. Anybody who can read it can sign in as you — so the single most useful thing you can do is turn on two-step verification with your email provider. **Note:** Kili will never ask you for a code, and nobody from Kili needs your sign-in to help you. If somebody asks, it is not us. If you lose access to the email address itself, tell us. Moving an account to a new address is something we do by hand, on purpose. ## Being invited When your organisation is approved, the person who applied is emailed a link. Opening it and signing in with that address attaches the account to the organisation. Colleagues are added later from the Team page, and get a link of their own that expires. --- ## The staff console **URL:** https://docs.usekili.com/docs/staff-console **Description:** What each screen is for, and the order a day runs in. **Audience:** staff ## Today The console opens on Today, which leads with the work rather than the numbers: applications waiting, money waiting, orders that took a payment and then failed. If nothing is on that list, nothing needs you. ## The screens **Orders** : Every order from the site, partners and counters. Tabs for what needs attention, filters by channel and payment, and a panel to resend a payment link, reissue an eSIM or refund. **Reporting** : Paid orders only, and the funnel from checkout to installed eSIM. The drop between started and paid, split by payment provider, is the number worth watching. **Partners** : Applications first, then every partner. Approving creates the organisation, its first code and a draft storefront, and emails them a sign-in link. **Top-ups & payouts** : One queue over four tables. Nothing changes a balance until somebody confirms it here. **Plans & pricing** : The catalogue from eSIM Go, with cost, price and margin per plan. Tick rows to reprice in bulk. **Destinations** : Which places customers see first on the homepage, and in what order. **Activity log** : Everything staff, partners and the system did. Append-only — entries cannot be edited or deleted. **Staff & roles** : Who can open the console, and what each person is meant to do. ## Rules the console enforces - A plan can never be sold below cost. - Balances change only on approval, never on request. - The console never shows an eSIM's activation code. Support reissues instead — a code read out loud is a code given away. - Every consequential action is logged with who did it. [Open the console](https://www.usekili.com/admin) --- ## Finding your way around **URL:** https://docs.usekili.com/docs/the-dashboard **Description:** The sidebar, the money card, and what the badges mean. **Audience:** everyone ## The sidebar Everything is in the left-hand column, grouped by the job it does rather than by the part of the system it belongs to: selling, money, and your organisation. What appears there depends on your partner type and on your role. At the top sits the money card — the one number you are most likely to have opened the dashboard to see. For an Agent that is wallet credit; for a Corporate account, travel credit; for a Reseller or Creator, what you have earned. Clicking it takes you to the page behind it. A red number beside a nav item means something is waiting for you. A grey word, like Draft beside Storefront, is the state of the thing rather than a queue. ## Status badges The same six colours mean the same six things everywhere in Kili, on every screen: **Amber** : Waiting on somebody — you, a customer, or us. **Green** : Done, paid, active. **Grey** : Over, and nobody did anything wrong. Expired, archived. **Red** : Somebody said no, or something broke. **Blue and violet** : Information, and the kind of partner an account is. ## Getting help Every page in the dashboard has Get support in the top bar. Tell us the order reference or the partner name and what you expected to happen — that is almost always enough for us to find it. [Help centre](https://www.usekili.com/resources/help) --- ## Credit and top-ups **URL:** https://docs.usekili.com/docs/wallet-and-top-ups **Description:** How prepaid credit works, and how to put more in. **Audience:** agent, corporate ## How credit works You hold credit with Kili and spend it as you issue. Every eSIM debits your balance at your agreed rate, which is usually well under what the customer pays you — that difference is your margin, and you keep it. Credit is held per currency. If you top up in birr and sell a dollar plan, the two balances are shown separately rather than being added together at a rate that was true on some other day. ## Topping up 1. Open Wallet, then Top up. 2. Pick an amount or a credit package. 3. Send the payment by the method shown. 4. Kili credits your balance once the money has actually arrived. **Note:** Topping up is a request, not an instant transfer. A bank transfer can take a day; your balance moves when the money does, not when the request is sent. ## Running out mid-sale If your credit will not cover a sale, the counter refuses it rather than issuing something you have not paid for. Top up, or take the sale through your storefront where the guest pays Kili directly. --- ## What Kili is, and what a partner does **URL:** https://docs.usekili.com/docs/what-kili-is **Description:** The shape of the product, and where you fit in it. **Audience:** everyone ## The product Kili sells eSIMs — mobile data that arrives by email and installs on a phone in about a minute, with no SIM card to post, collect or swap. A traveller buys a plan for where they are going, scans a code, and has data the moment they land. Two directions of travel matter here. Inbound is somebody arriving in Ethiopia who needs local data. Outbound is somebody leaving Ethiopia who needs roaming where they are going. Most partners sell one far more than the other, and the dashboard does not assume which. ## The four kinds of partner Every partner account is one of four types. The type is not a label — it decides what the dashboard contains, how money moves, and what you are allowed to do. **Agent** : Holds prepaid credit, buys at an agreed rate, and sets the price the customer pays. Sells at a counter, from a storefront, or by issuing eSIMs in bulk. Keeps the margin. **Reseller** : Holds no credit. Sends people to Kili with a code or link; they pay Kili's price, and you earn commission on what they spend. **Corporate** : Buys for its own people. Holds travel credit, issues eSIMs to staff, and can let employees request them through a portal. Never resells. **Creator** : One person with an audience. Shares tracked links and a code, and earns commission. No team, no counter, no stock. **Note:** If your dashboard is missing something this manual describes, it is almost certainly because your type does not have it. Ask Kili if you think the type is wrong — changing it is a two-minute job on our side. --- ## Your code and your links **URL:** https://docs.usekili.com/docs/your-code-and-links **Description:** How a sale gets attributed to you, and how to tell which channel is working. **Audience:** reseller, creator ## The code Your code is a short word a guest types at checkout, or carries automatically in a link. Either way the sale counts as yours and the commission appears on your account. Kili sets the code up when your account is approved. Ask us if you want a shorter or more memorable one — it is a quick change, but changing it later breaks anything already printed. ## Tracked links A tracked link is your code with somewhere to send people. Make one per place you post — your bio, a story, a video description — and the links page shows clicks, sales and earnings for each one separately. That is the whole point: with one link you know you made four sales, and with four links you know which post made them. [My links](https://www.usekili.com/partner/links) ## The reception card The Referral code page prints a card for a desk or a table: your code, a scannable QR, and a line explaining what it is. Print it on card and put it where people ask about Wi-Fi. --- ## Your page **URL:** https://docs.usekili.com/docs/your-page **Description:** A page of the plans you recommend, in your words, at one link. **Audience:** creator ## What it is A public page at usekili.com/s/your-name: the plans you recommend, a paragraph about you, and your socials. One link to put in a bio, and every sale through it is attributed to you without the buyer having to remember a code. You are not setting prices. Kili's price is the price, and you earn commission on what sells — which is also why your page can say what you actually think of a plan without it reading as a sales pitch. ## Setting it up 1. Open My page from the sidebar. There are four tabs, and they are four questions. 2. About you: your colour, your initials, and a short paragraph. People buy a plan from a person, so this is the part that is you rather than the catalogue. 3. Plans you recommend: pick a few and say why. A note under a plan is worth more than ten plans with nothing said about any of them. 4. Your socials: the accounts you want people to find. A handle is fine — you do not need to paste a full link. 5. Your link: your handle, and the address it makes. Copy it, then publish from the switch at the top. **Note:** A page that is still a draft is the most common reason a link in a bio does not work. The preview beside the editor is the real page, so what you see is what a follower gets. ## Getting it seen - The bio link, which is what this is for. - A story before a trip, where people are already thinking about data. - A pinned comment under a video about the place. - Your tracked links, if you want to know which of those worked — see Your code and your links. --- ## Your account settings **URL:** https://docs.usekili.com/docs/your-settings **Description:** Your profile, your company details, and where the money goes. **Audience:** agent, reseller, corporate, creator ## What is in there **Profile** : Your own name and how we address you. **Sign-in & security** : How you get in. Read-only, because there is no password to change — see the signing in page. **Company details** : Your registered and trading name, contact details and address. These appear on receipts and on your storefront. **Payouts** : Bank or telebirr details for withdrawals. Owner only, and every change is flagged to Kili. ## Why payouts are owner-only Changing where money is sent is the single most valuable thing somebody could do with a stolen login. It is restricted to owners, every change is recorded, and Kili is told — so if it was not you, we find out before a payment leaves. --- ## Your storefront **URL:** https://docs.usekili.com/docs/your-storefront **Description:** A branded page of plans with your name on it, at a link you can hand out. **Audience:** agent, reseller ## What it is A public page at usekili.com/s/your-name, with your logo, your colours and the plans you choose. Guests buy on it directly, which means it works while you are asleep and does not need anybody at a desk. An Agent's storefront sells at the Agent's own prices. A Reseller's sells at Kili's prices and earns commission. Either way the sale is attributed to you automatically — there is no code for the guest to remember. ## Setting it up 1. Open Storefront from the sidebar. 2. Set your brand: logo, colour, and the one line that says who you are. 3. Choose the plans you want on the front page. Three or four is better than thirty — people buy what they can compare. 4. Check the preview, then publish. **Note:** A storefront that is still a draft is the single most common reason a partner's link does not work. The Storefront item in your sidebar says Draft until you publish it. ## Where to put the link - Booking confirmation emails, where somebody is already thinking about the trip. - Your Wi-Fi landing page, where a guest is already on their phone. - A printed card at reception — the Referral code page can produce one. - WhatsApp and Telegram, which is where most Ethiopian travellers actually plan. --- ## Your team **URL:** https://docs.usekili.com/docs/your-team **Description:** Who can sign in, and what each of them can do. **Audience:** agent, reseller, corporate ## Adding somebody 1. Open Team from the sidebar. 2. Enter their work email and choose a role. 3. They get a link that expires, and sign in with that address — there is no password to pass on. ## The roles **Owner** : Everything, including payouts and the team itself. **Manager** : Runs the account day to day — prices, stock, top-ups, details — but cannot take money out or change who has access. **Front desk** : The counter and their own sales, nothing else. No prices, no balances, no team. **Finance** : The money pages: top-ups, earnings, payouts. **Note:** Give people the smallest role that lets them do their job. A front desk account on a shared machine is the right answer for a hotel reception, and it means a quiet shift cannot accidentally reprice your catalogue. ## Taking access away Removing somebody from the team stops them signing in to your dashboard immediately. Their past sales stay attributed to them, because the history is a record of what happened rather than of who currently works for you. --- ## Links - [Support](mailto:support@usekili.com)