# Quick Start

This guide will help you set up MakaPay and accept your first payment in minutes.

## Prerequisites

* A cryptocurrency wallet (MetaMask, Coinbase Wallet, or WalletConnect-compatible)
* USDT for Gas Tank deposits (on MakaChain)

***

## Step 1: Create an Account

1. Visit <https://app.makapay.io>
2. Click **Sign Up** and connect your wallet or use email authentication
3. Complete the onboarding process

***

## Step 2: Fund Your Gas Tank

The Gas Tank is your unified gas balance for all payment settlements.

### Via Dashboard

1. Navigate to **Dashboard > Gas Tank**
2. Click **Deposit**
3. Copy the deposit address shown
4. Send USDT to the deposit address from your wallet
5. Wait for confirmation (typically 1-2 minutes)

### Minimum Deposit

* Recommended minimum: **$10 USDT**
* This covers approximately 50-100 payment settlements depending on network

***

## Step 3: Create Your First Payment

### Via Dashboard

1. Go to **Dashboard > Payments**
2. Click **Create Payment Link**
3. Fill in the details:
   * **Merchant Address**: Your wallet address to receive funds
   * **Network**: Select the blockchain (Ethereum, Polygon, BSC, MakaChain)
   * **Token**: Select the payment token (USDT, USDC, etc.)
   * **Amount**: The amount to charge
   * **Order ID**: Your internal reference (e.g., `order-123`)
   * **Description**: Optional description for the customer
4. Configure fee options:
   * **Gasless**: Fees deducted from payment (no Gas Tank needed)
   * **Payer Covers Fee**: Customer pays fees on top of amount
5. Click **Create**
6. Share the payment link or QR code with your customer

### Via API

```bash
curl -X POST https://app.makapay.io/api/payments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "merchant": "0xYourWalletAddress",
    "chainId": "137",
    "token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
    "amount": "100.00",
    "orderId": "order-123",
    "description": "Product purchase"
  }'
```

***

## Step 4: Monitor Payments

### Payment Statuses

| Status      | Description                                |
| ----------- | ------------------------------------------ |
| `pending`   | Awaiting customer payment                  |
| `paid`      | Payment received, awaiting confirmation    |
| `completed` | Payment settled to your wallet             |
| `expired`   | Payment link expired (24 hours)            |
| `cancelled` | Payment cancelled by merchant              |
| `failed`    | Settlement failed (check Gas Tank balance) |

### Real-Time Updates

The dashboard updates in real-time. You can also:

* Set up **webhooks** for programmatic notifications
* Use the **API** to poll payment status

***

## Step 5: Withdraw Funds

Payments are automatically settled to your merchant wallet address. No manual withdrawal required.

For partial payments or special cases, use the **Manual Withdraw** feature in the payment details.

***

## Next Steps

* [Merchant Guide](/guides/merchant-guide.md) - Advanced features and best practices
* [API Reference](/developers/api-reference.md) - Integrate payments programmatically
* [Fee Structure](/guides/fee-structure.md) - Understand pricing and optimize costs

***

## Troubleshooting

### Payment Stuck in "Pending"

* Verify the customer sent the correct amount to the correct address
* Check if the payment expired (24 hours)

### Payment Stuck in "Paid"

* Check your Gas Tank balance
* If insufficient, deposit more USDT to resume settlements

### "Awaiting Gas" Status

* Your Gas Tank balance is insufficient
* Deposit USDT to your Gas Tank to complete settlement

### Need Help?

Contact support through the dashboard or check our FAQ section.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.makapay.io/getting-started/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.