Torning mappe e flusso PAN-safe

1) Perché la tornitura e cos'è PAN-safe

• Ridurre al minimo i costi di controllo PCI DSS,
• ridurre il rischio di fuoriuscite,
• Migliorare l'autorizzazione (sostituzione automatica, COF, one-click),
• semplificare l'instradamento multi-PSP e i prelievi.

Il flusso PAN-safe è un tale script utente e server, in cui PAN compare solo all'interno di un perimetro di fiducia isolato (valt/TSP/PSP iframe) e non passa mai attraverso il tuo backend/logi/pneumatici di eventi a vista aperta.

2) Tipi di token e ciclo di vita

2. 1 token Vault (privati)

Generati dal tuo token valt o dal tuo provider di cassaforte di terze parti.
Associati al PAN, ma la corrispondenza reversibile è memorizzata solo nel valzer (HSM).
Vengono utilizzati per l'instradamento a qualsiasi PSP/acavyer (flessibilità).
Inoltre, l'indipendenza dagli schemi; Meno: richiede il proprio compliant valt.

2. 2 token network (schemi; Visa/Mastercard/AmEx TSP)

Prodotti in rete tramite TSP; spesso accompagnati da device-/merchant-binding e crittogramma.
Migliorano le autorizzazioni: sopra l'approval rate, meno frod fols positivi.
Supporta l'aggiornamento automatico durante il reimpostamento della mappa.
Meno: supporto PSP/processore e copertura dei mercati.

2. 3 Single-use e riutilizzabili (COF)

Single-use - Per un prelievo usa e getta/avvio SCA.
COF (Card-on-File): per le sottoscrizioni, i retro, i pagamenti ripetuti.

2. 4 Ciclo di vita

1. Inizializzazione: il fronte riceve campi di pagamento non dal tuo dominio (campo host/iframe TSP/PSP).
2. Tokening: PAN → (vault o network), rilascio del crittogramma (se necessario).
3. Storage: token e metadati (dati BIN, schema, scadenza, dominio-binding).
4. Utilizzo: autorizzazioni/capchur/retrai per token.
5. Rotazione/aggiornamento: update auto (network), card updater (vault/PSP).
6. Recensione/eliminazione: su richiesta dell'utente (GDPR/DSR) o per criteri di rettitudine.

3) Cartelli di architettura PAN-safe

3. 1 Livello client (web/mobile)

Hosted fields/ iFrame SDK di PSP/TSP: PAN viene immesso fuori dal tuo DON.
Il vostro frontand ottiene solo token + attributi non ritrici (ultimi 4 numeri, BIN-meta).
SCA/3DS viene avviato tramite provider; I server ricevono risultati/verdetto.

3. 2 Strumenti «Payments Orchestrator»

Non vede PAN; Opera con i token.
Distribuisce: routing (primary/secondary PSP), idempotency keys, retries/backoff, smart-routing (per BIN/regioni/conversione).
Mantiene le regole di config e i campioni di health PSP (SLI/SLO).
Abilita detokenize proxy (solo come «navetta di servizio» all'interno del perimetro affidabile al valzer).

3. 3 Token-valt (se proprio)

Backend HSM, crittografia compatibile FIPS.
Isolamento della rete/segmentazione, AAA (MFA/least privilege), registri di controllo, rotazione chiave.
API: tokenize (), detokenize (), rotate (), purge () con ACL/Scopes sottili.
FPE (format-supervising encryption) - Opzionale per lo storage visivamente mascherato.

3. 4 Bus evento e DWH

Gli eventi includono solo token e metadati sicuri.
Il lince di autorizzazione di kapchura/refanda tramite payment _ id (non PAN).
Lo storage BI è vietato da PAN e CVV.

4) Flussi (grafici di testo)

4. 1 COF primario (salvataggio della mappa)

1. User → Hosted Fields (PSP/TSP iframe) introduce PAN.
2. PSP/TSP → restituisce token (+ device binding/cryptogram).
3. Front → Backend (Orchestrator): `{token, order_id, context}`.
4. Orchestratore PSP: 'auth' (possibile 3DS challenge).
5. PSP → Orchestrator: `auth_result`.
6. Orchestratore di Wallet Service: salviamo «token» e meta.

PAN non compare nei tuoi servizi.

4. 2 Nuovo prelievo/sottoscrizione

1. Scheduler/Business → Orchestrator: `charge(token, amount)`.
2. Orchestrator → PSP: `capture/auth`.
3. PSP → Orchestrator: risultato + arn/rrn.
4. Orchestrator → Ledger/Reconciliation.

4. 3 Failover и smart-routing

Regola: 'IF PSP _ A. degraded OR BIN in {X} THEN PSP_B ELSE PSP_A`.
Per i token network, assicuratevi che entrambi i PSP supportino l'accettazione. altrimenti, tenete il riferimento binario (network + vault).

5) 3DS e SCA nel circuito PAN-safe

3DS2 viene eseguito da host SDK; i server accettano gli aliase states (frictionless, challenge, failure).
Collegare il verdetto 3DS a payment _ id; memorizzare gli artefatti transazionali (ARES, Cres refs) senza PAN.
Per recaranting (MIT/recurring/unscheduled COF) - Contrassegna correttamente i flag delle transazioni (tipo MIT, CIT reference iniziale).

6) Sicurezza, compilazione e criteri dei dati

Scansione PCI DSS - Il fronte senza PAN, il backend senza PAN viene semplificato (SAQ-A/variazioni). Se si dispone di un proprio valt/disintossicazione - scorta superiore (SAQ-D).
HSM/rotazione chiave: rotazioni periodiche delle chiavi master, dual control, split knowledge.
GDPR/DSR - Rimozione del token e dei metadati correlati su richiesta dell'utente (con PAN ancora sconosciuto).
Logi/trailer: occultamenti a righe, rilevatori di fuoriuscite (DLP), sanificazione durante la serializzazione degli errori.
Segmentazione: Valt nel segmento selezionato accesso: solo per token STS.

7) Integrazione con PSP/acavaier

7. 1 Set minimo di funzionalità PSP per PAN-safe

Hosted fields/SDK con tornitura.
Accetta network tokens (se possibile) e/o esporta vault-token.
Card updater, marchio COF, bandiere MIT.
3DS server + orchestrazione SCA.
Webhooks con consegna idempotent e firma.

7. Architettura Multi-PSP 2

Astrazione del connettore in Orchestrator (unificazione dei campi).
Tabella pesi/priorità + health-ping.
Tabella regole BIN (schema, regione, prodotto, rischio-scorrimento).
PSP di riserva per percorsi critici (fallback SLA).

8) Aggiornamento delle mappe e durata dei token

Network tokens - Aggiornamenti automatici durante la ripartizione (migliore per LTV).
Vault tokens: usa la card updater (tramite PSP/3rd-party).
Monitoraggio della scadenza, notifica all'utente, retrai morbidi (exponential backoff + jitter).
Aggancia il COF all'account-id, anziché all'utente PII, per un semplice riallineamento.

9) Retrai, errori e idempotency

Idempotency-key = хеш(merchant_id, account_id, order_id, attempt_n).
La categorizzazione degli errori è hard (decline code permanente) vs soft (timeout, network, risk pending).
Backoff: 1m → 10m → 1h → 24h con limite superiore e annullamento hard-decline.
Deduplicazione webhooks - Memorizzare le transizioni di stato e event _ id.

10) Ricomposizione e finanza

Guida il Ledger di pagamento senza PAN: «payment _ id», «psp _ txn _ id», «arn/rrn», «token _ id», states.
Rec file engestion giornaliero da PSP/acavayer; soldi, commissioni, charjbeek.
Singole pipeline per refunds/voids/marcebacks; concordare con il bollettino/contabilità.
KPI per PSP/paesi/tabelle BIN.

11) Metriche e target (KPI)

Sicurezza/compilazione

% di servizi che non vedono mai PAN (obiettivo 100%).
PCI scope level (sotto - meglio).

Business

Approval Rate (AR) per tipo di token (network vs vault).
COF retention rate, percentuale di metodi aggiornati automaticamente.
D + 0/D + 1 di riconsiliare (obiettivo: → 0).

Tecnica

Tempo di tornitura p95.
Percentuale di transazioni tramite fallback PSP.
Disintossicazione (obiettivo: minimizzare, solo all'interno del valzer).

12) Frequenti anti-pattern

Loging PAN/CVV in eccezioni.
Moduli client senza campi hosted.
Invio PAN tramite il bus API «temporaneo».
Mescolare token di domini diversi senza criteri espliciti (risk).
Nessuna carta di instradamento (tutti i pagamenti in un singolo PSP).
Storage di manufatti 3DS con PII ridondanti.

13) Piano di implementazione (per passo)

1. Frontand: integrare hosted fields/SDK, eliminare i propri moduli di pagamento.
2. Scelta PSP/TSP: conferma il supporto per network tokens, 3DS2, webhooks, card updater.
3. Orchestrator: livello di astrazione su PSP, regole di instradamento, idempotency, retries.
4. Valt (opzionale): seleziona o costruisce managed-vault (HSM, ACL, rotazioni).
5. Dati/eventi: proibizione PAN su bus e DWH; incorporare il DLP-gate in CHI/CD.
6. Compilazione: aggiorna l'ambito PCI, le procedure, i registri di verifica, i test di occultamento.
7. Osservabilità: metriche AR/LSR/latency per PSP, alerti di degrado, dashboard.
8. Economia: A/B test network vs vault token per AR/frodo/costo, ottimizzazione flow.

14) Assegno-foglio PAN-safe

• Immettere PAN solo in iframe/hosted fields.
• Beckend non accetta mai PAN/CVV.
• I token sono cifrati in memorizzazione, le chiavi sono in HSM, la rotazione è abilitata.
• 3DS2 e SCA sono contrassegnati correttamente (CIT/MIT/COF).
• Routing Multi-PSP e failover testati.
• Scheda updater abilitata (network/PSP).
• Logi/roulotte/dampi - senza PAN (maschere/igienizzatori).
• Ricomposizione e pegeback-pipline senza PAN.
• I criteri GDPR/Rimozione token sono stati implementati.
• Le metriche e gli alert coprono la qualità del token flow.

15) Glossario breve

PAN Numero di carta.
Token (vault/network) - Un sostituto PAN sicuro.
TSP: Token Service Provider.
COF/MIT/CIT: memorizzazione della carta/iniziativa merchant/iniziativa del cliente.
HSM - Modulo di protezione hardware.
SCA/3DS2: forte autenticazione/protocollo di autenticazione per mappe.

16) Riepilogo

Il torning è la tecnica di base per ridurre i rischi PCI, aumentare l'approval rate e distribuire i pagamenti in modo flessibile. Combinare network tokens (con conversione e aggiornamenti automatici) con vault tokens (grazie al controllo e all'indipendenza), costruire flow PAN-safe con campi hosted, orchestrazione, controllo delle chiavi e osservabilità trasparente dall'autorizzazione alla riconciliazione. Ciò darà sicurezza, portata e monetizzazione prevedibili.