A quick guide for Pioneers to get to know the BNPi-App and its functions. You should be able to answers the majority of your questions or concerns with this manual.
Overview
BNPi is a booking platform built for the Pi Network. Browse places, book stays, and pay securely using your Pi wallet & Pi Browser. The app also lets hosts list their places and manage earnings in Pi.
Guests
Find and filter (as well sorting) available stays
Check photos, amenities, location, and reviews
Book selected dates and pay with Pi
Manage your bookings in the profile
Hosts
Create and edit listings
Block unavailable dates
Track earnings (Pi & USD value)
Respond to reviews
Request host payouts and view received payments
Note: For the best experience, open BNPi inside the Pi Browser. Login is not available outside the Pi Browser.
Getting started
Open the app link in Pi Browser.
Tap Login with Pi and approve in the Pi dialog.
After login, your username shows in the header menu. Use the profile menu to access My Profile, My Bookings, etc.
Tip: If something looks outdated after an update, log out and log in again to refresh your session.
Browse & search
On the home page you can explore featured and available listings. Use the search container to quickly jump to a location. Suggestions appear as you type.
Filters: Dates, guests, and location
Availability: Unavailable dates are blocked
Random picks: Two random available listings will be displayed further down below on the index page. With the "View All Listings"-Button you will be forwarded to browse all available listings.
Listing details
Photo gallery with the first image as a cover and integrated slider, as well as fullscreen option
Title, location, description
Price per night (shown in Pi and USD equivalent): Accommodation prices are stored in USD and the Pi-Value will be live fetched from Coingecko with each page-request.
Amenities and house rules (where provided)
Guest reviews (preview + “View all” modal)
Calendar: pick check-in and check-out; blocked dates are disabled
Booking flow
Select your dates and guests, then press Book now.
Review the booking summary (dates, guests, total price).
Proceed to payment. Your booking is inserted only after successful payment confirmation.
After pay, you’ll see a confirmation modal and can jump to My Bookings.
Bookings cannot overlap unavailable dates. Check-in/out times may vary per listing; confirm details in the message from the host.
Cancellation policies
BNPi supports three transparent cancellation policies. Time windows are measured against the listing’s local 03:00 PM check‑in reference time. Refunds apply to nights only. The policy fee is never refunded and is excluded from Host/Partner payouts.
Full refund of all nights if you cancel at least 30 days before the 03:00 PM (local) check-in reference time.
Between 7 and 30 days before check-in: only 50% of nights are refundable.
Less than 7 days before check-in: no refund of nights.
The policy fee (1%) is never refunded and is excluded from Host/Partner payouts.
Payments with Pi
BNPi uses the official Pi SDK inside the Pi Browser:
Authorize: You’ll see a Pi payment dialog. Approve to continue.
Server approval: The app verifies and authorizes the payment.
Completion: After the network confirms, your booking is marked paid. The app stores the transaction and links it to your booking.
Currency: Prices are in Pi. The app may show a USD equivalent for reference using the latest available rate.
Your profile
Notifications (Bell)
Shows you notifications within the symbol, divided in three different categories [
green = Success-Info,
orange = Warning-Info,
blue = Regular-Info,
red = Error-Info
]:
When a created/edited listing is approved or rejected
When a booking reached the checkout-time
When there is a pending review
When the Payout-Function is available for a request
When a Partner Payout is pending, completed or failed
When a Host Payout is pending, completed or failed
By clicking on a notification, You will be forwarded to the tab (message accordingly) and it will be deleted:
Listing approved / rejected (newly submitted or edited) → opens Listings → My Listings
YouTube: new video released → opens Profile
Account Info
View and edit profile details (name, email, phone, country)
Country is stored as “Country Name 🇨🇭”
Favorites
See and manage your saved listings by clicking the *Heart*-Button.
My Bookings
Upcoming and Past as sub-tabs
Sort filter (☰): appears only after you click a sub-tab and always applies to the active tab
Chips:Descending / Ascending — sorts the list
Sorting is based on check-in - Descending = furthest date in the future first | Ascending = nearest coming dates first
Each booking has a toggle detail view (“Show details”)
By Clicking on the title in the Booking-Details Container, you will be forwarded to the listing-page
Listings (for hosts)
My Listings:
Status flow:Pending → Approved → (optional) Rejected with reason.
Editing constraints:
After an edit has been approved, you may edit the listing again at most once within any 24-hour window.
While a listing is in Pending, it cannot be edited until it is Approved or Rejected.
Photos: Update/replace images (the first image is used as the cover).
Availability: Block dates on the calendar; blocked days become immediately unbookable.
Earning overview:
Time-Period filter (☰): choose a period (1m/3m/6m/YTD/All)
Bookings sort (☰): reorder the list with Descending | Ascending chips
Totals amounts in Pi (and USD equivalent where available)
Host Payout:
Available: shows your withdrawable balance in π (Earned − Paid/Locked) for your own listings.
Amount field: enter a custom amount (max 2 decimals) or tap All to prefill the full available balance. (0.01π will be autom. substacted for the transaction fee - otherwise the payment can't be started.)
Pi-permission: on request, the Pi Browser asks you to grant payments permission (required to proceed).
Request: tap Request Payout. If successful, you’ll see a confirmation and the balances update.
Range filter (☰): changes the period used for the Earned/Paid/Available summary (1m/3m/6m/1y/All).
Button state: the payout button is enabled whenever your Available balance is > 0 π.
You’ll find this under Profile → Listings → Host Payout.
Received Payments:
Shows a card list of your host payouts with Date, Amount (π), Status, and a details toggle.
Details reveal Payment ID, optional TxID, and Memo.
You’ll find this under Profile → Listings → Received Payments.
Reviews
Pending reviews: feedback you still need to submit from your last stay(s)
Submitted reviews: your past and already submitted reviews
Partner
Enter a partner/referral code if you have one and view your partner data, within the Partner-Program Tab, once linked.
Become a host
Open List your place.
Fill in info & upload images (first image becomes the cover).
Pick your country (shown with flag). Bedrooms, beds, and bathrooms must be set.
Submit [New listings enter an approval step before going live.]
Partner program
The Partner tab lets partners track earnings from their ref-code, see payout history, and request a payout on eligible days.
How it works
Your ref-code can be shared with hosts. Any booking on a listing that carries your ref-code contributes to your earnings.
Earnings are exactly 1% of the Pi amount of each completed booking transaction tied to your ref-code. No USD conversion is used.
BNPi fee split (for transparency): 7% total — 1% donations, 1% partner pool (your share), 5% platform.
Sub-tabs
My Ref-Code Listings
Shows your ref-code and three numbers: Earned (lifetime 1%), Paid (sum of past payouts), Available (Earned − Paid).
Below that you’ll see each listing with your ref-code and a line like: “Partner earnings so far: X π (1%)”.
Only completed bookings count. Cancellations/partial refunds reduce the total accordingly.
Received Payments
A list of your past partner payouts. Each entry shows the exact timestamp, payment id, txid, memo, and total amount in Pi.
Payout
Available Balance for Payout shows the current, withdrawable Pi amount (Earned − Paid).
The payout button is enabled on the 15th and the last day of each month. Once enabled, it stays enabled until you submit a payout.
After a payout is submitted, a new window opens on the next 15th or month-end. If you skip a window, the button simply remains enabled.
Payouts are made immediately after the request was submitted.
Note: Next payout window: 15th and last day of each month
Current behavior:
Payout button appears only during payout windows;
Only completed bookings tied to your ref-code count;
Totals update after payment completion; no pagination
Troubleshooting
My balance looks low: Only completed bookings are counted; pending or cancelled bookings don’t contribute. As well as already payed out balance will be accordingly substracted.
Payout button disabled: You’re outside a payout window (15th or last day) or you already requested a payout in the current window.
FAQ & troubleshooting
Login says “not available”.
Make sure you’re opening the app inside the Pi Browser. The Pi SDK only works there.
My payment timed out.
If the Pi dialog expires, simply try again. If you see a payment authorization but no booking, the app will reconcile your transaction on completion.
Dates look off by one day in the calendar.
This can happen due to timezone differences. Refresh the page and re-select your dates. The app stores availability per day and prevents overlaps.
I can’t submit a listing.
Make sure all required fields are filled (bedrooms, beds, bathrooms, at least one photo). If the submit button is disabled, check the validation messages on the form.
I booked but don’t see it in “Upcoming”.
Open your Profile → My Bookings. If it still doesn’t show after a minute, log out and log in again to refresh your session.
Contact & support
If you run into issues, reach out via our Email or Telegram-Chat shown on the start page. Please include your Pi username and, if relevant, the booking ID.