API Reference Showmax

Showmax

Showmax Streaming Service 🎬 operates in two phases:

  1. Retrieve Product Codes – Fetch the available Showmax product codes.
  2. Vend – Complete the recharge transaction using the selected product code.
Showmax Get Packages
GET

Service Information

{{baseUrl}}showmax/packages
GET
Parameter Name Type M/O Description
loginId Numeric M Merchant id provided during integration
key String M Merchants (public) key 

{
    "loginId": "{{loginId}}",
    "key": "{{publicKey}}"
}
{
    "statusCode": "00",

    "statusDescription": {

    "items": [

    {
    "name": "Showmax Mobile",

    "subscriptionPeriod": 1,

    "price": 1200,

    "type": "mobile_only"

    }, {
    "name": "Showmax Mobile",

    "subscriptionPeriod": 3,

    "price": 2499,

    "type": "mobile_only"

    }, {
    "name": "Showmax Mobile",

    "subscriptionPeriod": 6,

    "price": 4299,

    "type": "mobile_only"

    }, {
    "name": "Showmax Mobile",

    "subscriptionPeriod": 12,

    "price": 7200,

    "type": "mobile_only"

    }, {
    "name": "Showmax",

    "subscriptionPeriod": 1,

    "price": 1200,

    "type": "full"

    }, {
    "name": "Showmax",

    "subscriptionPeriod": 3,

    "price": 5999,

    "type": "full"

    }, {
    "name": "Showmax",

    "subscriptionPeriod": 6,

    "price": 10400,

    "type": "full"

    }, {
    "name": "Showmax",

    "subscriptionPeriod": 12,

    "price": 17400,

    "type": "full"

    }, {
    "name": "Showmax Pro Mobile",

    "subscriptionPeriod": 1,

    "price": 3200,

    "type": "sports_mobile_only"

    }, {
    "name": "Showmax Pro Mobile",

    "subscriptionPeriod": 3,

    "price": 9600,

    "type": "sports_mobile_only"

    }, {
    "name": "Showmax Pro Mobile",

    "subscriptionPeriod": 6,

    "price": 19200,

    "type": "sports_mobile_only"

    }, {
    "name": "Showmax Pro Mobile",

    "subscriptionPeriod": 12,

    "price": 38400,

    "type": "sports_mobile_only"

    }, {
    "name": "Showmax Pro",

    "subscriptionPeriod": 1,

    "price": 6300,

    "type": "sports_full"

    }, {
    "name": "Showmax Pro",

    "subscriptionPeriod": 3,

    "price": 18900,

    "type": "sports_full"

    }, {
    "name": "Showmax Pro",

    "subscriptionPeriod": 6,

    "price": 37800,

    "type": "sports_full"

    }, {
    "name": "Showmax Pro",

    "subscriptionPeriod": 12,

    "price": 75600,

    "type": "sports_full" } ] } 
}
Showmax Recharge
POST

Service Information

{{baseUrl}}showmax/pay
POST
Parameter Name Type M/O Description
loginId Numeric M Merchant id provided during integration
key String M Merchants (public) key
ServiceId String M SOMX
customerNo String M Phone Number.
Amount Numeric M Amount of the package gotten from the get SHOWMAX package API Call
requestId Numeric M Unique transaction Id for the request. Maxlength (36characters)
subscriptionType Numeric M Type of Subscription, gotten from the get Packages API call
invoicePeriod Numeric M This is the value of subscriptionPeriod gotten from the get SHOWMAX package API call
packageName Numeric M Name of package gotten from the get SHOWMAX package API call 

{
    "loginId": "{{loginId}}",
    "key": "{{publicKey}}",
    "serviceId" : "SOMX",
    "customerNo":"09058639550",
    "amount": 100,
    "requestId" : "{{random12digit}}",
    "subscriptionType" : "mobile_only",
    "invoicePeriod" : "1",
    "packageName" : "Showmax Mobile"
}                              
                            
{
    "statusCode": "00",
    "statusDescription": "Successful",
    "status": true,
    "result": {
    "amount": "100.00",
    "message": "transaction Successful",
    "transId": "929281645462237",
    "date": "2022-02-21 16:50:40",
    "package": "Showmax Mobile",
    "subscriptionPeriod": "1",
    "subscriptionType": "mobile_only",
    "validUntil": "2025-02-21 16:50:39 UTC",
    "voucherCode": "788623",
    "captureUrl": "https://secure.showmax.io/payment/subscriptions/access_code" }
}