Tenant API Sandbox

Esegue una sequenza di chiamate verso l'API del tenant e mostra richiesta/risposta.

Come usare il sandbox

Obiettivo: verificare che il tenant (WordPress/WooCommerce oppure API custom) esponga gli endpoint richiesti dalla spec e che le credenziali funzionino.

Sequenza tipica: GET customer → GET orders → GET products → (opzionale) POST /cart/session → GET /cart → POST /cart/add-item → (opzionale) POST /checkout.

Note checkout: crea un ordine reale. Richiede indirizzi di fatturazione/spedizione valorizzati sul cliente e un metodo di pagamento abilitato in WooCommerce (es. bacs, cod).

Estensioni: le risposte di customer/prodotti/ordini possono includere meta_data (array key/value) per informazioni extra non previste dalla spec “core”.

Tipo integrazione tenant

Se scegli WordPress+WooCommerce, cart/checkout passano dal plugin SalesMate su /wp-json/salesmate/v1.

Customer ID (ID utente nel tuo e-commerce)

Deve esistere. Usato per /customers/{id}, /orders?customer=..., cart session e checkout.

Dominio WordPress (solo se “WordPress + WooCommerce”)

Inserisci solo il dominio (senza https:// e senza slash finali). Il sandbox costruisce automaticamente: /wp-json/wc/v3 e /wp-json/salesmate/v1

Base URL API dati (customers, orders, products) – solo “API custom”

URL completo (https://...), senza slash finale. Deve esporre /customers, /orders, /products.

Base URL API store (cart, checkout) – solo “API custom”

URL completo (https://...), senza slash finale. Deve esporre /cart, /cart/add-item, /cart/remove-item, /checkout.

Base URL API estensioni (cart session) – solo “API custom”

Serve per POST /cart/session (ritorna cart_token)

WooCommerce Consumer Key (ck_...)

Viene usata come username in HTTP Basic Auth

WooCommerce Consumer Secret (cs_...)

Viene usata come password in HTTP Basic Auth. Generale in WooCommerce → Impostazioni → Avanzate → REST API (permessi Read/Write).

Verifica certificato TLS/SSL (consigliato)

Disattiva solo per test con certificati non validi/self-signed. In produzione deve essere attivo.

Esegui test carrello (Cart-Token + cart session)

Richiede POST /cart/session e poi chiamate carrello (Cart-Token). Su WordPress serve il plugin SalesMate (endpoint /wp-json/salesmate/v1).

Esegui anche checkout (può creare un ordine reale)

Attivalo solo su ambiente di test/staging. Richiede billing/shipping sul cliente e metodo pagamento disponibile.

Modalità checkout

Imposta payment_method. Se ricevi woocommerce_rest_checkout_payment_method_disabled abilita quel metodo in WooCommerce (Pagamenti) o cambia modalità.