Merchant API (Sviluppatori)
La Merchant API: app, fatture, trasferimenti e webhook.
Che cos'è la Merchant API?
La Merchant API è l'API di pagamento dell'app per aziende e bot. Crei un'app, ottieni un token API e con quello fatturi agli utenti Telegram, gli mandi pagamenti e controlli il tuo saldo, tutto dal tuo codice.
Iniziare da sviluppatore
Crei un'app nella Mini App, copi il token API l'unica volta in cui te lo mostriamo e cominci a chiamare l'API. Tutta la configurazione sta sotto Altro → Merchant API.
Collegare un agente AI
Dai al tuo agente AI un URL solo — https://app.tgpaycrypto.com/mcp — e l'integrazione dei pagamenti te la costruisce lui: legge la documentazione dell'API, crea la tua app da esercente, imposta i webhook e scrive il codice. Tu approvi la nuova app una volta sola, con un pulsante nel bot. Niente terminale e nessun token API da copiare a mano.
Incassare con le fatture
La fattura è il modo in cui addebiti qualcosa a un utente Telegram. La crei dall'API, mandi il link a chi deve pagare e il saldo della tua app viene accreditato nell'istante in cui quella persona conferma.
Commissioni e limiti della Merchant API
Le fatture hanno una commissione della piattaforma, che viene detratta da quello che incassi; trasferimenti e buoni hanno limiti di importo. I valori qui sotto sono le impostazioni attuali, non clausole contrattuali: quando non coincidono con quello che vedi ha ragione l'app, e la fonte affidabile restano sempre le tue fatture pagate.
Riferimento della Merchant API
Le convenzioni comuni a tutti i metodi, più i metodi di sola lettura del catalogo. Le pagine metodo per metodo: fatture e rimborsi, trasferimenti e buoni, abbonamenti, webhook.
Riferimento API: fatture e rimborsi
I metodi delle fatture: createInvoice, getInvoices, deleteInvoice, refundInvoice. Le convenzioni comuni (autenticazione, busta, importi, spend_id) stanno nella pagina Riferimento della Merchant API; la guida passo passo è Incassare con le fatture.
Riferimento API: trasferimenti e buoni
I metodi per pagare. Un trasferimento manda dei fondi dal saldo della tua app direttamente al portafoglio di un utente Telegram; un buono è un link da riscattare che finanzi in anticipo. Le convenzioni comuni (autenticazione, busta, importi, spend_id) stanno nella pagina Riferimento della Merchant API.
Riferimento API: abbonamenti
Fatturazione ricorrente: un'estensione rispetto a Crypto Bot. Crei un piano (importo + periodo), mandi agli utenti il suo link di approvazione, e la piattaforma li addebita sul saldo del portafoglio a ogni periodo, accreditando il saldo della tua app al netto della commissione. Le convenzioni comuni stanno nella pagina Riferimento della Merchant API.
Riferimento API: webhook
I webhook inviano gli eventi al tuo server nel momento in cui succedono. Imposta l'URL del webhook sulla tua app in Altro → Merchant API: da lì in poi la piattaforma manda in POST un corpo JSON firmato per ogni evento a cui sei iscritto.