Az egész áruházad egyetlen API-hívásnyira
Kösd a PapelShip-et a saját rendszereidhez átfogó REST API-val, aláírt webhookokkal, böngészős SDK-val és licenc-API-val.
- Kérési korlát
- 300 kérés percenként
- Webhook-aláírások
- HMAC-SHA256
- Újrapróbálkozások
- 1 perctől 12 óráig
- Idempotencia
- Létrehozási műveleteknél
Fejlesztőknek
A PapelShip-et úgy terveztük, hogy szinte mindent, amit az irányítópulton megtehetsz, az API-n keresztül is megtehess. Szinkronizálj termékeket, hozz létre fizetési oldalakat, dolgozz fel rendeléseket, kezelj licenceket, és figyeld az eseményeket valós időben. Az egységes válaszformátum, a részletes jogosultságok és a megbízható webhook-kézbesítés az első naptól éles használatra kész integrációt ad.
Számla létrehozása
REST
Kérés
POST · létrehozás
Idempotency-Key: 7d1f0c2a-…
Válasz
Számla létrehozva
X-Request-Id: req_4c1e9a…
Kérési korlát13 / 300 felhasználva ebben a percben
Webhook-kézbesítések
HMAC-SHA256
- 200Kézbesítve
Rendelési esemény
Aláírva · 1. próbálkozás
- 200Kézbesítve
Készletesemény
Aláírva · 1. próbálkozás
- 503Újrapróbálás 1 perc múlva
Értékelési esemény
Aláírva · 1. próbálkozás
- 200Kézbesítve
Kivételi esemény
Aláírva · 1. próbálkozás
1 perc…12 óraújrapróbálkozási időszak
Funkciók
Éles használatra épített API-k. Részletes hozzáférés, kiszámítható működés és megbízható kézbesítés.
Átfogó REST API
Termékek, változatok, készlet, sorozatszámok, fájlok, kategóriák, számlák, rendelések, szállítás és visszatérítések, vásárlók, kuponok, kampányok, előfizetések, támogatási jegyek, értékelések, kérdések, affiliate-partnerek és webhookok. Az olyan műveletek is elérhetők az API-ban, mint a számlák létrehozása, a visszatérítések, a lemondások, a PDF-ek és a kézbesítések újraküldése.
Biztonságos, szabályozott hozzáférés
API-kulcsok erőforrásonkénti olvasási és írási jogosultsággal, csak olvasható kulcsok, lejárati dátumok és IP-engedélylisták. Minden kulcsnál látod a hívások és a hibák számát.
Éles használatra építve
Egységes válaszformátum, minden kérésen követőazonosító (
X-Request-Id) ésIdempotency-Keytámogatás a létrehozási műveleteknél. Percenként 300 kérés a korlát, egyértelmű rate limit fejlécekkel.Aláírt webhookok
Valós időben kapsz rendelés-, termék-, készlet-, értékelés-, ellenőrzési, vásárlói, kivételi és affiliate-eseményeket. Minden kérést HMAC-SHA256-tal írunk alá, a sikertelen kézbesítéseket pedig automatikusan újrapróbáljuk egyre hosszabb időközökkel, 1 perctől 12 óráig. Van kézbesítési napló, kézi újraküldés és tesztküldés, a webhookokat pedig egyenesen egy Discord-csatornára is irányíthatod.
Böngészős SDK és beágyazott fizetés
Kezeld a kosarat, a termékeket és a fizetést a saját felületedről a
window.PapelShipSDK-val, és nyisd meg a fizetést oldalként vagy beágyazott ablakként.Fizetési API
Hosztolt fizetési linkek, kriptós fizetési számlák címmel, összeggel és QR-kóddal, fizetési státusz lekérdezése és visszatérítések, OpenAPI sémával és saját aláírt webhookkal.
Licenc-API
Kérdezz le qPapel-licenceket, állítsd vissza a hardverkötéseket, fagyaszd be, tiltsd, és adj hozzá időt. A viszonteladóidnak külön viszonteladói API áll rendelkezésre.
MCP AI-ügynököknek
Kösd be biztonságosan OAuth-tal az AI-eszközöket, például a Claude-ot, a Cursort és a VS Code-ot, és engedd, hogy szerkesszék a témakódodat. A módosítások piszkozatként mentődnek, a közzététel pedig a te kezedben marad.
Kész bővítmények
Fizetési bővítmények a WooCommerce, a XenForo, a WHMCS, a Magento és más rendszerek számára.
Hogyan működik
Három lépés az induláshoz.
- 01
Hozz létre egy API-kulcsot
Válaszd ki a szükséges jogosultságokat.
- 02
Add meg a webhook végpontját
Küldj egy teszteseményt.
- 03
Élesítsd az integrációdat.
Fedezz fel többet
Termékek, dokumentáció és útmutatók. Merre tovább.
- DokumentációGyors kezdésÁllítsd be a hozzáférést, és küldd el az első kérésedet.
- DokumentációHitelesítésAPI-kulcsok, és hogyan kapnak jogosultságot a kérések.
- DokumentációStore API-referenciaTermékek, rendelések, vásárlók és az áruházad minden más eleme.
- DokumentációWebhookokFogadd az áruházi eseményeket, és ellenőrizd az aláírásukat.
- DokumentációqPapel API-referenciaKezeld a licenceket a saját rendszereidből.
- DokumentációMCP AI-eszközökhözKösd össze az AI-kódoló eszközöket a témakódoddal.
- ÚtmutatóHow 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.
- ÚtmutatóCrypto 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.
