Porting in the UK
Porting in the UK refers to the process of switching your carrier with porting your existing phone number or solely switching without keeping the number but canceling the old contract. There are a few concepts that you should be aware of throughout the porting process:
- Donor provider: The carrier that currently owns the number and will lose it once the porting is completed (the user’s current provider).
- Recipient provider: The carrier that will receive the number once the porting is completed (managed through Gigs).
- PAC: The PAC is a unique code that allows the recipient provider to request the port from the donor provider. It always follows the format of three letters and then six digits, e.g. ABC123456.
- STAC: The STAC is a unique code that allows the recipient provider to request the switch from the donor provider without keeping their phone number. It always follows the format of six digits and then three letters, e.g. 123456ABC. Sometimes referred to as a Non-Porting Authorization Code (N-PAC).
- Scheduled Porting: Portings can be scheduled to happen on a specific date, which is useful for users who want to start their carrier change process early and plan ahead, minimizing downtime of their old phone number. If the scheduled date is not a working day, the porting will be processed on the next working day.
In the UK, ports are highly regulated and are very familiar to end users, as it is a common practice. The process is designed to be straightforward and user-friendly, with most users able to complete the porting process without any issues. The porting process is initiated by the end user, who must provide a PAC or STAC code from their current provider.
Contents:
- Porting lifecycle, including End User Flow
- Information Required for a Port
Porting Lifecycle
The following sections describe the lifecycle of a porting in the UK, including the end user flows for:
- porting in their existing phone number,
- canceling their existing phone number.
End User Flow: Porting In their Existing Phone Number
Below is an overview of the porting process:
- User wants to bring their phone number to their new plan and reaches out to their current provider to obtain a PAC.
- You create a porting with behavior
portIn
and the PAC as the account pin. Optionally, specify ascheduledAt
date to schedule the porting. - You create a subscription through the API and reference the porting.
- Gigs submits the port to the recipient provider.
- The recipient provider validates the PAC code and schedules the number transfer with the donor provider, either on the next working day or at the scheduled date.
- The previous subscription with the donor provider is automatically canceled and user looses connectivity to their number for a few hours.
- The
status
of the porting moves tocompleted
(see section Lifecycle) and Gigs activates the new subscription with the ported phone number.
End User Flow: Canceling their Existing Phone Number
- User indicates that they want to switch to you for their new phone plan, however they want to get a new phone number and not keep their current number. User reaches out to their current provider to obtain a STAC.
- You create a porting with behavior
cancelOnly
and the STAC as the account pin. Optionally, specify ascheduledAt
date to schedule the porting. - You create a subscription through the API and reference the porting.
- Gigs submits the port to the recipient provider.
- The recipient provider validates the STAC code and schedules the subscription cancellation with the donor provider, either on the next working day or at the scheduled date.
- The previous subscription with the donor provider is canceled.
- The
status
of the porting moves tocompleted
(see section Lifecycle) and Gigs activates the new subscription with a new phone number.
Lifecycle of the Porting Object
The porting process is modeled on the Gigs APIs through the porting
object. For a detailed description of the porting
object and its lifecycle, refer to the Porting Lifecycle section in How Porting in Works.
On the duration of the porting process:
The porting process in the UK is typically completed within one working day, when the port is submitted before 6pm on the previous day and the STAC or PAC is provided accurately by the user.
Information Required for a Port
Below is the information that is required to submit a port. Note that it is crucial that account pin and phone number are correct.
- Phone number: Number that the user wants to bring to their new subscription or the number that the user wants to cancel.
- Account pin: The PAC or STAC code provided by the user.
- Recipient provider:
p12