# Inviting2U
> Digital invitation cards for weddings, engagements, birthdays and corporate events.

## What This Service Does
Inviting2U is an online platform for creating, customizing, and sharing digital invitation cards for events including weddings, engagements, birthdays, graduations, and corporate events. Built for the Malaysian market with bilingual support (English and Bahasa Melayu), RSVP collection, photo galleries, and Google Maps integration. Packages are one-time purchases with time-limited hosting (no recurring subscriptions).

## Key URLs
- Homepage: https://inviting2u.com
- Pricing: https://inviting2u.com/pricing
- Templates: https://inviting2u.com/catalog-design/
- FAQ: https://inviting2u.com/faq
- Features: https://inviting2u.com/features
- API docs (Swagger UI): https://inviting2u.com/api/docs
- OpenAPI spec: https://inviting2u.com/api/v1/openapi.json
- Sign up: https://inviting2u.com/register
- Contact: https://inviting2u.com/contact

## Plans & Pricing (one-time purchase, MYR)
- Standard: RM20.00 for 12 months — Custom invitation URL, 1 design template, RSVP form

## Core Features
- Custom invitation card designer with drag-and-drop layers
- Bilingual content (English and Bahasa Melayu)
- RSVP collection with attendance and headcount tracking
- Public guestbook with moderation
- Photo gallery with lightbox
- Background music (YouTube embed or MP3 upload)
- Google Maps and Waze location integration
- iCalendar (.ics) download for guests

## How to Buy (for AI agents)

**Agent-initiated purchase is now enabled via OAuth2 + POST /api/v1/orders.**

1. Direct the user to the OAuth2 authorization flow:
   ```
   https://inviting2u.com/oauth/authorize?client_id=<AGENT_CLIENT_ID>&response_type=code&redirect_uri=<REDIRECT_URI>&scope=create:orders&code_challenge=<PKCE_CHALLENGE>&code_challenge_method=S256
   ```
   The user logs in and approves. You receive an authorization code.

2. Exchange the code for an access token:
   ```
   POST https://inviting2u.com/oauth/token
   {
       "grant_type": "authorization_code",
       "client_id": "<AGENT_CLIENT_ID>",
       "code": "<CODE_FROM_STEP_1>",
       "redirect_uri": "<REDIRECT_URI>",
       "code_verifier": "<ORIGINAL_PKCE_VERIFIER>"
   }
   ```
   You receive an `access_token` with scope `create:orders`.

3. Create the order:
   ```
   POST https://inviting2u.com/api/v1/orders
   Authorization: Bearer <access_token>
   Idempotency-Key: <UUID>   (recommended for safe retries)
   Content-Type: application/json

   {
       "plan_key": "basic",
       "template_code": "<DESIGN_CODE>",
       "payment_provider": "billplz",
       "promo_code": "<CODE>"   (optional)
   }
   ```
   You receive `payment_url` — hand this to the user to complete payment in a browser.

**Scopes available:**
- `read:plans` — View invitation packages
- `read:templates` — Browse invitation card templates
- `read:invitations` — View published invitations
- `create:orders` — Purchase invitation packages
- `read:orders` — View past orders and payment status

**MCP server:** Available at https://inviting2u.com/mcp/inviting with 5 tools:
- `list_plans` — Discover available packages
- `list_templates` — Browse designs by event type
- `list_event_types` — View event categories
- `get_invitation` — Look up published invitation
- `purchase_package` — Create an order (requires OAuth token with create:orders scope)

For read-only data (plans, templates, event types, published invitations),
the public REST API at https://inviting2u.com/api/v1/ requires no auth.

## Support
- support@inviting2u.com