Help & FAQ

Quick answers to common questions about invoices, payments, and your account.

Getting started

How do I create my first invoice?

Go to Invoices → Create invoice. Add your client (name and optional email), one or more line items (description + amount), choose whether VAT is included, and optional due date. Click Create invoice. You can then copy the payment link or send it by email.

Is Puyer free to use?

Yes. You can create unlimited invoices, send payment links, and track payments. Stripe fees apply per transaction when your client pays. There's no subscription fee to start.

Do I need a Stripe account?

You need to connect Stripe to receive payments. Go to Settings → Payments and click Connect Stripe. Stripe handles card processing, payouts, and compliance. Puyer does not store any payment or bank details.

What currencies are supported?

USD, EUR, and GBP. You set a default currency in Settings. Each invoice uses your default unless you create it in a different currency. Stripe supports many more; we show the most common for simplicity.

Invoices

How do I send an invoice by email?

When creating an invoice, check "Create & send email" or use the "Send by email" button on the invoice detail page. The client receives a branded email with a "View & pay" link. You need the client's email and must have Resend configured.

Can I add multiple line items (services) to one invoice?

Yes. When creating an invoice, add as many line items as you need. Each row has a description and amount. The total is calculated automatically, with VAT applied if enabled.

What is the payment processing fee (1.5% + fixed)?

Stripe charges ~1.5% + a fixed fee per transaction. If you enable "Include payment processing fee" when creating an invoice, Puyer calculates the extra amount so that after Stripe's deduction you receive the full subtotal + VAT.

How do reminders work?

You can enable auto-reminders when creating an invoice (e.g. 1, 3, 7 days after send). Or send manual reminders from the invoice detail page. Reminders are rate-limited (e.g. once per 24 hours) to avoid spam.

Can I void or mark an invoice as paid manually?

Yes. On the invoice detail page you can Void (cancel) or Mark as paid. Use Mark as paid when you receive payment outside Stripe (bank transfer, cash, etc.).

How do recurring invoices work?

When creating an invoice, enable "Recurring invoice" and choose the interval (e.g. every 7 or 30 days). After the invoice is sent, Puyer automatically creates and sends a new copy at each interval until you stop it.

Can I add my company logo and contact details?

Yes. In Settings → Business profile, add your address, phone, company number, and VAT number. Upload your logo (PNG, JPEG, or WebP, max 1MB). These appear on invoices (PDF), the public payment page, and in the app header.

Payments

How does the client pay?

When you send the payment link or email, the client opens it, sees the invoice, and clicks Pay. They're taken to Stripe Checkout to enter card details. After payment, they're redirected back and the invoice status updates to Paid.

When do I receive the money?

Stripe pays out to your connected bank account on their schedule (typically 2–7 days depending on region). Puyer does not hold funds; Stripe handles everything.

What payment methods does the client see?

Stripe Checkout shows card payments and any methods you've enabled in your Stripe Dashboard (e.g. Apple Pay, Google Pay). You manage this in your Stripe account.

Can clients pay without an account?

Yes. Clients only need the payment link. No sign-up or account required. They enter their card details on Stripe's secure page.

Account & security

How do I sign in?

You can use a magic link (we email you a login link) or password. Set a password in Settings → Account security so you can always sign in with email + password.

What is the OTP (5-digit code) when signing in?

If you use password sign-in, we send a 5-digit code by email as an extra security step. Enter it to complete login. You can tick "Remember this device for 30 days" to skip OTP on trusted devices.

How do I change my business name or currency?

Go to Settings → Business profile. Edit Business name, Default currency, Country, and Timezone. Currency changes affect how new invoices and dashboard stats are displayed.

How do I delete my account?

Contact support@puyer.org with your account email. We'll process the deletion request and confirm. Your invoices and data will be removed in line with our privacy practices.

Troubleshooting

The client didn't receive the invoice email

Check spam/junk. Ensure the client's email is correct. If using Resend, check your Resend dashboard for delivery status. You can always copy the payment link and send it manually.

Payment link shows 404 or error

The link may be for a voided invoice or an invalid public ID. Ensure the invoice exists and is not voided. Try copying a fresh link from the invoice detail page.

Logo upload fails with "row-level security" error

Ensure the database migration for the logos storage bucket and RLS policies is applied (20250232000004). Run migrations in Supabase or contact support if self-hosted.

PDF download doesn't show my logo

Logos must be PNG or JPEG for PDF (WebP is not supported by the PDF library). Re-upload your logo as PNG or JPEG in Settings.

Something else isn't working

Contact support@puyer.org with details (what you did, what you expected, any error message). We usually respond within 1–2 business days.

Still need help?

We reply within 1–2 business days.

support@puyer.org