# Overview

# Plexy Overview

Plexy is a comprehensive payment gateway solution designed for businesses of all sizes, offering secure, reliable, and easy-to-integrate payment processing services. Whether you're a small business looking for quick setup or an enterprise requiring advanced customization, Plexy provides flexible integration options to meet your needs.

<CardGroup cols={2}>
<Card title="Fully Secure Payments" icon="material-two-tone-lock">
PCI DSS compliant infrastructure with industry-standard encryption and fraud protection.
</Card>
<Card title="All Major Payment Methods" icon="material-two-tone-credit_card">
Accept Visa, Mastercard, American Express, UnionPay, Apple Pay, and Google Pay™.
</Card>
<Card title="Multiple Integration Options" icon="material-two-tone-integration_instructions">
Choose from Hosted Checkout, SDKs, or Host-to-Host API based on your requirements.
</Card>
<Card title="Low, Transparent Pricing" icon="material-two-tone-attach_money">
Competitive rates with no hidden fees. Pay only for what you use.
</Card>
</CardGroup>

---

## Supported Payment Methods

All Plexy integration methods support the following payment options:

<Columns>
<Column>
**Card Networks**
- Visa
- Mastercard
- American Express
- UnionPay
</Column>
<Column>
**Digital Wallets**
- Apple Pay
- Google Pay™
</Column>
</Columns>

---

## Integration Methods

Plexy offers three integration approaches, each suited for different business needs and technical capabilities.

<Tabs>
<Tab title="Hosted Checkout">

### Hosted Checkout

The fastest and easiest way to start accepting payments. Plexy hosts the entire payment page on our secure domain.

**How it works:** Redirect customers to our hosted payment page, or embed it via iFrame. We handle PCI compliance, security, and payment form rendering.

<CardGroup cols={2}>
<Card title="API Integration" icon="material-two-tone-code">
Programmatically create payment sessions and redirect customers to complete payment.
</Card>
<Card title="Dashboard (No Code)" icon="material-two-tone-dashboard">
Create and manage Payment Links directly from the Plexy Dashboard — no coding required.
</Card>
</CardGroup>

<Accordion title="Key Features" icon="material-two-tone-star">

- **Quick Setup** — Go live in minutes with minimal development effort
- **Fully Hosted** — Payment page hosted on Plexy's secure domain
- **iFrame Support** — Optionally embed the checkout within your site
- **Customizable** — Match your brand colors and logo
- **Mobile Optimized** — Responsive design for all devices
- **No PCI Scope** — Plexy handles all sensitive card data

</Accordion>

<TipGood>Best for: Businesses that want to start accepting payments quickly without complex development.</TipGood>

<Accordion title="Google Pay™ Requirements for Hosted Checkout" icon="lucide-alert-circle" defaultOpen={false}>

:::warning
**Compliance Requirements**

By enabling Google Pay™ through Plexy's Hosted Checkout, you agree to:
- Adhere to the [Google Pay and Wallet API Acceptable Use Policy](https://payments.developers.google.com/terms/aup)
- Accept the terms defined in the [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos)

Failure to comply with these policies may result in suspension of Google Pay™ functionality.
:::

</Accordion>

</Tab>
<Tab title="SDK Integration">

### SDK Integration

Embed payment elements directly into your website or mobile app for a fully branded checkout experience.

**Available SDKs:**

<CardGroup cols={4}>
<Card title="Web SDK" icon="lucide-globe">
JavaScript/TypeScript
</Card>
<Card title="iOS SDK" icon="lucide-apple">
Swift 
</Card>
<Card title="Android SDK" icon="lucide-smartphone">
Kotlin
</Card>
<Card title="Flutter SDK" icon="lucide-layers">
Cross-platform
</Card>
</CardGroup>

<Accordion title="Key Features" icon="material-two-tone-star">

- **Native Experience** — Payment forms render directly on your site or app
- **Full Customization** — Complete control over UI/UX
- **Tokenization** — Securely tokenize cards without handling raw data
- **Pre-built Components** — Ready-to-use card input fields
- **Validation** — Real-time input validation and formatting

</Accordion>

:::warning
**Mobile Payment Methods:** To enable Apple Pay and Google Pay in mobile SDKs, merchants must obtain their own certificates from Apple and Google. Contact our support team for guidance on the certification process.
:::

<TipInfo>SDK integration requires more development effort but provides maximum flexibility for custom checkout flows.</TipInfo>

</Tab>
<Tab title="Host-to-Host (H2H)">

### Host-to-Host Integration

Direct server-to-server API integration for maximum control and flexibility. Card data is transmitted directly from your servers to Plexy's API.

<Accordion title="Key Features" icon="material-two-tone-star">

- **Full Control** — Build completely custom payment experiences
- **Direct API Access** — No UI components required
- **Advanced Features** — Access to all API capabilities
- **White-label** — Plexy is invisible to end customers

</Accordion>

:::danger
**PCI DSS Certification Required**

Host-to-Host integration requires your business to be PCI DSS certified, as you will be handling and transmitting raw card data. This is the most complex integration method and is recommended only for businesses with existing PCI compliance infrastructure.
:::

<TipBad>Not recommended for businesses without existing PCI DSS certification.</TipBad>

</Tab>
</Tabs>

---

## Choosing the Right Integration

| Feature | Hosted Checkout | SDK | Host-to-Host |
|---------|----------------|-----|--------------|
| **Development Effort** | Low | Medium | High |
| **PCI Compliance** | Not required | Not required | **Required** |
| **UI Customization** | Limited | High | Full |
| **Time to Go Live** | Hours | Days | Weeks |
| **Mobile Wallets** | ✓ Built-in | ✓ Requires certificates | ✓ Requires certificates |
| **Recommended For** | Quick start, SMBs | Custom UX, Apps | Enterprise, White-label |

:::tip
**Not sure which to choose?** Start with Hosted Checkout to quickly validate your payment flow, then migrate to SDK integration as your needs grow.
:::

---

## API Design

### Developer-Friendly

Plexy's API is designed to be intuitive and easy to integrate:

<CardGroup cols={2}>
<Card title="RESTful API" icon="material-two-tone-api">
Clean, predictable resource-oriented endpoints following REST best practices.
</Card>
<Card title="Webhooks" icon="material-two-tone-notifications_active">
Real-time event notifications for payment status changes and other events.
</Card>
<Card title="Sandbox Environment" icon="material-two-tone-science">
Full-featured test environment to develop and test your integration risk-free.
</Card>
<Card title="Comprehensive SDKs" icon="material-two-tone-code">
Official SDKs for Web, iOS, Android, and Flutter with complete documentation.
</Card>
</CardGroup>

### Example Request

```http
GET /v1/payment-links/:id
Accept: application/json
Authorization: Bearer {your_api_key}
```

### Core Operations

| Operation | Description |
|-----------|-------------|
| **Create** | Initialize a new payment session or payment link |
| **Get** | Retrieve payment details and status |
| **Update** | Modify payment link settings |
| **Cancel** | Cancel a pending payment |
| **Refund** | Process full or partial refunds |

---

## Security & Compliance

<CardGroup cols={3}>
<Card title="PCI DSS Compliant" icon="material-two-tone-verified_user">
Our payment infrastructure meets the highest PCI DSS security standards.
</Card>
<Card title="Fraud Protection" icon="material-two-tone-security">
Real-time transaction monitoring and advanced fraud detection algorithms.
</Card>
<Card title="Data Encryption" icon="material-two-tone-enhanced_encryption">
End-to-end encryption for all sensitive data in transit and at rest.
</Card>
</CardGroup>

---

## Getting Started

<Steps>
<Step title="Sign Up">
Contact us via the [Plexy](https://plexypay.com) website to create your merchant account.
</Step>
<Step title="Get API Credentials">
Access your API keys and configure your Sandbox environment in the Plexy Dashboard.
</Step>
<Step title="Choose Integration Method">
Select Hosted Checkout, SDK, or Host-to-Host based on your requirements.
</Step>
<Step title="Integrate & Test">
Follow our integration guides and test thoroughly in Sandbox mode.
</Step>
<Step title="Go Live">
Complete compliance review and switch to Production to start accepting real payments.
</Step>
</Steps>

---

## Quick Links

<CardGroup cols={3}>
<Card title="API Reference" icon="material-two-tone-menu_book" href="https://developer.plexy.money/">
Complete API documentation with request/response examples.
</Card>
<Card title="Webhooks" icon="material-two-tone-webhook" href="https://developer.plexy.money/webhooks">
Learn how to receive real-time payment notifications.
</Card>
<Card title="SDK Guides" icon="material-two-tone-library_books" href="https://developer.plexy.money/sdk">
Step-by-step integration guides for all platforms.
</Card>
</CardGroup>

---

## Need Help?

<CardGroup cols={2}>
<Card title="Developer Support" icon="material-two-tone-support_agent">
Contact our technical team at **developers@plexy.money** for integration assistance.
</Card>
<Card title="Sales Inquiries" icon="material-two-tone-contact_mail">
Reach out to **request.kz@plexy.money** for pricing and partnership opportunities.
</Card>
</CardGroup>