> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pay.plexos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Make your first API call in 5 minutes

## Prerequisites

<Steps>
  <Step title="Get your API key">
    Sign up at [dashboard.plexospay.com](https://dashboard.plexospay.com) and create a test API key.
    Your test key starts with `sk_test_`.
  </Step>

  <Step title="Make your first payment">
    Run this cURL command to create a payment:

    ```bash theme={null}
    curl -X POST https://api.plexospay.com/v1/payments \
      -H "Authorization: Bearer sk_test_YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "amount": 10000,
        "operator": "MOCK",
        "operatorPhone": "+2389001234",
        "description": "My first payment"
      }'
    ```

    <Info>Use the `MOCK` operator for testing. It simulates the full payment flow without real mobile money charges.</Info>
  </Step>

  <Step title="Check the response">
    You'll receive a response like this:

    ```json theme={null}
    {
      "id": "pi_abc123def456",
      "amount": "10000",
      "currency": "CVE",
      "feeAmount": "200",
      "netAmount": "9800",
      "operator": "MOCK",
      "operatorPhone": "+2389001234",
      "status": "CREATED",
      "description": "My first payment",
      "createdAt": "2025-01-15T10:30:00.000Z",
      "updatedAt": "2025-01-15T10:30:00.000Z"
    }
    ```
  </Step>

  <Step title="Confirm the payment (sandbox)">
    In sandbox mode, simulate the customer confirming:

    ```bash theme={null}
    curl -X POST https://api.plexospay.com/v1/payments/pi_abc123def456/confirm \
      -H "Authorization: Bearer sk_test_YOUR_API_KEY"
    ```

    The payment status will change to `DEBITED`.
  </Step>
</Steps>

## Or Use a Checkout Session

Create a shareable payment link instead of handling the flow yourself:

```bash theme={null}
curl -X POST https://api.plexospay.com/v1/checkout/sessions \
  -H "Authorization: Bearer sk_test_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25000,
    "returnUrl": "https://myshop.com/thanks"
  }'
```

The response includes a `url` field — share it with the customer to complete payment.

## Next Steps

<CardGroup cols={2}>
  <Card title="Use an SDK" icon="puzzle-piece" href="/pages/sdks/overview">
    Install the Node.js, Python, or Java SDK
  </Card>

  <Card title="Set up Webhooks" icon="bell" href="/pages/webhooks">
    Get notified when payments complete
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Explore every endpoint
  </Card>

  <Card title="Dev Mode" icon="flask" href="/pages/devmode">
    Learn about sandbox testing
  </Card>
</CardGroup>