Skip to content
Facteur
FRGet started

SMS and OTP testing

Check the code, not your patience

A dedicated number attached to an inbox, and the same API as email. The one-time code arrives already extracted.

login-2fa.spec.tsTypeScript
// Your SMS inbox's number, read from the console.
const number = process.env.FACTEUR_SMS_NUMBER;

await page.getByLabel('Phone').fill(number);
await page.getByRole('button', { name: 'Send me a code' }).click();

// Same API as email: we wait, we do not poll.
const sms = await facteur.messages.waitFor({
  type: 'sms',
  sentTo: number,
  wait: 60_000,
});

expect(sms.otp).toBe('482913');   // already extracted
await page.getByLabel('Code received').fill(sms.otp);

Number availability

  • United Kingdom, United States, Canada

    Ask for one from the app; it is in service within two working days.

  • France and the euro area

    In progress. Receiving an OTP on a real French number is harder than it looks: operators tightly restrict mobile number usage, and a commercial A2P route does not guarantee delivery to a virtual number. We would rather open this when we can guarantee the reception rate than sell you a test that fails one time in twenty.

Need a specific country? Tell us: real demand decides our order of priority.

How it works

What the SMS module covers

The same model as email

messages.await

An SMS is a message like any other: same inbox, same search, same blocking wait, same code extraction. You do not learn a second API.

Code extraction

The one-time code is isolated from the text on arrival, whatever wording the sender used.

An SMS counter separate from the email one

SMS do not draw on the messages included with your subscription: each number brings its own allowance, with a monthly limit you set inbox by inbox. A looping SMS test drains neither the other inboxes’ counter nor your email one.

Per-unit billing

17 € per number per month, 100 inbound SMS included, then 0,015 € per SMS. No module to switch on, no monthly surcharge for the right to receive an SMS.

TOTP authenticator

For 2FA journeys based on an authenticator app rather than SMS: generate the six-digit codes from the API, with no phone in the loop.

History and export

Received SMS follow the same retention and the same export as emails, and appear in the same inbox view.

SMS is not an add-on

No module to switch on at tens of euros a month: a number, some messages, billed per unit.

Create a free accountHow to migrate