Squad API Documentation
  • Home
  • Payments
    • Initiate Payment
    • Direct API Integration
    • Squad Payment Modal
    • Verify Transaction
    • Aggregator and Sub-merchants
  • Verify Transaction
  • Webhook & Redirect URL
    • Signature validation
  • Virtual Accounts
  • Test Cards
  • Payment Link
  • Refund API
  • Squad Woo Commerce Plugin
  • Disputes & Chargebacks
  • Wallet Balance
  • Transfer API
  • Squad POS
    • Getting Started
    • API Documentation
  • VALUE ADDED SERVICES
    • Overview
    • AIRTIME AND DATA
    • SMS
      • BUCKET
      • TEMPLATES
      • MESSAGES
    • SMS V2
      • BUCKET
      • TEMPLATES
      • CAMPAIGNS
    • Utilities
      • Cable Subscription
      • Electricity Subscription
Powered by GitBook
On this page
  • API KEYS (Test Environment)
  • VEND AIRTIME
  • This API vends Airtime
  • Sample Request
  • VEND DATA BUNDLES
  • Sample Request
  • GET DATA BUNDLES
  • This API returns all available data bundle plans for all telcos
  • GET ALL TRANSACTIONS
  • This API returns all transactions done by a merchant.
  • GO LIVE

Was this helpful?

  1. VALUE ADDED SERVICES

AIRTIME AND DATA

These are suites of API that allows you vend airtime and data. Please note that the equivalent value of all data and airtime vended will be charged from your SQUAD WALLET.

API KEYS (Test Environment)

  1. Create an account on our sandbox environment: sandbox.squadco.com

  2. Retrieve keys from the bottom of the Get Started Page

Authorization Any request made without the authorization key (secret key) will fail with a 401 (Unauthorized) response code.

The authorization key is sent via the request header as Bearer Token Authorization

Example: Authorization: Bearer sandbox_sk_94f2b798466408ef4d19e848ee1a4d1a3e93f104046f

VEND AIRTIME

This API allows you vend airtime. Minimum amount that can be vended is 50 naira.

This API vends Airtime

POST https://sandbox-api-d.squadco.com/vending/purchase/airtime

Request Body

Name
Type
Description

phone_number*

String

11 digit phone number. Format: : "08139011943"

amount*

Integer

Amount is in Naira.

{

"status": 200,

"success": true,

"message": "Success",

"data": {

"reference": "app_08139011943_5000_1690387362399",

"amount": "5000.00",

"merchant_amount": "4900.00",

"phone_number": "08139011943",

"merchant_id": "T6AGJQEY",

"wallet_batch_id": "20230726160242715_490000_T6AGJQEY_AIRTIME_NGN",

"transaction_id": "app_08139011943_5000_1690387362399",

"type": "airtime",

"action": "debit",

"status": "pending",

"meta": "{\"vending_status\":\"pending\",\"status_code\":\"301\",\"message\":\"pending confirmation\",\"phonenumber\":\"08139011943\",\"transaction_id\":\"app_08139011943_5000_1690387362399\",\"network\":\"MTN\"}",

"createdAt": "2023-07-26T16:02:43.341Z"

}

}

{
    "success": false,
    "message": "",
    "data": {}
}
{
    "success": false,
    "message": "Merchant authentication failed",
    "data": {}
}

Sample Request

{

"phone_number": "08139011943",

"amount": 5000

}

VEND DATA BUNDLES

This API allows you vend data bundles.

POST https://sandbox-api-d.squadco.com/vending/purchase/data

This is the data bundle vending endpoint.

Request Body

Name
Type
Description

phone_number*

String

11 digit phone number. Format: : "08139011943"

plan_code*

String

The plan code is gotten from the Get Plan Code endpoint and usually in the format: "1001"

{
    "success": false,
    "message": "Merchant authentication failed",
    "data": {}
}
{
    "success": false,
    "message": "",
    "data": {}
}
{ 
    "status": 200, 
    "success": true, 
    "message": "Success", 
    "data": { 
        "reference": "app_7062918558_100_1001_1679914203047", 
        "amount": "100.00", 
        "merchant_amount": "98.00", 
        "phone_number": "+2347062918558", 
        "merchant_id": "AABBCCDDEEFFGGHHJJKK", 
        "wallet_batch_id": "BC8BE65JWG44ZW7AN9KG", 
        "transaction_id": "edf867fa-8ad6-4eac-bd87-6e5f8ec9b945", 
        "type": "data", 
        "action": "debit", 
        "status": "success", 
        "meta": "{\"vending_status\":\"success\",\"status_code\":\"200\",\"message\":\"successfully submitted for processing\",\"phonenumber\":\"07062918558\",\"transaction_id\":\"edf867fa-8ad6-4eac-bd87-6e5f8ec9b945\",\"network\":\"MTN\"}", 
        "createdAt": "2023-03-27T10:50:04.073Z" 
    } 
} 

Sample Request

{ 
    "phone_number": "07062918558", 
    "amount": 100, 
    "plan_code": "1001" 
} 

GET DATA BUNDLES

This API returns all available data bundle plans for all telcos

This API returns all available data bundle plans for all telcos

GET https://sandbox-api-d.squadco.com/vending/data-bundles?network=MTN

Query Parameters

Name
Type
Description

network*

String

Teleco ID: MTN, GLO, AIRTEL, 9MOBILE

{

"status": 200,

"success": true,

"message": "Success",

"data": [

{

"plan_name": "MTN data_plan",

"bundle_value": "100MB ",

"bundle_validity": " Daily Plan",

"bundle_description": " Daily Plan",

"bundle_price": "100",

"plan_code": "1001",

"network": "MTN"

},

{

"plan_name": "MTN data_plan",

"bundle_value": "200MB",

"bundle_validity": " 2-day Plan",

"bundle_description": " 2-day Plan",

"bundle_price": "200",

"plan_code": "1002",

"network": "MTN"

},

{

"plan_name": "MTN data_plan",

"bundle_value": "350MB",

"bundle_validity": " Weekly Plan",

"bundle_description": " Weekly Plan",

"bundle_price": "300",

"plan_code": "1003",

"network": "MTN"

},

{

"plan_name": "MTN data_plan",

"bundle_value": "750MB",

"bundle_validity": " 2-Week plan",

"bundle_description": " 2-Week plan",

"bundle_price": "500",

"plan_code": "1004",

"network": "MTN"

},

{

"plan_name": "MTN data_plan",

"bundle_value": "1500GB",

"bundle_validity": "365 days",

"bundle_description": "365 days",

"bundle_price": "450000",

"plan_code": "1111",

"network": "MTN"

}

]

}

{
    "success": false,
    "message": "",
    "data": {}
}
{
    "success": false,
    "message": "Merchant authentication failed",
    "data": {}
}

GET ALL TRANSACTIONS

This API returns all transactions done by a merchant.

This API returns all transactions done by a merchant.

GET https://api-d.squadco.com/vending/transactions?page=1&perPage=4&action=debit

Query Parameters

Name
Type
Description

page

integer

The page of the transaction you want to view

perPage

Integer

Number of transaction you want to view per page

action

string

The type of transaction you want to see: "debit"

{

"status": 200,

"success": true,

"message": "Success",

"data": {

"count": 5,

"rows": [

{

"reference": "app_08139011943_5000_1690387362399",

"amount": "5000.00",

"merchant_amount": "4900.00",

"phone_number": "08139011943",

"merchant_id": "T6AGJQEY",

"wallet_batch_id": "20230726160242715_490000_T6AGJQEY_AIRTIME_NGN",

"transaction_id": "app_08139011943_5000_1690387362399",

"type": "airtime",

"action": "debit",

"status": "pending",

"meta": "{\"vending_status\":\"pending\",\"status_code\":\"301\",\"message\":\"pending confirmation\",\"phonenumber\":\"08139011943\",\"transaction_id\":\"app_08139011943_5000_1690387362399\",\"network\":\"MTN\"}",

"createdAt": "2023-07-26T16:02:43.341Z"

},

{

"reference": "app_08132448598_500_1001_1690387247434",

"amount": "500.00",

"merchant_amount": "490.00",

"phone_number": "08132448598",

"merchant_id": "T6AGJQEY",

"wallet_batch_id": "20230726160047736_49000_T6AGJQEY_DATA__NGN",

"transaction_id": null,

"type": "data",

"action": "debit",

"status": "failed",

"meta": null,

"createdAt": "2023-07-26T16:00:48.212Z"

},

{

"reference": "app_08139011943_5000_1001_1690387152681",

"amount": "5000.00",

"merchant_amount": "4900.00",

"phone_number": "08139011943",

"merchant_id": "T6AGJQEY",

"wallet_batch_id": "20230726155914250_490000_T6AGJQEY_DATA__NGN",

"transaction_id": null,

"type": "data",

"action": "debit",

"status": "failed",

"meta": null,

"createdAt": "2023-07-26T15:59:15.602Z"

},

{

"reference": "app_08139011943_5000_1690363943917",

"amount": "5000.00",

"merchant_amount": "4900.00",

"phone_number": "08139011943",

"merchant_id": "T6AGJQEY",

"wallet_batch_id": "20230726093224159_490000_T6AGJQEY_AIRTIME_NGN",

"transaction_id": "app_08139011943_5000_1690363943917",

"type": "airtime",

"action": "debit",

"status": "pending",

"meta": "{\"vending_status\":\"pending\",\"status_code\":\"301\",\"message\":\"pending confirmation\",\"phonenumber\":\"08139011943\",\"transaction_id\":\"app_08139011943_5000_1690363943917\",\"network\":\"MTN\"}",

"createdAt": "2023-07-26T09:32:24.638Z"

}

]

}

}

{
    "success": false,
    "message": "",
    "data": {}
}
{
    "success": false,
    "message": "Merchant authentication failed",
    "data": {}
}

GO LIVE

To go live, simply: 1. Change the base URL for your endpoints from sandbox-api-d.squadco.com to api-d.squadco.com

3. Complete your KYC

4. Use the secret keys provided on the dashboard to authenticate your live transactions

PreviousOverviewNextSMS

Last updated 1 year ago

Was this helpful?

2.

Sign up on our Live Environment