<!-- https://unlockos.io/manual/guest-payment -->

# Payments

## Overview

In the UnlockOS Guest Booking App, payment happens after email verification (OTP), at the confirmation step, when a plan has a fee. Prepayment is the standard case. Plans with a ¥0 fee skip payment entirely and confirm your reservation immediately.

Supported payment methods:

| Method | Type |
|--------|------|
| Credit card / Debit card | Inline card entry |
| Apple Pay | Wallet payment |
| Google Pay | Wallet payment |
| Link (email one-click) | One-click checkout via saved card |
| PayPay | Redirect-based QR payment |

---

## Paying by Card, Apple Pay, or Google Pay

1. Enter your card details on the payment form, or tap Apple Pay / Google Pay
2. Tap the **Pay** button
3. **Do not close the screen while payment is processing** — closing the screen may cause the payment to fail
4. Once payment succeeds, you will be taken automatically to the booking confirmation screen

> **For Apple Pay / Google Pay:** Your device must support Touch ID or Face ID authentication. Make sure a valid card is registered in your wallet app.

---

## Paying by PayPay

PayPay and similar methods use a redirect-based flow.

1. Select **PayPay** as your payment method and tap **Pay**
2. You are taken full-screen to the PayPay app (or browser)
3. Approve the payment in PayPay
4. After approval, you are returned to the booking app and your reservation is confirmed automatically

> **Your pending payment is saved even if you close the browser.** If you close the browser mid-flow, re-open the app — it will check the payment status automatically. If your PayPay approval went through, the reservation will be confirmed without any further action on your part.

---

## Resuming an Interrupted or Declined Payment

If your card was declined or the payment was interrupted, you can retry from the reservation list.

1. Open the **Reservations** tab in the navigation bar
2. Find the reservation — it will show a **Pay** button
3. Tap **Pay** to reopen the payment form
4. Enter your payment details and complete the transaction

---

## Approval-Required Plans (Pay After Facility Approval)

Some plans require the facility to approve your booking before payment is collected.

- Your reservation will show a **Pending** status immediately after booking
- Once the facility approves, you will receive a payment link by email
- Tap the link in the email, or use the **Pay** button in your reservation list to complete payment
- Your reservation is confirmed and your access code is issued after payment

---

## Pay at Check-in (Facility Setting)

Some facilities collect payment at check-in rather than during booking.

- No payment form is shown at the time of booking
- Your reservation remains in **Pending** or **Confirmed** status
- Pay on the day of your visit at the front desk or kiosk

---

## Saved Cards & Link

If you have previously paid using Stripe Link with the same email address, your saved card may appear as a one-click option at checkout. Just tap it to pay without re-entering your card details.

> To manage saved cards (add or remove), use the Stripe Link portal. There is no in-app option to delete saved cards directly.

---

## Frequently Asked Questions

### Q: My card was declined. What should I do?
A: Double-check your card number, expiry date, and security code (CVV), then try again. If the problem persists, try a different card or contact your card issuer. A declined card may also indicate that your spending limit has been reached.

### Q: I approved PayPay but my reservation is not confirmed.
A: It may take a few seconds after approving in PayPay for the status to update. Wait a moment, then check your reservation list. If it still shows as pending, tap the **Pay** button on that reservation to re-check the payment status. If the problem continues, contact the facility.

### Q: I closed the payment screen. Where do I go to finish paying?
A: Open the **Reservations** tab and tap the **Pay** button on the reservation in question. The payment form will reopen so you can complete the transaction.

### Q: Are my card details stored?
A: Card details are not stored in the app. They are managed securely through Stripe Link. If you prefer not to save your card, you can skip the Link registration step.

### Q: How do refunds work?
A: Refund policies vary by facility. Please see [Cancelling a Reservation](guest-cancel-reservation.md) for details.

---

## Related Pages

- [How to Book](reservation-guest.md)
- [Cancelling a Reservation](guest-cancel-reservation.md)
- [Check-in](guest-checkin.md)
