Preskoči na glavni sadržaj
Izbornik API dokumentacije
← Referenca API-ja

Vlastiti web shop ili ERP

Bez dodatka vaš programer povezuje konfigurator s košaricom. Pravilo je jedna rečenica: cijena koju je poslao preglednik nikad ne postaje cijena u košarici dok je vaš poslužitelj ne provjeri kod CutOptima.

Rani pristup: API za trgovce je izrađen i može se isprobati u sandbox web shopu; dodaci za platforme web shopova još su u razvoju. CutOptim ne naplaćuje plaćanja: košarica, blagajna i plaćanje ostaju u vašem web shopu.

Putanje, nazivi polja, kodovi pogrešaka, nazivi zaglavlja i primjeri kôda ostaju na engleskom: oni su ugovor.

Provjere na strani poslužitelja

  • Primite narudžbu sa svoje stranice (događaj cutoptim:order), zajedno s ponudom i id-jem narudžbe.
  • Provjerite token ponude pomoću POST /cfg/v1/quote/verify i svog tajnog ključa. Prihvatite samo valid: true uz redeemed: true; reason: "unavailable" znači da nije provjereno.
  • Usporedite tvrdnje tokena s vašom košaricom: vaš id tenanta, vaša valuta, nije istekao.
  • Dohvatite narudžbu pomoću GET /cfg/v1/orders/{id} i usporedite njezin hash plana, hash ponude i ukupne iznose s provjerenim tokenom.
  • Stvorite stavku u košarici po provjerenoj cijeni i zapamtite nonce tokena kako ista ponuda ne bi mogla postati druga stavka.

Zašto lokalna provjera nije dovoljna

Referentni kôd može lokalno provjeriti token: njegov oblik, 11 tvrdnji, kanonski oblik, vašeg tenanta i istek. Ne može dokazati potpis jer ključ za potpisivanje ostaje kod CutOptima. Samo udaljena provjera kaže da je cijenu potpisao servis.

Primanje webhooka

Provjerite potpis nad sirovim tijelom, uklonite duplikate prema id-ju događaja i odgovorite 2xx; cjeloviti prijamnik je u Webhookovi.

Referentni kôd

Dva mala primjera bez ovisnosti za čitanje i kopiranje: Node (cutoptim-verify.mjs, example-server.mjs) i PHP (CutOptimVerify.php, example-webhook.php). To je referentni kôd, a ne hostirani servis. Preuzimanja i vodič: Vlastita platforma i stranica pomoći.

Gumba „isprobaj“ ovdje namjerno nema: tajni ključ pripada vašem poslužitelju, nikad pregledniku. Demo web shop prikazuje ugradnju i predaju narudžbe u radu od početka do kraja.

Otvori demo web shop uživoCutOptim Konfigurator

Pravne informacijeUvjeti konfiguratora (EN) ·Ugovor o obradi podataka (EN) ·Obavijest o privatnosti za kupce ·Licencije trećih strana (EN)