Authentication
All endpoints require an API token in the Authorization header using Bearer scheme.
Headers
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
Response Format
All responses return for both Successful and Failed Transaction:
{
"success": true,
"message": "....",
"data": { }
}
{
"success": false,
"message": "....",
"data": { }
}
Plans (Live from Database)
Source Table: data_one
Types: sme • bucket • pin
Total: 31
Use these plans with action=get_plans (data_type=sme) and purchase with action=buy_data.
| ID |
Network |
Bundle |
User |
Vendor |
Dealer |
Franchise |
| 87 |
9-MOBILE |
5GB |
2200 |
2100 |
2000 |
1900 |
| 86 |
9-MOBILE |
3GB |
1400 |
1300 |
1200 |
1100 |
| 85 |
9-MOBILE |
1GB |
500 |
450 |
400 |
400 |
| 84 |
9-MOBILE |
500MB |
250 |
230 |
200 |
200 |
| 83 |
GLO |
5GB |
2500 |
2400 |
2300 |
2200 |
| 82 |
GLO |
3GB |
1900 |
1800 |
1500 |
1400 |
| 81 |
GLO |
1GB |
600 |
550 |
500 |
450 |
| 80 |
GLO |
500MB |
310 |
300 |
280 |
250 |
| 79 |
AIRTEL |
8GB |
3600 |
3300 |
3200 |
3150 |
| 78 |
AIRTEL |
2GB |
1750 |
1700 |
1600 |
1570 |
| 77 |
AIRTEL |
1GB |
980 |
950 |
900 |
880 |
| 76 |
AIRTEL |
500MB |
650 |
600 |
560 |
550 |
| 69 |
MTN |
5GB |
1300 |
1300 |
1260 |
1260 |
| 68 |
MTN |
3GB |
1200 |
1150 |
1100 |
1100 |
| 67 |
MTN |
2GB |
950 |
900 |
820 |
820 |
| 66 |
MTN |
1GB |
400 |
400 |
400 |
400 |
| 64 |
MTN |
500MB |
380 |
360 |
350 |
330 |
Bucket plans deduct from bucket using the size field. Purchase with action=buy_bucket.
| ID |
Network |
Bundle |
Bucket Size (Deduct) |
User |
Vendor |
Dealer |
Franchise |
| 72 |
MTN |
5GB |
5000 |
1100 |
1100 |
1100 |
1100 |
PIN plans are used for PIN generation requests. Use with action=buy_pin and provide quantity.
| ID |
Network |
Bundle |
User |
Vendor |
Dealer |
Franchise |
| 95 |
GLO |
5GB |
2500 |
0 |
2300 |
2200 |
| 94 |
GLO |
3GB |
1900 |
0 |
1500 |
1400 |
| 93 |
GLO |
1GB |
610 |
0 |
510 |
460 |
| 92 |
GLO |
500MB |
320 |
0 |
290 |
260 |
| 91 |
AIRTEL |
8GB |
3100 |
3100 |
3100 |
3100 |
| 90 |
AIRTEL |
2GB |
1600 |
1600 |
1600 |
1600 |
| 89 |
AIRTEL |
1GB |
900 |
900 |
900 |
900 |
| 88 |
AIRTEL |
500MB |
600 |
600 |
600 |
600 |
| 75 |
MTN |
5GB |
1450 |
0 |
1300 |
1270 |
| 74 |
MTN |
3GB |
1250 |
1200 |
1150 |
1150 |
| 73 |
MTN |
2GB |
910 |
900 |
890 |
870 |
| 71 |
MTN |
1GB |
500 |
460 |
420 |
410 |
| 70 |
MTN |
500MB |
390 |
370 |
360 |
340 |
Endpoints
POST
https://rcards.com.ng/api/pay
action=get_plans
Fetch plans from API (client-side). Use data_type: sme | bucket | pin (optional: network).
{
"action": "get_plans",
"data_type": "sme",
"network": "MTN"
}
POST
https://rcards.com.ng/api/pay
action=buy_data
Buy SME/regular data.
{
"action": "buy_data",
"network": "MTN",
"plan_id": 12,
"phone": "08012345678"
}
POST
https://rcards.com.ng/api/pay
action=buy_bucket
Buy using bucket balance.
{
"action": "buy_bucket",
"network": "GLO",
"plan_id": 55,
"phone": "08012345678"
}
POST
https://rcards.com.ng/api/pay
action=buy_pin
Request PIN generation.
{
"action": "buy_pin",
"network": "MTN",
"plan_id": 77,
"quantity": 10,
"company_name": "Example Ltd",
"support": "08000000000",
"email": "
[email protected]"
}
POST
https://rcards.com.ng/api/pay
action=balance
Fetch wallet/bucket balance and membership.
{
"action": "balance"
}
cURL Example
curl -X POST "https://rcards.com.ng/api/pay" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"action":"get_plans",
"data_type":"sme",
"network":"MTN"
}'