L’intero negozio a una chiamata API di distanza
Collega PapelShip ai tuoi sistemi con un’API REST completa, webhook firmati, un SDK per il browser e un’API per le licenze.
- Limite di richieste
- 300 richieste al minuto
- Firme dei webhook
- HMAC-SHA256
- Nuovi tentativi
- Da 1 minuto a 12 ore
- Idempotenza
- Sulle operazioni di creazione
Sviluppatori
PapelShip è pensato perché quasi tutto ciò che fai dalla dashboard si possa fare anche tramite l’API. Sincronizza i prodotti, crea pagine di pagamento, elabora gli ordini, gestisci le licenze e ascolta gli eventi in tempo reale. Un formato di risposta coerente, permessi granulari e una consegna affidabile dei webhook rendono la tua integrazione pronta per la produzione fin dal primo giorno.
Crea fattura
REST
Richiesta
POST · crea
Idempotency-Key: 7d1f0c2a-…
Risposta
Fattura creata
X-Request-Id: req_4c1e9a…
Limite di richieste13 su 300 usate in questo minuto
Consegne dei webhook
HMAC-SHA256
- 200Consegnato
Evento ordine
Firmato · tentativo 1
- 200Consegnato
Evento scorte
Firmato · tentativo 1
- 503Nuovo tentativo tra 1 min
Evento recensione
Firmato · tentativo 1
- 200Consegnato
Evento prelievo
Firmato · tentativo 1
1 min…12 hfinestra dei tentativi
Funzionalità
API pensate per la produzione. Accesso granulare, comportamento prevedibile e consegna affidabile.
API REST completa
Prodotti, varianti, scorte, numeri di serie, file, categorie, fatture, ordini, spedizioni e rimborsi, clienti, coupon, campagne, abbonamenti, ticket di assistenza, recensioni, domande, affiliati e webhook. Nell’API ci sono anche azioni come creare fatture, rimborsi, annullamenti, PDF e rinviare le consegne.
Accesso sicuro e controllato
Chiavi API con permessi di lettura e scrittura per risorsa, chiavi di sola lettura, date di scadenza e whitelist di IP. Vedi il numero di chiamate e di errori per ogni chiave.
Pensata per la produzione
Un formato di risposta coerente, un ID di tracciamento su ogni richiesta (
X-Request-Id) e il supporto diIdempotency-Keysulle operazioni di creazione. Un limite di 300 richieste al minuto, con intestazioni di rate limit chiare.Webhook firmati
Ricevi in tempo reale gli eventi di ordini, prodotti, scorte, recensioni, verifiche, clienti, prelievi e affiliati. Ogni richiesta è firmata con HMAC-SHA256 e le consegne fallite vengono ritentate in automatico a intervalli crescenti, da 1 minuto fino a 12 ore. Sono disponibili un registro delle consegne, il rinvio manuale e gli invii di prova, e puoi instradare i webhook direttamente su un canale Discord.
SDK per il browser e checkout integrato
Gestisci carrello, prodotti e checkout dalla tua interfaccia con l’SDK
window.PapelShip, e apri il checkout come pagina o come finestra integrata.Payments API
Link di pagamento ospitati, fatture di pagamento in crypto con indirizzo, importo e codice QR, consultazione dello stato dei pagamenti e rimborsi, con uno schema OpenAPI e un webhook firmato dedicato.
API delle licenze
Consulta le licenze qPapel, reimposta i blocchi hardware, congela, banna e aggiungi tempo. Per i tuoi rivenditori è disponibile un’API separata.
MCP per agenti IA
Collega in sicurezza strumenti IA come Claude, Cursor e VS Code con OAuth e lascia che modifichino il codice del tuo tema. Le modifiche vengono salvate come bozze e la pubblicazione resta nelle tue mani.
Plugin già pronti
Plugin di pagamento per WooCommerce, XenForo, WHMCS, Magento e altri.
Come funziona
Tre passaggi per iniziare.
- 01
Crea una chiave API
Scegli i permessi di cui ha bisogno.
- 02
Aggiungi il tuo endpoint webhook
Invia un evento di prova.
- 03
Metti online la tua integrazione.
Continua a esplorare
Prodotti, documentazione e guide. Da dove proseguire.
- DocumentazioneGuida rapidaConfigura l’accesso e invia la tua prima richiesta.
- DocumentazioneAutenticazioneLe chiavi API e il modo in cui le richieste vengono autorizzate.
- DocumentazioneRiferimento Store APIProdotti, ordini, clienti e tutto il resto del tuo negozio.
- DocumentazioneWebhookRicevi gli eventi del negozio e verifica le loro firme.
- DocumentazioneRiferimento qPapel APIGestisci le licenze dai tuoi sistemi.
- DocumentazioneMCP per strumenti IACollega gli strumenti IA per il codice al codice del tuo tema.
- GuidaHow to add a checkout widget to your website: embedded checkout for card, crypto and bank transferAdd a checkout widget to your website with one script tag. How embedded checkout works, how to set it up, which payment methods it takes and what happens next.
- GuidaCrypto POS API integration: checkout, in-store terminals and payoutsA developer's guide to crypto POS API integration: create invoices server-side, handle webhooks idempotently, take crypto in store and reconcile payouts.
