Files
eSIM-Tools/docs/User_Guide_EN.md
Abner 2c0f3f4e56 📝 docs: 新增直取 eSIM 功能说明与未测试提醒
- giffgaff_modular.html: 直取 eSIM 内联区添加未测试免责声明,
  小号字体醒目标注,附 Issue 反馈链接
- User_Guide.md: 第 5 步拆分为三种激活方式说明
- User_Guide_EN.md: 同步英文版文档
2026-05-29 18:36:39 +08:00

3.7 KiB
Raw Blame History

Giffgaff User Guide

🌐 中文版

🎬 Video Tutorial - Giffgaff eSIM Replacement Operation DemoThe video tutorial has not been updated. For information on how to obtain the OAuth callback URL, please refer to the text tutorial.

Your browser does not support video playback. Please download the video tutorial to watch it locally.

giffgaff.webm

1. Open Giffgaff eSIM Replacement Web Page

Visit the eSIM Tools website and select the Giffgaff eSIM tool.

2. Select Login Method

Choose OAuth or Cookies login method (OAuth method is recommended)

Select Login Method

OAuth Login

OAuth method requires obtaining the callback URL. For instructions on how to get it, please refer to the page instructions:

Get Callback URL Instructions

  1. First, open the login page for the giffgaff website on a new tab: https://www.giffgaff.com and log in.
  2. After logging in, return to the eSIM replacement page and open the developer tools: press F12 or right-click and select “Inspect” to switch to the “Console” tab.
  3. Click the “Start OAuth Login” button at the bottom; once the new window opens, switch back to the eSIM replacement page.
  4. Look for the error message in the console: “Failed to launch giffgaff://auth/callback/…’”. Copy the callback URL from that line.

Get Callback URL

  1. Enter the obtained callback URL into the corresponding input box on the eSIM replacement page and click "Process Callback"

Enter Callback URL

3. MFA Authentication

After processing the callback, you will be automatically redirected to the second step, select email/SMS verification code method to obtain MFA authentication:

MFA Authentication

Enter the obtained verification code and click "Verify":

Enter Verification Code

4. Get Member Information

After successful verification, you will be automatically redirected to the third step, the get Giffgaff member information page:

Get Member Information

Click "Get Member Information" to go to the fourth step of converting/activating eSIM:

Convert/Activate eSIM

5. Select and Activate eSIM

Step 4 offers three activation methods. Choose the one that fits your situation:

Select SMS verification code activation and enter the SMS verification code, the system will automatically complete the eSIM replacement and generate QR code and LPA information:

Verification Code Page

Method 2: Fetch eSIM Directly (For New-Purchase Users)

⚠ This feature has not been fully tested. If you encounter issues, please open the browser console (F12 → Console), copy the full log, and submit it via GitHub Issues.

If you have already paid £10 in the official Giffgaff app but did not receive an eSIM, use this method:

  1. Click the "Fetch eSIM directly" card
  2. Click the "Fetch my eSIM" button
  3. The system will fetch the existing eSIM on your account and generate a QR code

This method requires no SMS verification code and skips the reserve/swap flow — it directly retrieves the QR code.

Method 3: Manual Activation (Paused)

Manual activation has been paused by Giffgaff. Please use one of the methods above.

After successful exchange, you will be redirected to the fifth step showing QR code and LPA information:

eSIM Information eSIM Information 1

6. Use Native eSIM Phone to Complete Scanning