Denaro in centesimi, addebiti solo in prd — senza negoziare.
Stato del pagamento come macchina esplicita, pagato solo da un canale PSP autenticato, ledger immutabile a partita doppia e riconciliazione giornaliera. Carta senza toccare il PAN e nessun addebito reale fuori dalla produzione.
$ schematize install paymentsSoglie non negoziabili
Non si spengono "per andare più veloci". Elenco completo nella skill.
Mai addebitare fuori da prd
Addebiti, rimborsi, giri di fondi e documenti fiscali solo in sandbox o omologazione; ambiente assente significa non-prd e la chiave di produzione esiste solo in prd.
Il denaro è un intero nell'unità minima
Centesimi più valuta, mai float; la somma delle parti (split, rate) è uguale al totale con un resto deterministico.
Non toccare mai il PAN
Acquisizione tramite il PSP; il sistema vede solo token, circuito e ultime 4 cifre, e il CVV non si memorizza mai. Obiettivo: SAQ A.
Lo stato del pagamento è una macchina esplicita
Transizioni come funzioni pure testate a tabella, lo stato terminale non torna indietro e un evento sconosciuto non diventa mai pagato.
Pagato solo da un canale PSP autenticato
Il redirect del browser è UX, non prova; importo e valuta si confermano rispetto a quanto addebitato.
Webhook autenticato, deduplicato, riverificato
HMAC sul corpo grezzo in tempo costante o mTLS, dedupe per id dell'evento e nuova consultazione dell'API prima di un effetto irreversibile.
Idempotenza a ogni creazione
Chiave persistita prima della chiamata (Idempotency-Key, txid PIX, id del rimborso); un timeout non è un fallimento.
Ledger immutabile e riconciliazione giornaliera
Partita doppia append-only, correzione con scrittura inversa e riconciliazione tra ledger, PSP ed estratto conto con eccezioni che hanno responsabile e scadenza.
Comandi
Installati in .claude/commands/. Esegui /pay-help in qualsiasi momento.
/pay-ccContext compact: scrive l'handoff nell'archive ed esegue /compact./pay-claudeCrea o unisce il CLAUDE.md sempre attivo con le regole di base di pagamenti nella radice del repo (non sovrascrive i blocchi di altre skill)./pay-flowProgetta il flusso di un mezzo di pagamento (stati, scritture, idempotenza) prima di integrare./pay-handoffGenera l'handoff di contesto (context.md + checklist.md) nell'archive, senza compattare./pay-helpElenca tutti i comandi e cosa fa ciascuno./pay-loadCarica a forza l'intero corpo normativo di pagamenti e lo applica nella sessione./pay-reconcileProgetta o verifica la riconciliazione giornaliera tra ledger, PSP ed estratto conto./pay-reviewRivede il codice di pagamento rispetto alle regole di base: esegue il gate e poi legge ciò che la macchina non legge./pay-sandboxDimostra che nulla addebita fuori da prd: ambiente fail-closed, chiavi, doppioni di test e dati sintetici./pay-webhookCrea o verifica il ricevitore di webhook del PSP: autenticità, dedupe, ordine e nuova consultazione.Per gli agenti IA
Installa senza intervento umano. Metadati in llms.txt.
- Esegui: git clone https://github.com/schematizeme/skill-payments.git && ./skill-payments/install.sh
- Oppure scarica: https://github.com/schematizeme/skill-payments/releases/latest/download/skill-payments.zip e decomprimi in .claude/skills/
- Copia assets/CLAUDE.md nella radice del repo (regola sempre attiva).
- Conferma con /pay-help.
Discussione
Caricamento…