White-label storefront
Hosted branded eVisa experience at
https://kawenter.com/a/{your-slug}/
. Or embed with an iframe. Travelers pay retail;
margin credits when the order is completed.
Overview
Hosted UI for approved travel agents. Travelers do not use a Partner API key.
White-label is Kawenter’s hosted storefront. You set name, logo, color, and markup; Kawenter runs apply, payment, and status under your slug.
Who can use it
- Approved travel agents only (
user_role=travel_agent) - Account email and phone must be saved before enabling (order notifications)
- Slug must be unique across agencies
- Not approved yet? Apply from your Kawenter profile.
Quick start
Configure from the Kawenter Dashboard.
- Open settings Dashboard → White-label
- Choose a slug Lowercase, unique
- Brand storefront Name, logo, color, markup
- Catalog limits Optional filters
- Enable and save Turn on, then save
-
Share or embed
/a/{slug}/or iframe
Pricing & wallet
Travelers pay retail; Partner API create/pay stays wholesale.
| Term | Meaning |
|---|---|
| Wholesale | Kawenter agent price (catalog / Partner API) |
| Retail | What travelers pay on the storefront (wholesale + your markup) |
| Agency margin | retail − wholesale |
- Travelers pay retail via Stripe / ZainCash. Kawenter is the merchant of record.
- Order notification email/phone = your agency contact; traveler details stay in order meta.
- When paid but not yet completed, margin may appear as pending (not withdrawable).
- Margin is credited only when the order is paid and status is
completed.
retail_total / agency_margin when markup is configured.
Refunds, chargebacks & margin clawback
Partner commercial rules for hosted white-label. Traveler eligibility is in Terms & Conditions.
Who handles traveler payments
| Party | Role |
|---|---|
| Traveler | Pays retail on the white-label storefront |
| Kawenter | Merchant of record. Collects payment, processes the order, handles refunds/disputes |
| Agency | Sets markup/branding; earns agency_margin; no payment gateway required |
Traveler refunds
- Eligibility follows Kawenter’s consumer Terms (typically non-refundable after government submission).
- Kawenter handles the traveler refund or card dispute with Stripe / ZainCash.
- Do not promise travelers refund terms beyond Kawenter’s published policy.
Agency margin. When it is earned
| Order state | Margin on your statement |
|---|---|
| Unpaid | Nothing |
Paid, not yet completed | Pending (not withdrawable) |
Paid + completed | Credited to agency wallet |
| Refunded, cancelled, charged back, or never completed | Not earned |
Chargebacks and margin clawback
- If a traveler payment is refunded or charged back after margin was credited, Kawenter may reverse that
agency_margin. - Clawback does not force a negative wallet: balance is debited first; shortfall may become a receivable with spend restriction.
- Separate: disputed/refunded agency wallet top-ups may also be clawed back.
completed;
avoid spending margin that may still reverse during a refund/dispute window.
Embed (iframe)
After the storefront is enabled, the dashboard provides ready-to-paste embed code.
<iframe
src="https://kawenter.com/a/your-slug/"
title="eVisa widget"
width="100%"
height="720"
style="border:0;border-radius:16px;max-width:960px;"
loading="lazy"
referrerpolicy="no-referrer-when-downgrade"
></iframe>
Travelers complete apply → pay → status inside the branded Kawenter widget.
Catalog controls
- Supported nationalities. Empty allows all; otherwise only listed passport codes.
- Supported destinations. Empty shows all; otherwise only listed countries.
- Hide eVisas for a nationality. Uncheck products you do not want to offer for a given passport.
Logo requirements
- Formats: PNG, JPG, or WebP
- Shape: square (shown as a small mark beside your display name)
- Recommended size: 512×512 px
- Max file size: 5 MB
White-label vs Partner API
You can use both: white-label for traveler sales, Partner API for wholesale automation.
| White-label storefront | Partner API | |
|---|---|---|
| Audience | Travelers on your brand | Your backend / ops |
| Entry | /a/{slug}/ or iframe | /api/partner/v1 |
| Auth | Configure in Dashboard | ka_live_… API key |
| Price | Retail (markup) | Wholesale |
| Wallet | Margin on completed | You pay via pay-wallet |
| Docs | /docs/white-label | /docs/partner |
Typical traveler path
-
Open storefront
/a/{slug}/or iframe - Choose product Nationality → destination → eVisa
- Apply and pay Traveler pays retail
- Agency notified Payment emails to your agency
-
Margin credited
Wallet credit on
completed
Machine-readable: Markdown · Agent JSON · llms.txt · Related: Partner API