Imported data
Get service barring detail
PATH PARAMETERS
Service type indicator
Service identifier whose barring will be updated
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
OK Successfully getting barring detail
{
"subscriptionId": 234234234,
"appliedBarringsMaskCodes": [
"DEBT_MOBILE_LP"
]
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
subscriptionId
*
| integer (int64) | Code string for subscription id | ||
appliedBarringsMaskCodes
*
| string[] | applied barrings for subscription id |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X GET 'https://partners.sta.masstack.com/v3/mobile/612123456/barrings' \
-H 'Request-Correlation-Id: string' \
-H 'Accept: application/json'Update service barring
PATH PARAMETERS
Service type indicator
Service identifier whose barring will be updated
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Contain barring to be updated, the value to be set and the callbacks to be used
{
"callback_success_url": "https://myserver.com/send/callback/here",
"callback_error_url": "https://myserver.com/send/callback/here",
"active": true,
"barring_name": "ROAMING"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
callback_success_url
*
| string (uri) | |||
callback_error_url
*
| string (uri) | |||
active
*
| boolean | |||
barring_name
*
| string
()
ROAMINGINTERNATIONAL_DESTINATIONSOUTGOING_VOICEOUTGOING_SMSINCOMING_VOICEINCOMING_SMSINTERNETVOICE_PREMIUM_ENTERTAINMENTVOICE_PREMIUM_INFORMATIONSMS_PREMIUMSUBSCRIPTION_PREMIUM | Name of the barring to be updated |
Accepted The operation request was successfully accepted, returned the request external reference identifier
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Request-Correlation-IdRequest-Correlation-Id-Responsecurl -X PATCH 'https://partners.sta.masstack.com/v3/mobile/612123456/barrings' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"callback_success_url": "https://myserver.com/send/callback/here",
"callback_error_url": "https://myserver.com/send/callback/here",
"active": true,
"barring_name": "ROAMING"
}'Create movement for non subscribable services
PATH PARAMETERS
Service type indicator
Service identifier for movement creation
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Contains movement information to be created
{
"type": "RECURRING_CHARGE",
"movement_datetime": "2022-02-24T13:45:10Z",
"period_start_datetime": "2022-01-31T23:00:00Z",
"period_end_datetime": "2022-02-28T23:00:00Z",
"amount": {
"value_with_taxes": 12.1,
"value_without_taxes": 10,
"tax": {
"type": "IVA",
"percentage": 21
}
},
"external_invoice_id": "123456789",
"external_movement_unique_id": "123456789",
"transaction_type_id": "5432167890",
"description": "February invoice"
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
type
*
| string
()
RECURRING_CHARGEONE_TIME_FEEINSTALLATION_FEESUSPENSION_SERVICE_FEEUNRETURNED_EQUIPMENT_FEEDISCOUNT | |||||||||||||||||||||||||||||||||||||||||||
movement_datetime
*
| string (date-time) | |||||||||||||||||||||||||||||||||||||||||||
period_start_datetime | string (date-time) | Mandatory just if period_end_datetime is set | ||||||||||||||||||||||||||||||||||||||||||
period_end_datetime | string (date-time) | Mandatory just if period_start_datetime is set | ||||||||||||||||||||||||||||||||||||||||||
amount
*
| object | |||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
external_invoice_id | string | this field is informative. We are not doing any further processing apart from persisting it | ||||||||||||||||||||||||||||||||||||||||||
external_movement_unique_id
*
| string | |||||||||||||||||||||||||||||||||||||||||||
transaction_type_id
*
| string | |||||||||||||||||||||||||||||||||||||||||||
description | string | |||||||||||||||||||||||||||||||||||||||||||
Created Successfully created the operation request, returned the result
{
"code": "CREATED",
"title": "Movement created correctly",
"movement_id": "8da2b117-ef72-413d-98ce-36d1eb544e44"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Code string for fast identification | ||
title
*
| string | Message description | ||
movement_id
*
| string | Identifier of the created movement |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found
{
"code": "NOT_FOUND",
"title": "Msisdn not found: 100000000"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X POST 'https://partners.sta.masstack.com/v3/mobile/612123456/billing/movements-non-subscribable-services' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"type": "RECURRING_CHARGE",
"movement_datetime": "2022-02-24T13:45:10Z",
"period_start_datetime": "2022-01-31T23:00:00Z",
"period_end_datetime": "2022-02-28T23:00:00Z",
"amount": {
"value_with_taxes": 12.1,
"value_without_taxes": 10,
"tax": {
"type": "IVA",
"percentage": 21
}
},
"external_invoice_id": "123456789",
"external_movement_unique_id": "123456789",
"transaction_type_id": "5432167890",
"description": "February invoice"
}'Update movement for non subscribable services
PATH PARAMETERS
Service type indicator
Service identifier for movement update
Movement to be updated identifier
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Contains movement information to be updated
{
"type": "RECURRING_CHARGE",
"movement_datetime": "2022-02-24T13:45:10Z",
"period_start_datetime": "2022-01-31T23:00:00Z",
"period_end_datetime": "2022-02-28T23:00:00Z",
"amount": {
"value_with_taxes": 12.1,
"value_without_taxes": 10,
"tax": {
"type": "IVA",
"percentage": 21
}
},
"external_invoice_id": "123456789",
"external_movement_unique_id": "123456789",
"transaction_type_id": "5432167890",
"description": "February invoice"
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
type
*
| string
()
RECURRING_CHARGEONE_TIME_FEEINSTALLATION_FEESUSPENSION_SERVICE_FEEUNRETURNED_EQUIPMENT_FEEDISCOUNT | |||||||||||||||||||||||||||||||||||||||||||
movement_datetime
*
| string (date-time) | |||||||||||||||||||||||||||||||||||||||||||
period_start_datetime | string (date-time) | Mandatory just if period_end_datetime is set | ||||||||||||||||||||||||||||||||||||||||||
period_end_datetime | string (date-time) | Mandatory just if period_start_datetime is set | ||||||||||||||||||||||||||||||||||||||||||
amount
*
| object | |||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
external_invoice_id | string | this field is informative. We are not doing any further processing apart from persisting it | ||||||||||||||||||||||||||||||||||||||||||
external_movement_unique_id
*
| string | |||||||||||||||||||||||||||||||||||||||||||
transaction_type_id
*
| string | |||||||||||||||||||||||||||||||||||||||||||
description | string | |||||||||||||||||||||||||||||||||||||||||||
OK Successfully updated the movement.
{
"code": "CREATED",
"title": "Movement updated correctly"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Code string for fast identification | ||
title
*
| string | Message description |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found
{
"code": "NOT_FOUND",
"title": "Msisdn not found: 100000000"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X PUT 'https://partners.sta.masstack.com/v3/mobile/612123456/billing/movements-non-subscribable-services/4d9d437f-ef3b-41e7-b474-067b1917cc4e' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"type": "RECURRING_CHARGE",
"movement_datetime": "2022-02-24T13:45:10Z",
"period_start_datetime": "2022-01-31T23:00:00Z",
"period_end_datetime": "2022-02-28T23:00:00Z",
"amount": {
"value_with_taxes": 12.1,
"value_without_taxes": 10,
"tax": {
"type": "IVA",
"percentage": 21
}
},
"external_invoice_id": "123456789",
"external_movement_unique_id": "123456789",
"transaction_type_id": "5432167890",
"description": "February invoice"
}'Delete movement for non subscribable services
PATH PARAMETERS
Service type indicator
Service identifier for the movement to be deleted
Movement to be updated identifier
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
OK Successfully deleted de movement resource
{
"code": "DELETED",
"title": "Movement deleted correctly"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Code string for fast identification | ||
title
*
| string | Message description |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found
{
"code": "NOT_FOUND",
"title": "Msisdn not found: 100000000"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X DELETE 'https://partners.sta.masstack.com/v3/mobile/612123456/billing/movements-non-subscribable-services/4d9d437f-ef3b-41e7-b474-067b1917cc4e' \
-H 'Request-Correlation-Id: string' \
-H 'Accept: application/json'Create refund for non subscribable services
PATH PARAMETERS
Service type indicator
Service identifier for refund creation
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Contains refund information to be created
{
"refund_datetime": "2022-02-24T13:45:10Z",
"period_start_datetime": "2022-01-31T23:00:00Z",
"period_end_datetime": "2022-02-28T23:00:00Z",
"amount": {
"value_with_taxes": 12.1,
"value_without_taxes": 10,
"tax": {
"type": "IVA",
"percentage": 21
}
},
"external_invoice_id": "123456789",
"external_refund_unique_id": "123456789",
"transaction_type_id": "5432167890",
"movement_id": "5432167890",
"description": "February invoice"
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
refund_datetime
*
| string (date-time) | |||||||||||||||||||||||||||||||||||||||||||
period_start_datetime | string (date-time) | Mandatory just if period_end_datetime is set | ||||||||||||||||||||||||||||||||||||||||||
period_end_datetime | string (date-time) | Mandatory just if period_start_datetime is set | ||||||||||||||||||||||||||||||||||||||||||
amount
*
| object | |||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
external_invoice_id | string | this field is informative. We are not doing any further processing apart from persisting it | ||||||||||||||||||||||||||||||||||||||||||
external_refund_unique_id | string | |||||||||||||||||||||||||||||||||||||||||||
transaction_type_id
*
| string | |||||||||||||||||||||||||||||||||||||||||||
movement_id
*
| string | |||||||||||||||||||||||||||||||||||||||||||
description | string | |||||||||||||||||||||||||||||||||||||||||||
Created Successfully accepted the operation request, returned the result
{
"code": "CREATED",
"title": "Refund created correctly",
"refund_id": "8da2b117-ef72-413d-98ce-36d1eb544e44"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Code string for fast identification | ||
title | string | Message description | ||
refund_id
*
| string | Identifier of the created refund |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found
{
"code": "NOT_FOUND",
"title": "Msisdn not found: 100000000"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X POST 'https://partners.sta.masstack.com/v3/mobile/612123456/billing/refund-non-subscribable-services' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"refund_datetime": "2022-02-24T13:45:10Z",
"period_start_datetime": "2022-01-31T23:00:00Z",
"period_end_datetime": "2022-02-28T23:00:00Z",
"amount": {
"value_with_taxes": 12.1,
"value_without_taxes": 10,
"tax": {
"type": "IVA",
"percentage": 21
}
},
"external_invoice_id": "123456789",
"external_refund_unique_id": "123456789",
"transaction_type_id": "5432167890",
"movement_id": "5432167890",
"description": "February invoice"
}'Create movement for services
PATH PARAMETERS
Service type indicator
Service identifier for movement creation
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Contains movement information to be created
{
"type": "RECURRING_CHARGE",
"movement_datetime": "2022-02-24T13:45:10Z",
"period_start_datetime": "2022-01-31T23:00:00Z",
"period_end_datetime": "2022-02-28T23:00:00Z",
"amount": {
"value_with_taxes": 12.1,
"value_without_taxes": 10,
"tax": {
"type": "IVA",
"percentage": 21
}
},
"external_invoice_id": "123456789",
"external_movement_unique_id": "123456789",
"billable": false,
"concept_id": "5432167890",
"description": "February invoice"
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
type
*
| string
()
RECURRING_CHARGEONE_TIME_FEEINSTALLATION_FEESUSPENSION_SERVICE_FEEUNRETURNED_EQUIPMENT_FEEDISCOUNT | |||||||||||||||||||||||||||||||||||||||||||
movement_datetime
*
| string (date-time) | |||||||||||||||||||||||||||||||||||||||||||
period_start_datetime | string (date-time) | Mandatory just if period_end_datetime is set | ||||||||||||||||||||||||||||||||||||||||||
period_end_datetime | string (date-time) | Mandatory just if period_start_datetime is set | ||||||||||||||||||||||||||||||||||||||||||
amount
*
| object | |||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
external_invoice_id | string | this field is informative. We are not doing any further processing apart from persisting it | ||||||||||||||||||||||||||||||||||||||||||
external_movement_unique_id
*
| string | |||||||||||||||||||||||||||||||||||||||||||
billable
*
| boolean | |||||||||||||||||||||||||||||||||||||||||||
concept_id | string | |||||||||||||||||||||||||||||||||||||||||||
description | string | |||||||||||||||||||||||||||||||||||||||||||
Created Successfully created the operation request, returned the result
{
"code": "CREATED",
"title": "Movement created correctly",
"movement_id": "8da2b117-ef72-413d-98ce-36d1eb544e44"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Code string for fast identification | ||
title
*
| string | Message description | ||
movement_id
*
| string | Identifier of the created movement |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found
{
"code": "NOT_FOUND",
"title": "Msisdn not found: 100000000"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X POST 'https://partners.sta.masstack.com/v3/mobile/612123456/billing/movements' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"type": "RECURRING_CHARGE",
"movement_datetime": "2022-02-24T13:45:10Z",
"period_start_datetime": "2022-01-31T23:00:00Z",
"period_end_datetime": "2022-02-28T23:00:00Z",
"amount": {
"value_with_taxes": 12.1,
"value_without_taxes": 10,
"tax": {
"type": "IVA",
"percentage": 21
}
},
"external_invoice_id": "123456789",
"external_movement_unique_id": "123456789",
"billable": false,
"concept_id": "5432167890",
"description": "February invoice"
}'Delete movement for services
PATH PARAMETERS
Service type indicator
Service identifier for the movement to be deleted
Movement to be updated identifier
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
OK Successfully deleted de movement resource
{
"code": "DELETED",
"title": "Movement deleted correctly"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Code string for fast identification | ||
title
*
| string | Message description |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found
{
"code": "NOT_FOUND",
"title": "Msisdn not found: 100000000"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X DELETE 'https://partners.sta.masstack.com/v3/mobile/612123456/billing/movements/4d9d437f-ef3b-41e7-b474-067b1917cc4e' \
-H 'Request-Correlation-Id: string' \
-H 'Accept: application/json'Create refund for services
PATH PARAMETERS
Service type indicator
Service identifier for refund creation
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Contains refund information to be created
{
"refund_datetime": "2022-02-24T13:45:10Z",
"period_start_datetime": "2022-01-31T23:00:00Z",
"period_end_datetime": "2022-02-28T23:00:00Z",
"amount": {
"value_with_taxes": 12.1,
"value_without_taxes": 10,
"tax": {
"type": "IVA",
"percentage": 21
}
},
"external_invoice_id": "123456789",
"external_refund_unique_id": "123456789",
"billable": false,
"movement_id": "5432167890",
"description": "February invoice"
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
refund_datetime
*
| string (date-time) | |||||||||||||||||||||||||||||||||||||||||||
period_start_datetime | string (date-time) | Mandatory just if period_end_datetime is set | ||||||||||||||||||||||||||||||||||||||||||
period_end_datetime | string (date-time) | Mandatory just if period_start_datetime is set | ||||||||||||||||||||||||||||||||||||||||||
amount
*
| object | |||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
external_invoice_id | string | this field is informative. We are not doing any further processing apart from persisting it | ||||||||||||||||||||||||||||||||||||||||||
external_refund_unique_id
*
| string | |||||||||||||||||||||||||||||||||||||||||||
billable
*
| boolean | |||||||||||||||||||||||||||||||||||||||||||
movement_id
*
| string | |||||||||||||||||||||||||||||||||||||||||||
description | string | |||||||||||||||||||||||||||||||||||||||||||
Created Successfully accepted the operation request, returned the result
{
"code": "CREATED",
"title": "Refund created correctly",
"refund_id": "8da2b117-ef72-413d-98ce-36d1eb544e44"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Code string for fast identification | ||
title | string | Message description | ||
refund_id
*
| string | Identifier of the created refund |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found
{
"code": "NOT_FOUND",
"title": "Msisdn not found: 100000000"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X POST 'https://partners.sta.masstack.com/v3/mobile/612123456/billing/refunds' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"refund_datetime": "2022-02-24T13:45:10Z",
"period_start_datetime": "2022-01-31T23:00:00Z",
"period_end_datetime": "2022-02-28T23:00:00Z",
"amount": {
"value_with_taxes": 12.1,
"value_without_taxes": 10,
"tax": {
"type": "IVA",
"percentage": 21
}
},
"external_invoice_id": "123456789",
"external_refund_unique_id": "123456789",
"billable": false,
"movement_id": "5432167890",
"description": "February invoice"
}'Terminate subscription
PATH PARAMETERS
Service type indicator (must be deviceinsurance)
Service identifier (policy number or subscription ID)
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Contains termination information
{
"reason": "SUBSCRIBER_RESIGNATION",
"deactivation_date": "2025-12-03T10:30:00Z"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
reason
*
| string | Reason for terminating the device insurance | ||
deactivation_date
*
| string (date-time) | Deactivation date for the device insurance (ISO 8601 format) |
OK Successfully terminated the device insurance
{
"code": "OK",
"title": "Device insurance terminated correctly"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Code string for fast identification | ||
title
*
| string | Message description |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "Invalid request data"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found
{
"code": "NOT_FOUND",
"title": "Subscription not found"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X POST 'https://partners.sta.masstack.com/v3/deviceinsurance/3500038700026229/terminate' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"reason": "SUBSCRIBER_RESIGNATION",
"deactivation_date": "2025-12-03T10:30:00Z"
}'Activate a new promotion for a service
PATH PARAMETERS
Service type indicator
Service identifier
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Contain promotion information to be activated
{
"promotion": {
"promotion_id": 76,
"activation_date": "2017-09-15T22:00:00Z",
"deactivation_date": "2017-09-15T22:00:00Z"
}
}| Property | Type | Description | Constraints | Default | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
promotion
*
| object | |||||||||||||||||||||||
| ||||||||||||||||||||||||
Created Successfully created the operation request, returned the result
{
"code": "CREATED",
"title": "Promotion created correctly",
"promotion_id": "8da2b117-ef72-413d-98ce-36d1eb544e44"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Code string for fast identification | ||
title | string | Message description | ||
promotion_id
*
| string | Identifier of the created refund |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found
{
"code": "NOT_FOUND",
"title": "Msisdn not found: 100000000"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X POST 'https://partners.sta.masstack.com/v3/mobile/612123456/promotions' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"promotion": {
"promotion_id": 76,
"activation_date": "2017-09-15T22:00:00Z",
"deactivation_date": "2017-09-15T22:00:00Z"
}
}'Update a promotion for a service
PATH PARAMETERS
Service type indicator
Service identifier
Promotion identifier
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Update an existing promotion
{
"deactivation_date": "2022-02-24T13:45:10Z"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
deactivation_date
*
| string (date-time) |
OK Successfully completed the operation request, returned the result
{
"code": "OK",
"title": "Promotion updated correctly"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Code string for fast identification | ||
title
*
| string | Message description |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found
{
"code": "NOT_FOUND",
"title": "Msisdn not found: 100000000"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X PATCH 'https://partners.sta.masstack.com/v3/mobile/612123456/promotions/612123456' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"deactivation_date": "2022-02-24T13:45:10Z"
}'New service creation
PATH PARAMETERS
Service type indicator
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Create a new service
{
"callback_success_url": "https://myserver.com/send/callback/here",
"callback_error_url": "https://myserver.com/send/callback/here",
"service_id": "string",
"service_details": {
"secondary_eid": "string",
"secondary_iccid": "string"
}
}| Property | Type | Description | Constraints | Default | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
callback_success_url
*
| string (uri) | ||||||||||||||||||
callback_error_url
*
| string (uri) | ||||||||||||||||||
service_id | string | ||||||||||||||||||
service_details
*
| object | ||||||||||||||||||
| One of: Option 1
| |||||||||||||||||||
Accepted Successfully accepted the operation request, returned the request external reference identifier
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Request-Correlation-IdRequest-Correlation-Id-Responsecurl -X POST 'https://partners.sta.masstack.com/v3/applewatch/' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"callback_success_url": "https://myserver.com/send/callback/here",
"callback_error_url": "https://myserver.com/send/callback/here",
"service_id": "string",
"service_details": {
"secondary_eid": "string",
"secondary_iccid": "string"
}
}'Update device for a service (e.g. eSIM, SIM ...)
PATH PARAMETERS
Service type indicator
Service identifier whose device will be updated
Device identifier to be updated
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Update an existing service device
{
"callback_success_url": "https://myserver.com/send/callback/here",
"callback_error_url": "https://myserver.com/send/callback/here",
"category": "eSIM",
"new_service_device_details": {
"iccid": 8934011411551283000,
"eid": 8.903302331217e+31
}
}| Property | Type | Description | Constraints | Default | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
callback_success_url
*
| string (uri) | ||||||||||||||||||
callback_error_url
*
| string (uri) | ||||||||||||||||||
category
*
| string
()
STBSMARTWATCHTABLETROUTERPBXSMARTPHONEWIFI_EXTENDEROTHERSIMeSIM | ||||||||||||||||||
new_service_device_details
*
| object | ||||||||||||||||||
| One of: Option 1
| |||||||||||||||||||
Accepted Successfully accepted the operation request, returned the request external reference identifier
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Request-Correlation-IdRequest-Correlation-Id-Responsecurl -X PATCH 'https://partners.sta.masstack.com/v3/mobile/612123456/devices/:device_id' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"callback_success_url": "https://myserver.com/send/callback/here",
"callback_error_url": "https://myserver.com/send/callback/here",
"category": "eSIM",
"new_service_device_details": {
"iccid": 8934011411551283000,
"eid": 8.903302331217e+31
}
}'Retrieves the Netflix account information associated with a given STB serial number (PDI) and brand. First checks internal device info. Returns 404 if the device is not found.
PATH PARAMETERS
STB serial number (PDI)
Organization identifier
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
OK Successfully retrieved Netflix account info
{
"status": "OK",
"service_id": "K_1234"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
status
*
| string
()
UNPROVISIONED_DEVICENO_ACTIVE_NETFLIX_SUBSCRIPTIONSUSPENDED_NETFLIX_SUBSCRIPTIONOK | Status of the Netflix device/subscription | ||
service_id | string | Netflix serviceId (PAI), present when status is OK |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "Missing or invalid parameters"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Netflix device not found
{
"code": "ACCOUNT_NOT_FOUND",
"title": "Netflix account not found for device"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X GET 'https://partners.sta.masstack.com/v3/netflix/devices/SN123456789/brand/Samsung/service-ids' \
-H 'Request-Correlation-Id: string' \
-H 'Accept: application/json'Retrieves the Netflix Tasca account information associated with a given STB serial number (PDI) and brand. Calls the Norte Tasca account service to retrieve full account details.
PATH PARAMETERS
STB serial number (PDI)
Organization identifier
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Timestamp of the Netflix authorization request (format yyyyMMddTHHmmss+HHMM).
Netflix HMAC authorization header.
OK Successfully retrieved Netflix Tasca account info
{
"partner_account_identifier": "K_1234",
"partner_charge_country": "ES",
"validity_duration_in_seconds": 3600,
"capabilities": [
{
"name": "netflix_plus",
"value": true
}
]
}| Property | Type | Description | Constraints | Default | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
partner_account_identifier | string | Netflix Partner Account Identifier (PAI) | |||||||||||||||||
partner_charge_country | string | Country code for billing | |||||||||||||||||
validity_duration_in_seconds | integer | Validity duration of the account in seconds | |||||||||||||||||
capabilities | object[] | List of Netflix capabilities | |||||||||||||||||
Array items:
| |||||||||||||||||||
error | object | Rest service error response | |||||||||||||||||
| |||||||||||||||||||
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "Missing or invalid parameters"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Netflix Tasca account not found for device
{
"code": "ACCOUNT_NOT_FOUND",
"title": "Netflix Tasca account not found for device"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X GET 'https://partners.sta.masstack.com/v3/netflix/devices/SN123456789/brand/Samsung/tasca-info' \
-H 'Request-Correlation-Id: string' \
-H 'X-Netflix-AuthorizationTime: 20260616T140000+0000' \
-H 'X-Netflix-Header-Authorization: nflxv1 Credential=EUSKALTEL, Signature=abc123' \
-H 'Accept: application/json'Update a Netflix service
PATH PARAMETERS
Service identifier whose device will be updated
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Timestamp of the Netflix authorization request (format yyyyMMddTHHmmss+HHMM).
Netflix HMAC authorization header.
Update an existing service
{
"offer_id": "define",
"plan_type": "define",
"transaction_id": "define"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
offer_id
*
| string | |||
plan_type
*
| string | |||
transaction_id
*
| string |
OK Successfully accepted the operation request, returned the request external reference identifier
{
"transaction_id": "define"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
transactionId | string | Transaction identifier | ||
change_status
*
| string
()
ApprovedDeclined | Status of the plan change request | ||
decline_reason | string | Reason for decline (only present when change_status is Declined) |
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X PATCH 'https://partners.sta.masstack.com/v3/netflix/612123456' \
-H 'Request-Correlation-Id: string' \
-H 'X-Netflix-AuthorizationTime: 20260616T140000+0000' \
-H 'X-Netflix-Header-Authorization: nflxv1 Credential=EUSKALTEL, Signature=abc123' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"offer_id": "define",
"plan_type": "define",
"transaction_id": "define"
}'Notify Simyo about a Netflix product change
PATH PARAMETERS
Service identifier whose device will be updated
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
Update an existing service
{
"pai": "string",
"netflixOfferId": "string",
"changeDate": "string"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
pai | string | PAI | ||
netflixOfferId | string | netflixOfferId | ||
changeDate | string | changeDate |
OK Successfully accepted the operation request, returned the request external reference identifier
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "MISSING CALLBACK URL"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Acceptable
{
"code": "DUPLICATE_WORKFLOW_ID",
"title": "Duplicate workflow id"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Request-Correlation-IdstringWorkflow Id (unique identifier)
curl -X POST 'https://partners.sta.masstack.com/v3/netflix/612123456/simyo' \
-H 'Request-Correlation-Id: string' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"pai": "string",
"netflixOfferId": "string",
"changeDate": "string"
}'Retrieves AgileTV service IDs and their associated installation addresses for a customer identified by email
PATH PARAMETERS
Organization identifier
QUERY PARAMETERS
Customer email address
HEADER PARAMETERS
Correlation Id for tracing (unique identifier)
OK Successfully retrieved AgileTV addresses
{
"results": [
{
"service_id": "AGT-12345",
"installation_address": {
"street_type": "Calle",
"street_name": "Gran Via",
"house_number": "42",
"additional_info": "3A",
"city": "Madrid",
"province": "Madrid",
"country": "ES",
"post_code": "28013"
}
}
]
}| Property | Type | Description | Constraints | Default | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
results | object[] | List of AgileTV service IDs with their installation addresses | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array items:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bad Request Bad Request
{
"code": "BAD_REQUEST",
"title": "Missing or invalid email parameter"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Unauthorized Unauthorized request
{
"code": "UNAUTHORIZED_REQUEST",
"title": "Missing credentials"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Forbidden Forbidden resource
{
"code": "FORBIDDEN_RESOURCE",
"title": "Request forbidden by administrative rules"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Not Found Not found resource
{
"code": "NOT_FOUND",
"title": "Not found resource"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
Internal Server Error Internal Server Error
{
"code": "INTERNAL_SERVER_ERROR",
"title": "Server is not working due to some error"
}| Property | Type | Description | Constraints | Default |
|---|---|---|---|---|
code
*
| string | Error code string for fast identification | ||
title
*
| string | Message description or detail of error |
curl -X GET 'https://partners.sta.masstack.com/v3/orgs/masmovil/agile-tv/addresses?email=customer%40example.com' \
-H 'Request-Correlation-Id: string' \
-H 'Accept: application/json'