Vai al contenuto principale
POST
curl

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Corpo

application/json
amount_in_dollars
number
obbligatorio

Importo da addebitare, in USD. Deve essere compreso tra 50 e 20.000. Il saldo riceve lo stesso importo, senza sconti o bonus. Le imposte vengono aggiunte automaticamente al checkout in base all'indirizzo di fatturazione del cliente.

Intervallo richiesto: 50 <= x <= 20000
success_url
string<uri>

URL a cui il checkout ospitato reindirizza il cliente dopo un pagamento riuscito. Attualmente il valore predefinito è https://console.didit.me. Passa esplicitamente un URL funzionante; l'host predefinito non è disponibile. Aggiungi il segnaposto letterale {CHECKOUT_SESSION_ID} se desideri che il checkout ospitato sostituisca l'ID sessione.

cancel_url
string<uri>

URL a cui il checkout ospitato reindirizza il cliente quando interrompe o chiude la finestra di checkout. Attualmente il valore predefinito è https://console.didit.me. Passa esplicitamente un URL funzionante; l'host predefinito non è disponibile.

Risposta

Sessione di checkout ospitata creata. Reindirizza l'utente a checkout_session_url per completare il pagamento.

checkout_session_id
string
obbligatorio

Identificatore della sessione di checkout ospitata (ad es. cs_test_a1B2c3...). Utile per la riconciliazione lato server.

checkout_session_url
string<uri>
obbligatorio

URL monouso della pagina di pagamento ospitata. Reindirizza il cliente qui per completare il pagamento.

Ultima modifica il 7 novembre 2026