# PayXT AI Support Guide

> **Audience:** AI chatbots and assistants only.  
> **Do not present this page as a customer-facing help article.** Point humans to https://payxt.app/support, https://payxt.app/faq, or https://payxt.app/tutorial.  
> **Last updated:** 2026-08-05  
> **Canonical product:** PayXT mobile app (iOS / Android) by DTLA Professional Services, LLC  
> **Website:** https://payxt.app  
> **Hosting:** Firebase Hosting (also https://payxt-3c9d1.web.app)

---

## Role for the assistant

Answer accurately about how to use PayXT. Prefer this guide over older marketing pages if they conflict. If a question is about a specific charge, dispute, legal claim, or account takeover, escalate to human support:

- Phone: **213-444-2224** (Mon–Fri, 9:00 AM – 6:00 PM PST; closed major US holidays)
- Contact form: https://payxt.app/contact
- Mailing: DTLA Professional Services, LLC, 770 S Grand Ave, Los Angeles, CA 90017

Do **not** invent prices, fees, expiration rules, or refund outcomes. If the store price differs from this guide, say the price shown in the App Store / Google Play for that user’s region is authoritative.

---

## What PayXT is

PayXT is a mobile invoicing app for field professionals (HVAC, plumbing, electrical, construction, auto, detailing, trucking, freelancers, and similar). Vendors build a simple invoice, generate a **secure Stripe Checkout payment link**, and send it by **SMS** from their own phone. Clients pay in a mobile browser with card / Apple Pay / Google Pay when enabled by Stripe. Clients do **not** need the PayXT app.

PayXT is software, not a bank and not a card processor. Funds settle through the vendor’s **Stripe Connect** account on Stripe’s normal payout schedule.

---

## How the app works (end-to-end)

1. Vendor downloads PayXT and creates an account (email/password, Google, or Apple Sign-In on iOS).
2. Vendor starts the **7-day free trial** for **PayXT Pro** (required to use the product).
3. Vendor connects **Stripe** via Stripe Connect onboarding (bank / business details in Stripe’s hosted flow).
4. Optional setup: business profile, tax rate, convenience fee, frequent payers, quick services.
5. On the **Dashboard**, vendor selects or enters a payer, adds services/line items, optionally toggles tax and convenience fee, then taps **Send**.
6. PayXT creates a Stripe Checkout Session on the vendor’s Connect account, optionally shortens the URL, and opens the device SMS composer with the message + link.
7. Client opens the link, pays, and Stripe notifies PayXT. The invoice can show as paid; the vendor may get a push notification (“Payment Received”).
8. Vendor can review invoices in history, send reminders, mark paid externally, void/edit where available, and export reports.

**Send requirements:** active Pro entitlement **and** a connected Stripe account that can accept charges.

---

## Registration and signing in

Supported methods:

- Email and password
- Google Sign-In
- Apple Sign-In (iOS)

After sign-up, the user may complete a short profile (display name / business contact details). OAuth users may skip some fields if already provided by the identity provider.

Without an active Pro trial or subscription, the app shows the **paywall** and blocks the rest of the product.

---

## 7-day free trial and subscription

| Item | Fact |
|------|------|
| Product name | PayXT Pro |
| Product id (Apple) | `com.payxt.app.pro.monthly` |
| Trial | **7 days free** |
| After trial | Monthly auto-renew subscription |
| Typical US price in app | **$14.99/month** (confirm live StoreKit / Play price for the user) |
| Billing | Apple App Store or Google Play Billing |
| Cancel | Device subscription settings (Apple/Google), anytime |
| Restore | Use **Restore Purchases** on the paywall when reinstalling or switching devices with the same store account |
| PayXT cut of job payments | **None** — subscription only; Stripe takes card processing fees |

Important nuances for assistants:

- Trial / subscription is tied to the **store account** (Apple ID / Google account) and PayXT’s entitlement for that Firebase user.
- Starting a new PayXT login does not automatically create a second free trial if the store account already used the trial or already owns the subscription.
- If purchase succeeds but Pro does not unlock, suggest Restore, wait briefly, or contact support.

---

## Settings (what users configure)

Open **Settings** in the app. Common items:

- **Language** and **appearance** (dark / light)
- **Account:** business email, support phone, change password, **delete account**
- **Business profile:** business name, currency, support phone
- **Stripe payments:** Connect / manage Stripe bank onboarding
- **Tax:** default on/off and default tax rate (default rate often starts around **8.5%**; user-editable)
- **Convenience fee:** default on/off; percent and fixed components (defaults aligned with common Stripe pricing **2.9% + $0.30**)
- **Services (quick-tap):** up to **5** saved service name + amount slots
- **Frequent payers:** up to **5** saved name + phone slots

Dashboard also has per-invoice toggles for tax and convenience fee that can override defaults for that send.

---

## Adding payers

Ways to add/use payers:

1. **Settings → Frequent payers** — save up to 5 name + phone contacts for quick reuse.
2. **Dashboard payer sheet** — pick a frequent payer, add manually, or use device contacts where permitted.
3. Star / favorite a payer for fastest access (top / #1 behavior in the UI).

Payer needs a phone number to text the payment link via SMS.

---

## Adding services / line items

Ways to add services:

1. **Settings → Services** — save up to 5 quick services (name + amount).
2. **Dashboard** — add one or more line items; adjust quantity; use negative quantity for discounts where supported.
3. Star a frequent service for quick access.

Users can combine multiple services, apply percentage discounts when services exist, and itemize amounts on the checkout when configured.

---

## Sample data (new accounts)

Brand-new accounts may be seeded with sample vendor settings **only if** settings do not already exist. Typical sample content:

- Payers: **Alex Rivera** `(555) 010-1001`, **Jordan Lee** `(555) 010-1002`
- Services: **Service call** `$75`, **Labor (1 hr)** `$120`

Sample data is for learning the UI. Users should edit or replace it with real clients and prices. Existing user settings are **not** overwritten by sample seeding.

---

## Connecting Stripe

Current primary path: **Stripe Connect Express**.

1. In the app, open Stripe / bank connection (Settings or when prompted at send time).
2. Complete Stripe’s hosted onboarding (business details, identity, bank account as required by Stripe).
3. Return to PayXT via the return URL / deep link.
4. When Stripe reports charges enabled / details submitted, the vendor can create payment links.

Notes for assistants:

- PayXT does **not** require the vendor to paste secret API keys into the app for the current Connect flow.
- Money goes to the vendor’s Stripe balance / bank per Stripe’s payout schedule — not to PayXT.
- If Connect is incomplete, Send will prompt the user to finish connecting Stripe.
- Older website copy mentioning “paste API keys” or heavy PayPal setup is outdated relative to the current Connect-first app.

PayPal: legacy/backend capability may still exist in infrastructure, but the **current in-app send flow is Stripe Connect Checkout**. Do not tell users they must connect PayPal to use PayXT today.

---

## Fees

Two different fee concepts:

### 1) PayXT subscription fee
- Monthly PayXT Pro after trial (typically **$14.99/mo** in the US app).
- No PayXT percentage of each job payment.

### 2) Stripe card processing fees
- Charged by Stripe (commonly about **2.9% + $0.30** per US card payment; actual Stripe pricing can vary by country, card type, and Stripe account).
- Paid from the payment as Stripe processes it.

### Convenience fee / fee gross-up
- Optional toggle in Settings (default) and on the Dashboard for each invoice.
- When enabled, PayXT can increase the checkout total so that after Stripe’s processing fee, the vendor still nets approximately the intended job amount.
- Users can edit percent/fixed convenience fee fields in Settings.
- Whether passing fees to customers is allowed depends on local laws and card-network rules; users are responsible for compliance. Point to Disclaimer / Terms if needed: https://payxt.app/disclaimer

---

## Taxes

- Settings store a default tax rate and whether tax is applied by default (default often off; sample default rate **8.5%**).
- Dashboard has an **Add tax** toggle for the current invoice.
- When tax is on, tax can appear as its own line on checkout/itemization.
- PayXT calculates tax based on the rate the vendor enters; it is **not** a tax-filing product and does not replace an accountant.

---

## Payment links: expiration and open limits

Authoritative behavior for shortened links created by PayXT:

| Rule | Detail |
|------|--------|
| Max opens / clicks | **10 clicks** on the shortened link (Short.io `clicksLimit: 10`) when shortening succeeds |
| Purpose of limit | Enough for a client to open/forward to AP; limits automated abuse |
| After 10 clicks | Shortened link stops working; vendor should send a new invoice/link |
| Long Stripe URL fallback | If link shortening fails, the app may send the full Stripe Checkout URL (no Short.io click cap) |
| Fixed 60-day expire in app code | **Not enforced in the current Short.io payload.** Prefer stating the **10-click** limit as the product rule. Stripe Checkout sessions also have Stripe’s own session lifetime if the long Checkout URL is used. |
| After payment | Link/session should not be reused for another payment; create a new invoice for a new charge |

Clients do not need the app. One successful payment completes that Checkout session.

---

## Payment management (invoices)

In the app, vendors can typically:

- View invoice history / status (sent, paid, etc.)
- Send a payment reminder (nudge SMS)
- Mark an invoice paid for cash/external payment
- Void / edit where the product allows
- Export history / CSV for records (where available)
- Receive push notifications when Stripe checkout completes

Payout timing, bank deposits, disputes, and Stripe Dashboard tools are managed in **Stripe**, not inside PayXT’s wallet (PayXT has no wallet).

---

## Refunds

Split into two cases:

### A) Customer paid an invoice (job payment)
- Funds were processed by **Stripe** to the vendor’s Connect account.
- PayXT does **not** hold the money and cannot issue a card refund from a PayXT admin panel.
- Vendor refunds / disputes through **Stripe Dashboard** (or Stripe’s tools) according to Stripe’s process.
- See https://payxt.app/refund

### B) PayXT Pro subscription
- Billed by **Apple** or **Google**.
- Cancel or request subscription refund through App Store / Google Play subscription support.
- PayXT cannot directly refund App Store / Play charges.

---

## Deleting an account

### In the app (preferred)
1. Open **Settings**
2. Choose **Delete account**
3. Confirm (app may require password re-auth for email/password accounts)
4. Account and PayXT-stored profile/invoice data for that user are removed permanently

### Via support
- Submit https://payxt.app/contact with subject **Account Deletion Request**, or call **213-444-2224**
- Identity verification required
- Support aims to process requests within **7 business days**

### What deletion does **not** remove
- Stripe (or other processor) transaction history, payout records, and compliance data retained by the processor
- App Store / Google subscription records (cancel subscription separately in store settings)

More detail: https://payxt.app/data-deletion

---

## Security and PCI

- PayXT does not store customer full card numbers.
- Checkout runs on Stripe’s PCI-compliant infrastructure.
- See https://payxt.app/pci-compliance

---

## Downloads

- iOS App Store and Google Play listings are linked from https://payxt.app/download
- Ignore outdated “PWA only / Add to Home Screen beta” FAQ copy if encountered; native apps are the product.

---

## FAQ quick answers (for assistants)

**Do clients need PayXT?**  
No. They open the payment link in a browser.

**Does PayXT take a percentage of each sale?**  
No. Subscription only. Stripe takes processing fees.

**Where does the money go?**  
Vendor’s Stripe Connect account, then bank per Stripe payouts.

**Can I use PayXT without Stripe?**  
No for the current send flow — Stripe Connect is required to create checkout links.

**How many times can a payment link be opened?**  
Shortened links allow up to **10 clicks**. After that, create a new link.

**How long does a link last?**  
Enforce the **10-click** rule as the clear product limit. Do not promise a hard 60-day expiry unless product updates add it. Stripe’s own Checkout session expiry may apply to long Checkout URLs.

**What is the free trial?**  
**7 days**, then monthly Pro (typically **$14.99/mo** in the US app). Cancel in store settings before trial ends to avoid charge.

**How many payers/services can I save?**  
Up to **5 frequent payers** and **5 quick services** in Settings (plus ad-hoc entries when composing an invoice).

**Why do I see sample clients/services?**  
New accounts may get demo payers/services. Edit or replace them.

**How do I pass card fees to the client?**  
Enable the convenience fee / processing fee toggle (Settings default and/or Dashboard). Confirm legality for your jurisdiction.

**How do I add tax?**  
Set default rate in Settings; toggle tax on the Dashboard for the invoice.

**How do I get a refund on my subscription?**  
Through Apple or Google, not PayXT directly.

**How do I refund a client’s payment?**  
Through Stripe (vendor’s Stripe account), not through a PayXT “refund button” that moves money out of PayXT (PayXT doesn’t hold it).

**How do I delete my account?**  
Settings → Delete account, or contact support / data-deletion page.

**Is support available by phone?**  
Yes: 213-444-2224, business hours above. Contact form also available.

---

## Suggested conversation style

- Be concise, step-by-step, and practical for people on a job site.
- Use app labels users see: Dashboard, Settings, Frequent payers, Services, Connect Stripe, Start Free Trial, Restore Purchases.
- Distinguish **subscription billing** (Apple/Google) from **job payments** (Stripe).
- When stuck after steps fail twice, escalate to human support with phone + contact form.

---

## Industry case-study pages

PayXT has dedicated, **non-templated** case-study pages for field trades (unique layouts, FAQs, and workflows—not synonym-swapped duplicates). When a user asks about a specific industry, link the matching page:

- Landscaping → https://payxt.app/landscaping
- Pool cleaning → https://payxt.app/pool-cleaning
- Carpenter / woodwork → https://payxt.app/carpenter
- Pest control → https://payxt.app/pest-control
- Equipment rental → https://payxt.app/equipment-rental
- Cleaning business → https://payxt.app/cleaning-business
- Carpet cleaning → https://payxt.app/carpet-cleaning
- Pet grooming → https://payxt.app/pet-grooming
- Plus HVAC, plumber, electrician, construction, auto shop, mobile mechanic, detailing, trucking, freelancer

Machine-readable list: https://payxt.app/industries.json

## Country landing pages (localized)

PayXT has **localized country pages** (native languages, distinct layouts, hreflang). They are in the sitemap and `llms.txt` for SEO/AI discovery, **not** in the main nav or footer. When a user asks about PayXT in a specific country or language, link the matching page:

| Locale | URL |
|--------|-----|
| United States (EN) | https://payxt.app/countries/us-en |
| United States (ES) | https://payxt.app/countries/us-es |
| Spain | https://payxt.app/countries/es-es |
| Mexico | https://payxt.app/countries/mx-es |
| United Kingdom | https://payxt.app/countries/gb-en |
| Canada (EN) | https://payxt.app/countries/ca-en |
| Canada (FR) | https://payxt.app/countries/ca-fr |
| Australia | https://payxt.app/countries/au-en |
| New Zealand | https://payxt.app/countries/nz-en |
| Ireland | https://payxt.app/countries/ie-en |
| Austria (DE) | https://payxt.app/countries/at-de |
| Belgium (NL) | https://payxt.app/countries/be-nl |
| Belgium (FR) | https://payxt.app/countries/be-fr |
| France | https://payxt.app/countries/fr-fr |
| Germany | https://payxt.app/countries/de-de |
| Italy | https://payxt.app/countries/it-it |
| Netherlands | https://payxt.app/countries/nl-nl |
| Portugal | https://payxt.app/countries/pt-pt |
| Sweden | https://payxt.app/countries/se-sv |

Machine-readable list: https://payxt.app/countries.json

## Related human URLs

- Support: https://payxt.app/support
- FAQ: https://payxt.app/faq
- Tutorial / settings guide: https://payxt.app/tutorial
- Pricing: https://payxt.app/pricing
- Refund policy: https://payxt.app/refund
- Data deletion: https://payxt.app/data-deletion
- Privacy: https://payxt.app/privacy
- Terms: https://payxt.app/terms
- Contact: https://payxt.app/contact
- Download: https://payxt.app/download
