API Documentation - RYPAY DIGITAL

RYPAY DIGITAL API Documentation

Complete REST API reference for integrating RYPAY DIGITAL payment gateway with your earning platform. All API endpoints return JSON responses.

Authentication

Every API request must include your API Key and API Secret. You can find these in your merchant dashboard under Settings > Account Info.

Parameter	Type	Description	Required
api_key	string	Your unique API Key (32 chars)	Required
api_secret	string	Your API Secret for sensitive operations	Required

Base URL

https://rypay.xyz/api/v1/

All endpoints are relative to this base URL.

Response Format

All responses are in JSON format with the following structure:

Success Response

{
  "success": true,
  "data": { ... },
  "message": "Operation successful"
}

Error Response

{
  "success": false,
  "message": "Error description here"
}

Error Codes

Code	Message	Description
401	Invalid API key	API key is missing or invalid
402	Insufficient balance	Not enough balance for operation
404	Not found	Requested resource not found
422	Validation error	Missing or invalid parameters
429	Rate limit	Too many requests, slow down
500	Server error	Internal server error

Check Balance

Get your merchant account balance information.

POST/api/v1/balance

Request Parameters

Parameter	Type	Description	Required
api_key	string	Your API Key	Required
api_secret	string	Your API Secret	Required

Example Request

cURL

curl -X POST https://rypay.xyz/api/v1/balance \
  -d "api_key=YOUR_API_KEY" \
  -d "api_secret=YOUR_API_SECRET"

Example Response

{
  "success": true,
  "data": {
    "main_balance": 5000.00,
    "ads_balance": 150.50,
    "smm_balance": 200.00,
    "offer_balance": 100.00,
    "total_deposits": 25000.00,
    "total_withdraws": 18000.00
  }
}

Process Deposit

Record a user deposit transaction on your platform.

POST/api/v1/deposit

Parameter	Type	Description	Required
api_key	string	Your API Key	Required
api_secret	string	Your API Secret	Required
user_id	integer	User ID on your platform	Required
amount	decimal	Deposit amount in BDT	Required
method	string	Payment method (bkash/nagad/rocket)	Required
transaction_id	string	Transaction reference ID	Required
sender_number	string	Sender's phone number	Optional

cURL

curl -X POST https://rypay.xyz/api/v1/deposit \
  -d "api_key=YOUR_API_KEY" \
  -d "api_secret=YOUR_API_SECRET" \
  -d "user_id=12345" \
  -d "amount=500" \
  -d "method=bkash" \
  -d "transaction_id=TRX789012"

{
  "success": true,
  "deposit_id": 456,
  "amount": 500,
  "message": "Deposit recorded successfully"
}

Process Withdrawal

Record a user withdrawal request.

POST/api/v1/withdraw

Parameter	Type	Description	Required
api_key	string	Your API Key	Required
api_secret	string	Your API Secret	Required
user_id	integer	User ID on your platform	Required
amount	decimal	Withdrawal amount in BDT	Required
method	string	Payment method (bkash/nagad/rocket)	Required
account_number	string	Receiver account number	Required
account_holder	string	Account holder name	Optional

cURL

curl -X POST https://rypay.xyz/api/v1/withdraw \
  -d "api_key=YOUR_API_KEY" \
  -d "api_secret=YOUR_API_SECRET" \
  -d "user_id=12345" \
  -d "amount=200" \
  -d "method=bkash" \
  -d "account_number=01712345678"

{
  "success": true,
  "withdraw_id": 789,
  "amount": 200,
  "fee": 6,
  "net_amount": 194,
  "message": "Withdrawal recorded"
}

SMM Service List

Get all available SMM services with pricing.

GET/api/v1/smm/services?api_key=YOUR_API_KEY

cURL

curl "https://rypay.xyz/api/v1/smm/services?api_key=YOUR_API_KEY"

{
  "success": true,
  "services": [
    {
      "id": 123,
      "name": "YouTube Views",
      "category": "youtube",
      "rate": "BDT 280.00",
      "min": 100,
      "max": 100000
    }
  ],
  "count": 500
}

Place SMM Order

POST/api/v1/smm/order

Parameter	Type	Description	Required
api_key	string	Your API Key	Required
service_id	integer	Service ID from service list	Required
link	string	Target URL for the service	Required
quantity	integer	Order quantity	Required

{
  "success": true,
  "order_id": 99999,
  "charge": 280.00,
  "message": "Order placed successfully"
}

SMM Order Status

GET/api/v1/smm/status?api_key=KEY&order_id=99999

{
  "success": true,
  "order_id": 99999,
  "status": "completed",
  "start_count": 0,
  "remains": 0
}

Track Ad Impression/Click

GET/api/v1/ads/track?api_key=KEY&action=impression

Parameter	Type	Description	Required
api_key	string	Your API Key	Required
action	string	impression / click / stats	Required

{
  "success": true,
  "cpm": 5.00,
  "revenue": "0.0050",
  "impression": "tracked"
}

Ads Statistics

GET/api/v1/ads/stats?api_key=KEY

{
  "success": true,
  "stats": {
    "total_impressions": 50000,
    "total_clicks": 1200,
    "total_revenue": 250.5000,
    "cpm": 5.00
  }
}

Apply for Loan

POST/api/v1/loan/apply

Parameter	Type	Description	Required
api_key	string	Your API Key	Required
user_id	integer	User ID	Required
amount	decimal	Loan amount (Min 12000)	Required
phone	string	Phone number	Required
email	string	Email address	Required

{
  "success": true,
  "loan_id": 55,
  "amount": 12000,
  "deposit": 2400,
  "total_repayable": 13200,
  "monthly": 2200
}

Loan Status

GET/api/v1/loan/status?api_key=KEY&loan_id=55

{
  "success": true,
  "loan": { "status": "active", "amount": 12000, "total_repayable": 13200 },
  "installments": [ ... ]
}

Loan History

GET/api/v1/loan/history?api_key=KEY&user_id=12345

{
  "success": true,
  "loans": [
    { "amount": 12000, "status": "paid", "total_repayable": 13200 }
  ]
}

Offer List

GET/api/v1/offer/list?api_key=YOUR_API_KEY

{
  "success": true,
  "offers": [
    {
      "id": 1,
      "sim": "GP",
      "name": "49 TK - 5GB Internet",
      "details": "5GB Data + 100 Min Talktime",
      "validity": "7 Days",
      "base_price": 49.00,
      "final_price": 53.90
    }
  ],
  "profit_percent": 10
}

Place Offer Order

POST/api/v1/offer/order

Parameter	Type	Description	Required
api_key	string	Your API Key	Required
offer_id	integer	Offer ID from list	Required
phone_number	string	Valid 11-digit number	Required

{
  "success": true,
  "order_id": 88,
  "amount": 53.90,
  "phone": "01712345678",
  "offer": "49 TK - 5GB Internet",
  "sim": "GP"
}

Get Account Prices

GET/api/v1/account/price?api_key=KEY

{
  "success": true,
  "prices": {
    "gmail": 100.00,
    "facebook": 150.00,
    "youtube": 200.00,
    "tiktok": 120.00,
    "instagram": 130.00
  }
}

Sell Account

POST/api/v1/account/sell

Parameter	Type	Description	Required
api_key	string	Your API Key	Required
user_id	integer	Seller user ID	Required
platform	string	gmail/facebook/youtube/tiktok/instagram	Required
title	string	Account title	Required
email	string	Account email	Required
password	string	Account password	Required

{
  "success": true,
  "sale_id": 123,
  "price": 150.00,
  "message": "Account listed for sale"
}