# Going Live
URL: /docs/getting-started/going-live

> The complete production readiness checklist for launching your SMS Pro integration onto live telecommunication carrier routes.

Transition from an `sk_test_` key to an `sk_live_` key on `https://api.smspro.com` after the account can pay for messages and the sender name is approved.

---

## Checklist [#checklist]

| Step | What to do |
| :--- | :--- |
| **1** | Confirm the display name and phone on Account settings. |
| **2** | Request a Sender ID and wait until it is approved. |
| **3** | Add credit from Wallet. |
| **4** | Create an `sk_live_` key with only the scopes you need. |
| **5** | Verify `X-SmsPro-Signature` on delivery webhooks. |
| **6** | Send an `Idempotency-Key` on every mutating `POST`. |
| **7** | Retry `429` and `503` with backoff, using the same idempotency key. |

---

## 1. Account profile [#1-account-profile]

Open [Account settings](https://smspro.com) after sign-in and save the display name and phone number. Email changes are done on the Authorisation Server.

The same page lists email, SMS, and marketing notification toggles. Marketing messages are held from 21:00 to 07:00 local time. Transactional messages and OTP are sent during those hours. That quiet-hours window applies to every account.

---

## 2. Request a Sender ID [#2-request-a-sender-id]

A custom alphanumeric sender name has to be approved before live traffic can use it.

![Sender ID request](/images/sender-id-request-form.svg)

1. Open **Sender ID** and choose **Request new sender ID** (`/customer/sender-id/request`).
2. Enter a name of up to 11 characters, the message types, and the purpose.
3. Attach supporting documents if you have them. They are optional.
4. Accept the Sender ID terms and submit.
5. The request stays **Pending** until it is **Approved**. A rejected request can be corrected and sent again. An approved name can later be revoked.

<Callout type="info" title="Until it is approved">
Send with a sender name that is already approved on the account.
</Callout>

---

## 3. Add credit [#3-add-credit]

Live segments draw on the wallet.

1. Open **Wallet** (`/customer/wallet`).
2. Use **Top Up Wallet** (`/customer/wallet/top-up`) or **Buy SMS Bundle** (`/customer/wallet/buy-bundle`).
3. Enter the amount and complete checkout.

---

## 4. Create a live key [#4-create-a-live-key]

1. Open **Developer > API Keys**.
2. Set **Environment** to **Live (`sk_live_`)**.
3. Choose the traffic class and enter an SMS allocation.
4. Select only the scopes the integration needs.
5. Optionally fill **IP whitelist**.
6. Click **Add API Key**, copy the secret from the banner, and store it outside the repository.

---

## 5. Secure Your Webhook Receiver [#5-secure-your-webhook-receiver]

When receiving asynchronous Delivery Receipts (`DLR`) in production, always verify the cryptographic signature in the `X-SmsPro-Signature` header to ensure payloads originate exclusively from SMS Pro:

![SMS Pro Webhook Signature Verification Workflow](/images/webhook-signature-verification.svg)

```ts title="webhook-handler.ts"
import crypto from 'node:crypto';

export function verifyWebhookSignature(
  rawPayload: string,
  signatureHeader: string,
  signingSecret: string,
): boolean {
  const parts = Object.fromEntries(
    signatureHeader.split(',').map((part) => {
      const index = part.indexOf('=');
      return [part.slice(0, index), part.slice(index + 1)];
    }),
  );
  const timestamp = parts.t;
  const expected = parts.v1;
  if (!timestamp || !expected) return false;

  const age = Math.abs(Math.floor(Date.now() / 1000) - Number(timestamp));
  if (!Number.isFinite(age) || age > 300) return false;

  const computed = crypto
    .createHmac('sha256', signingSecret)
    .update(`${timestamp}.${rawPayload}`)
    .digest('hex');
  const left = Buffer.from(computed, 'utf8');
  const right = Buffer.from(expected, 'utf8');
  if (left.length !== right.length) return false;
  return crypto.timingSafeEqual(left, right);
}
```

- Return HTTP `200` promptly.
- Do later work on your own job queue after you have verified the signature.

---

## 6. Switch the key [#6-switch-the-key]

```bash title=".env.production"
SMSPRO_BASE_URL=https://api.smspro.com
SMSPRO_API_KEY=sk_live_example
SMSPRO_WEBHOOK_SECRET=whsec_example
```

---

## 7. Check the first live message [#7-check-the-first-live-message]

1. Send one message to a phone you control.
2. Confirm the sender name and the text.
3. Open **Developer > API Logs** (`/customer/developer/api-logs`) and confirm `202`.
4. Watch the wallet on the dashboard. Account settings can send email and SMS alerts. There is no separate wallet-threshold page.

---

## Next [#next]

Continue with the [transactional SMS guide](/docs/guides/transactional-sms) and the [recipes](/docs/recipes).