Services How it works Why us Reviews FAQ
Log in Get Started

API Documentation

Complete reference for all API integrations in the 1SMM platform.

SMM Provider API

Fetches the SMM service catalogue and places / status-checks orders.

Service Class

Modules/SMM/Services/SMMApiService.php

Config File

Modules/SMM/Config/smm.php

Environment Variables

SMM_API_PROVIDER=default
SMM_API_BASE_URL=https://your-smm-provider.com/api/v2
SMM_API_KEY=your_api_key_here

API Endpoints

POST /api/v2

Standard SMM panel API endpoint. All requests use POST with form parameters.

Request Parameters

Parameter Type Description
key string Your API key
action string Action to perform (e.g., 'services', 'order', 'status')
service integer Service ID (for order action)
link string Target link (for order action)
quantity integer Order quantity (for order action)
order integer Order ID (for status action)

SMS Activation API

Buys virtual numbers and retrieves SMS verification codes.

Service Class

Modules/SMS/Services/SMSService.php

Config File

Modules/SMS/Config/sms.php

Environment Variables

SMS_DEFAULT_PROVIDER=sms_activate
SMS_ACTIVATE_BASE_URL=https://api.sms-activate.org/stubs/handler_api.php
SMS_ACTIVATE_API_KEY=your_api_key_here
FIVESIM_BASE_URL=https://5sim.net/v1
FIVESIM_API_KEY=your_api_key_here
SMSMAN_BASE_URL=https://api.sms-man.com/control
SMSMAN_API_KEY=your_api_key_here

Supported Providers

SMS-Activate

sms_activate

5SIM

5sim

SMS-Man

sms_man

API Endpoints

GET /api/v1/user/countries

Get list of available countries.

GET /api/v1/user/services

Get list of available services.

POST /api/v1/user/number

Purchase a virtual number.

GET /api/v1/user/status/{id}

Check SMS activation status.

Account Marketplace API

Lists, fetches and delivers marketplace accounts.

Service Class

Modules/Account/Services/AccountApiService.php

Config File

Modules/Account/Config/account.php

Environment Variables

ACCOUNT_API_URL=https://your-account-api.com/api
ACCOUNT_API_KEY=your_api_key_here

API Endpoints

GET /api/accounts

Get list of available accounts.

GET /api/accounts/{id}

Get details of a specific account.

POST /api/accounts/{id}/purchase

Purchase an account.

Payment Gateway API

Initialises wallet deposits and verifies payment webhooks.

Service Class

Modules/Payment/Services/PaymentGatewayService.php

Config File

Modules/Payment/Config/payment.php

Environment Variables

PAYMENT_GATEWAY=paystack
PAYSTACK_PUBLIC_KEY=pk_test_xxx
PAYSTACK_SECRET_KEY=sk_test_xxx
PAYSTACK_CURRENCY=NGN
FLUTTERWAVE_PUBLIC_KEY=FLWPUBK-xxx
FLUTTERWAVE_SECRET_KEY=FLWSECK-xxx
FLUTTERWAVE_ENCRYPTION_KEY=xxx
FLUTTERWAVE_CURRENCY=NGN
MONNIFY_CONTRACT_CODE=xxx
MONNIFY_API_KEY=xxx
MONNIFY_SECRET_KEY=xxx
MONNIFY_CURRENCY=NGN

Supported Gateways

Paystack

paystack

Flutterwave

flutterwave

Monnify

monnify

API Endpoints

POST /payment/initialize

Initialize a deposit transaction. Returns payment URL.

GET /payment/callback/{gateway}

Payment gateway callback URL for verification.

POST /payment/webhook/{gateway}

Webhook endpoint for payment notifications.

Affiliate API (Internal)

Exposes affiliate stats, referrals, commissions and withdrawals to the SPA. Authenticated via Laravel Sanctum.

Route File

Modules/Affiliate/Routes/api.php

Config File

Modules/Affiliate/Config/affiliate.php

API Endpoints

GET /api/affiliate/stats

Get affiliate statistics (clicks, conversions, earnings).

GET /api/affiliate/referrals

Get list of referrals.

GET /api/affiliate/commissions

Get commission history.

POST /api/affiliate/withdraw

Request a withdrawal.

Authentication

All API requests require authentication. Use one of the following methods:

Bearer Token (Sanctum)

Authorization: Bearer {your-api-token}

API Key Header

X-API-Key: {your-api-key}

You can generate API keys from your profile page after logging in.

Getting Started

  1. Sign up for an account and verify your email.
  2. Navigate to Profile → API Keys to generate your API key.
  3. Include the API key in the Authorization header as a Bearer token.
  4. Make requests to the appropriate endpoints listed above.
  5. Check the response format and handle errors appropriately.

Need Help?

Contact support if you need assistance with API integration or have questions about specific endpoints.