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

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 - Advanced features and best practices

• API Reference - Integrate payments programmatically

• Fee Structure - 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.