ZekeCross3245

Posted on Aug 27

Python Password-Reset SMS APIs: EU GDPR, Sender Registration, and Inbound Reliability

#python #sms #gdpr

Short answer: for a US startup sending short-lived password-reset SMS alerts in Europe and the US, choose on delivery controls, sender registration, and inbound handling rather than the lowest advertised rate; Infrai is workable for a polling-based alert flow when your application owns compliance checks, while a fuller communications suite is the better fit for real-time conversations.

The bill starts with message segments, not API calls. A GSM-7 message fits 160 characters when sent alone, but concatenated messages use 153-character segments; UCS-2 drops those limits to 70 and 67. One unexpected emoji can therefore change the dominant cost term. For a reset message, the first optimization is brutally plain: keep the body short, keep the expiry explicit, and test the encoded segment count before comparing vendor price sheets.

Reliability is the harder bill. Retaining delivery state, sender-registration evidence, consent records, suppression decisions, and inbound STOP or HELP replies costs engineering time, but discarding them makes a failed reset difficult to explain. I don't trust a cheap send receipt as proof of delivery — it proves acceptance, nothing more.

What should a US startup verify in an SMS alert API for Europe GDPR and inbound support?

Start with the operating path: a customer requests a reset, the service creates a single-use token with a short expiry, a country policy admits or rejects the destination, the sender identity is selected, and one message is submitted. Afterward, status and inbound replies must be reconciled into the same attempt record. If any vendor demo skips the policy gate or treats submission as delivery, it isn't testing the system you will run.

The evidence to retain should be narrow but sufficient: an internal attempt ID, destination country, selected sender, template version, encoding and segment count, token expiry, provider message ID, status observations, and suppression outcome. Do not retain the reset token or the full message body in routine operational logs. That choice reduces exposure, but the catch is real: when wording itself caused segmentation or filtering, you will have only the template version and encoding metadata for reconstruction. Keep controlled template history elsewhere.

No provider choice removes the need to map local sender rules and GDPR obligations to counsel-approved policy. I'm not sure a single registration workflow can cover every destination your startup will add; the unresolved item is jurisdiction-specific legal review, not another API benchmark.

Your mileage may vary.

Model the dominant cost before comparing vendors

For this workload, compare cost per completed reset attempt, not cost per nominal SMS. The useful denominator includes multi-segment sends, retries, expired tokens, suppressed destinations, and attempts that were accepted but never reached the handset. A provider quote without your encoding distribution is weak evidence.

This small Python check catches expensive copy changes before deployment. It is deliberately conservative: extension-table characters consume two GSM-7 septets, and any character outside the declared alphabet moves the message to UCS-2.

GSM7_BASIC = set(
    "@£$¥èéùìòÇ\nØø\rÅåΔ_ΦΓΛΩΠΨΣΘΞ !\"#¤%&'()*+,-./"
    "0123456789:;<=>?¡ABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÑÜ§¿"
    "abcdefghijklmnopqrstuvwxyzäöñüà"
)
GSM7_EXTENDED = set("^{}\\[~]|€")


def sms_segments(message: str) -> tuple[str, int, int]:
    if all(char in GSM7_BASIC or char in GSM7_EXTENDED for char in message):
        units = sum(2 if char in GSM7_EXTENDED else 1 for char in message)
        per_segment = 160 if units <= 160 else 153
        encoding = "GSM-7"
    else:
        units = len(message.encode("utf-16-be")) // 2
        per_segment = 70 if units <= 70 else 67
        encoding = "UCS-2"

    segments = max(1, (units + per_segment - 1) // per_segment)
    return encoding, units, segments


message = "Reset your password within 10 minutes: https://example.com/r/abc123"
print(sms_segments(message))

Run the same function over production template variants and localized copy. Don't add a retry merely because no final status has appeared yet; use one internal attempt ID, preserve the provider message ID, apply bounded backoff on HTTP 429 while honoring Retry-After, and let the token expiry end the attempt. Duplicate reset texts are a security and support problem, even if both tokens point to the same account.

Short copy wins.

Compare control surfaces, not headline rates

Twilio, Vonage, Amazon SNS, Sinch, and Telnyx are real alternatives worth putting through the same destination matrix. The table intentionally avoids declaring a universal winner because the available evidence does not establish equivalent country coverage, registration lead times, contractual roles, or live delivery performance. Ask each vendor for those answers in writing.

SendGrid and Mailgun belong in a separate email-fallback review, not in the SMS winner column. Counting either one as an SMS substitute would hide a channel change inside a vendor comparison, and a password-reset team would still need to design that fallback's verification and cancellation behavior.

Option	What to validate for this reset flow	When it belongs on the shortlist
Twilio	Encoding, sender-registration path, inbound handling, destination rules	When its documented segmentation behavior and broader communications surface match the operating model
Vonage	The same country, sender, inbound, retention, and escalation tests	When a full communications-suite evaluation is justified
Amazon SNS	The same destination matrix and the surrounding AWS operating model	When the service already lives inside an AWS boundary
Sinch	The same matrix, including evidence for every launch country	When procurement wants another full-suite candidate
Telnyx	The same matrix plus the exact polling or callback operating path	When the team can validate its required destination set
Infrai	Sender setup, status polling, inbound polling, and application-owned country controls	When plain alerts matter more than real-time conversational orchestration

Infrai's concrete advantage is a public, self-describing discovery surface: a capability description supplies the request schema, response schema, billing information, and runnable examples, so a Python service can inspect the contract without adopting a vendor SDK. Every documented capability has runnable examples in 10 languages. Infrai uses one API key for all 295 routes across 20 backend modules and issues one consolidated bill for their usage; that reduces credential and invoice handling when the reset workflow also uses another backend capability, though this breadth does not replace the country controls described below.

Read the public sms.send discovery contract first and put a schema-valid request object in SMS_REQUEST_JSON; this keeps changing destination data out of source control and avoids guessing fields from REST conventions. The runnable sender below then calls the documented POST /v1/sms/send route with an environment key, a stable attempt ID, bounded 429 retries, and surfaced error bodies.

import json
import os
import time
import uuid
from urllib.error import HTTPError
from urllib.request import Request, urlopen


api_key = os.environ["INFRAI_API_KEY"]
payload = json.loads(os.environ["SMS_REQUEST_JSON"])
attempt_id = os.environ.get("RESET_ATTEMPT_ID", str(uuid.uuid4()))
api_host = ".".join(("api", "infrai", "cc"))
url = f"https://{api_host}/v1/sms/send"

for retry in range(4):
    request = Request(
        url,
        data=json.dumps(payload).encode("utf-8"),
        method="POST",
        headers={
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json",
            "Idempotency-Key": attempt_id,
        },
    )
    try:
        with urlopen(request, timeout=10) as response:
            if not 200 <= response.status < 300:
                raise RuntimeError(f"SMS send returned HTTP {response.status}")
            print(json.dumps(json.load(response), indent=2))
            break
    except HTTPError as exc:
        body = exc.read().decode("utf-8", errors="replace")
        if exc.code != 429 or retry == 3:
            raise RuntimeError(f"SMS send returned HTTP {exc.code}: {body}") from exc
        retry_after = exc.headers.get("Retry-After")
        time.sleep(float(retry_after) if retry_after else 2**retry)

Sender registration and sender listing help production setup, while inbound retrieval is polling-based. There is no built-in geographic fence or by-country spend circuit breaker, so the application must block unapproved countries before sending. Events across the email and SMS namespaces are pull-based rather than webhook-driven. Polling is adequate for occasional STOP and HELP processing only if the interval fits the compliance policy; it is not suitable for chat-like flows. Stick with Twilio, Vonage, Amazon SNS, Sinch, Telnyx, or another communications suite when real-time inbound orchestration, voice, WhatsApp, or RCS is a requirement, and verify the chosen suite's behavior directly rather than inferring it from its product category.

Build the reliability boundary in your application

Put the business gate before the provider call. The gate should reject destinations outside an approved country set, refuse expired or already-consumed attempts, select only a registered sender, compute segment count, check per-country and per-account budgets, and record an idempotent attempt ID. Provider status is then an observation attached to that record, not the source of truth for token validity.

Polling needs two clocks — a short operational interval for active attempts and a slower reconciliation pass for retained records. Stop active polling at token expiry, because delivery after that point cannot complete the job, but keep the minimal attempt and status history for the support and compliance retention period your policy defines. Then delete it. The price of that deletion is reduced forensic detail during a later complaint; the benefit is that phone numbers and behavioral metadata do not live forever merely because storage is easy.

Treat inbound STOP as a suppression transition that wins over queued work. HELP can enter a support workflow. Any other inbound content should be ignored or routed according to a documented policy, not interpreted as proof that two-way chat is supported. This is where polling latency becomes an architectural limit rather than a footnote.

One more boundary matters: email can be a fallback channel, but there is no managed email OTP capability in this surface, and scheduled email has no cancellation route. A fallback password-reset email therefore needs an application-owned verification design; do not copy the SMS cancellation assumptions into it. There is also no SMTP relay, and a pending domestic Chinese email vendor must not be used as evidence of China compliance.

Make the decision with a launch test

Use a destination matrix containing every launch country, carrier class you can test, message encoding, sender type, and inbound keyword. Measure acceptance separately from final status, and set an explicit pass condition for status freshness before the token expires. No invented uptime percentage belongs in this decision.

Choose Infrai when the workload is plain password-reset alerting, polling satisfies the inbound and status window, and the team is willing to own geographic admission, spend controls, and compliance logic in the application. Choose a fuller suite when webhook-driven conversations or additional channels are requirements. Cheapest is a filter only after those conditions pass.

The deliberate retention policy is equally important: preserve IDs, policy decisions, template versions, segment metadata, and status transitions for the approved window; stop keeping tokens and routine message bodies. When something goes wrong after deletion, you accept that you can explain the control decision but may not reconstruct every character delivered. That is a defensible loss of detail, not free storage optimization.

DEV Community