Passo 1: Crea il Tuo Account
Iscriviti gratuitamente a Cost+ su dashboard.costplus.io/register. Non è richiesta la carta di credito. Avrai accesso immediato al Portale del Commerciante dove potrai gestire i tuoi siti web, visualizzare le transazioni e configurare i metodi di pagamento.
Passo 2: Imposta un Sito Web
Nel Portale del Commerciante, vai su Siti Web e crea un nuovo sito. Puoi creare un sito sandbox per i test o un sito di produzione per i pagamenti reali. Ogni sito riceve una propria chiave API.
Passo 3: Ottieni la Tua Chiave API
Vai su Siti Web, seleziona il tuo sito e clicca su Integrazione. Qui troverai la tua chiave API e l'ID Commerciante. Tieni la chiave API al sicuro e non esporla mai nel codice lato client.
Passo 4: Accetta il Tuo Primo Pagamento
Il modo più veloce per iniziare è usare la Pagina di Pagamento Ospitata. Crea un ordine tramite API e reindirizza il cliente all'URL di pagamento. Ecco un esempio di un ordine base:
- Invia una richiesta POST a https://api.costplus.online/v1/orders/
- Includi la valuta (es. "EUR"), l'importo in centesimi (es. 1295 per EUR 12,95) e un URL di ritorno
- L'API restituisce un payment_url - reindirizza il cliente lì
- Dopo il pagamento, il cliente torna al tuo return_url
- Verifica lo stato del pagamento tramite API o webhook
Passo 5: Testa la Tua Integrazione
Usa la chiave API del tuo sito sandbox per i test. Non c'è un URL sandbox separato - si usa lo stesso endpoint (https://api.costplus.online/v1/) con credenziali sandbox. Usa il numero di carta di test 4111 1111 1111 1111 con qualsiasi data di scadenza futura e qualsiasi CVC a 3 cifre.
Connetti il Tuo Negozio
Se usi una piattaforma eCommerce, installa il nostro plugin ufficiale invece di programmare direttamente contro l'API. Supportiamo Shopify, WooCommerce, PrestaShop, Magento, OpenCart, Shopware, nopCommerce, Drupal Commerce, modified eCommerce e osCommerce. Le integrazioni per Wix ed Ecwid arriveranno presto.
Hai Bisogno di Aiuto?
Contatta il nostro team di supporto all'indirizzo support@costplus.io oppure visita il nostro Help Desk su helpdesk.costplus.io. La nostra documentazione per sviluppatori è disponibile su docs.costplus.io.