IUC / Smart Card Validation

Validate a decoder smart card or IUC number to confirm the customer details before processing a cable subscription.

Endpoint

GET https://example.com/api/validate_icu

Request Headers

{
  "Accept": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}

Query Parameters

Parameter	Type	Required	Description
smart_card_number	string	Yes	The decoder smart card / IUC number to validate
cable_name	string	Yes	Cable provider name (e.g., "DSTV", "GOTV", "STARTIME")

Example Request

curl -X GET "https://example.com/api/validate_icu?smart_card_number=1234567890&cable_name=DSTV" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response

Success (200)

{
  "status": "success",
  "name": "John Doe",
  "address": "123 Main Street, Lagos",
  "plan": "DStv Compact"
}

Error (422)

When the smart card number is invalid or cannot be verified:

{
  "message": "The given data was invalid.",
  "errors": {
    "status": ["Invalid Smart Card Number"]
  }
}

Response Fields

Field	Type	Description
status	string	"success" if validated
name	string	Subscriber name registered on the decoder
address	string	Subscriber address
plan	string	Current subscription plan

Best Practices

• Always validate before calling the Cable Subscription endpoint
• Display the returned name for user confirmation before processing payment