Merchant API

Accetta pagamenti nel tuo bot

Ottieni un token, crea fatture dal codice e gestisci i webhook di pagamento. Un token di test permette di verificare l'intero percorso prima del rilascio.

8 criptovalute · 16 combinazioni di asset e reti in un unico saldo Un server MCP permette al tuo agente AI di preparare l'integrazione →
La schermata dei token API e dei webhook
Webhook consegnato
Ambiente di test
Per iniziare

Collegare la Merchant API

Dal token al primo webhook in quattro passaggi. Scopri la Merchant API →

Passaggio 1

Ottieni un token

Crea un'app nel bot e ottieni il token per la Merchant API.

Passaggio 2

Crea una fattura

Una chiamata API con importo, crypto e descrizione. L'URL del webhook si configura nelle impostazioni dell'app.

Passaggio 3

Mostra il link di pagamento

Offri un link o un pulsante. Il pagamento avviene in Telegram.

Passaggio 4

Gestisci il webhook

Verifica l'evento di pagamento, poi consegna il prodotto o concedi l'accesso nel tuo servizio.

Agente AI

Il tuo agente AI può preparare l'integrazione

La Merchant API dispone di un server MCP. Passa l'URL all'agente: consulta la documentazione, crea l'app con il tuo consenso, configura il webhook e scrive il codice. Non devi copiare token a mano.

  1. Passaggio 1

    Invia la richiesta al tuo agente

  2. Passaggio 2

    Approva l'app in Telegram

  3. Passaggio 3

    L'agente completa la configurazione

Funzionamento, richieste per ogni client e permessi dell'agente →
Richiesta da inviare al tuo agente
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
Funzionalità

Pagamenti integrati nel tuo prodotto

Le richieste creano le fatture e i webhook ne comunicano lo stato. Il resto lo adatti al tuo prodotto.

Token e ambiente di test

Un token separato per provare il percorso di pagamento prima di aprirlo agli utenti.

Fatture dal codice

Crea, annulla e consulta le fatture con semplici richieste HTTP, senza SDK obbligatorio.

Addebiti ricorrenti

L'utente approva l'abbonamento una volta, poi la Merchant API esegue gli addebiti secondo il calendario.

Webhook di pagamento

L'evento viene inviato dopo il pagamento, con nuovi tentativi in caso di errore. L'integrazione deve verificare la firma ed evitare di elaborare i duplicati.

Documentazione ed esempi

Riferimento dei metodi, codici di errore ed esempi di richieste nel centro assistenza.

Tutti i dettagli nel centro assistenza

8 criptovalute · 16 combinazioni di asset e reti in un unico saldo

GRAM BTC ETH SOL BNB LTC DOGE TRX
USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL USDCERC-20 · BEP-20 · SOL

Gestisci un canale o vendi su Telegram?

Scegli il tuo profilo per vedere le funzionalità più adatte.

Per creator Per venditori Per sviluppatori
Earn

Guadagni che maturano automaticamente

Sposta parte del saldo in Earn: i guadagni maturano automaticamente e vengono accreditati nel portafoglio. Puoi aggiungere o prelevare fondi quando vuoi.

Tasso annuo Maturazione ogni ora
USDT 4% primi 500 USDT 1% oltre 500
GRAM 6% primi 300 GRAM 3% oltre 300
Accredito giornaliero nel portafoglio alle 00:30 UTC Aggiunta e prelievo senza commissioni
Aggiungi fondi a Earn
La schermata Earn
La conferma del prelievo
Indirizzo corrispondente
Sicurezza

Controlli prima dell'invio

Un prelievo invia fondi a un indirizzo esterno. Ecco i controlli e le protezioni che accompagnano la conferma.

  • Prima della conferma
  • Indirizzo, rete e memo per intero Vedi l'indirizzo completo e la rete di destinazione, non solo una forma abbreviata come "4f3a…9c2b".
  • Indirizzi salvati Puoi consentire i prelievi solo verso gli indirizzi salvati in precedenza.
  • PIN o Face ID Ogni prelievo richiede il PIN o la biometria attivata con il PIN sul dispositivo. Una conferma per sessione non basta.
  • Confermi il prelievo
  • Dopo la conferma
  • Una pausa per gli importi elevati Se attivi questa protezione, i prelievi interessati restano in attesa prima dell'invio. Durante la pausa puoi ancora annullarli.
  • Controllo AML della transazione Il controllo avviene prima dell'invio dei fondi al destinatario.
  • Notifiche delle operazioni Ricevi le notifiche secondo le tue impostazioni. Gli avvisi critici di sicurezza restano attivi.

La sicurezza nel centro assistenza

Condizioni

Condizioni visibili in anticipo

L'importo da addebitare, incluse le commissioni, è visibile prima della conferma.

Depositi nel portafoglio Accreditati dopo le conferme di rete
Senza commissioni
Trasferimenti tramite username in Telegram I fondi restano nel servizio, senza transazioni sulla blockchain né commissioni di rete
Senza commissioni
Scambia nel portafoglio Tasso di cambio, commissione e importo finale nella schermata di scambio
Visibili prima della conferma
Prelievo sulla blockchain Indirizzo, rete e memo richiesto vengono controllati prima dell'invio
Commissione di prelievo indicata nell'app
Aggiunta e prelievo di fondi da Earn Nessun vincolo di durata
Senza commissioni

Commissioni e minimi aggiornati sono nell'app. L'elenco completo è disponibile nel centro assistenza.

USDT GRAM BTC ETH SOL BNB LTC DOGE
8 criptovalute · 16 combinazioni di asset e reti — un unico saldo

Non serve un portafoglio per ogni rete: deposita e preleva sulla rete che preferisci tra quelle supportate.

TRC-20 · ERC-20 · BEP-20 · TON · SOL · BTC · LTC · DOGE

online Assistenza in Telegram
Il mio prelievo TRC-20 non è arrivato. Cosa devo fare? Stiamo controllando la transazione. Ti rispondiamo qui in chat.
@tgpayhelpbot
Domande frequenti

Domande frequenti

L'essenziale su portafoglio, trasferimenti, Earn e pagamenti.

Il portafoglio viene creato alla prima apertura di @tgpaycryptobot. Non servono credenziali separate, password o frase di recupero: l'accesso è collegato al tuo account Telegram.

Otto criptovalute e sedici combinazioni di asset e reti: GRAM, BTC, ETH, SOL, BNB, LTC, DOGE e TRX, oltre a USDT su cinque reti e USDC su tre. Scegli la rete per il deposito o il prelievo e usa l'indirizzo corrispondente.

Inserisci il suo username. Il trasferimento resta nel servizio, senza indirizzo né commissione di rete. Se non ha ancora un portafoglio, puoi inviargli un buono da riscattare.

Sposta parte del saldo in Earn per maturare guadagni automaticamente. Il tasso annuo è del 4% sui primi 500 USDT e dell'1% oltre questa soglia; del 6% sui primi 300 GRAM e del 3% oltre. I guadagni maturano ogni ora e vengono accreditati ogni giorno alle 00:30 UTC. Puoi aggiungere o prelevare fondi in qualsiasi momento, senza commissioni.

Un buono contiene crypto da condividere tramite link o codice QR, con uno o più riscatti. Puoi impostare password, scadenza e accesso riservato agli iscritti dei tuoi canali o agli utenti Telegram Premium. Dopo la creazione puoi sospenderlo, modificarne importo e numero di riscatti o eliminarlo. L'importo restante torna sul tuo saldo.

I trasferimenti tramite username non hanno commissioni di rete. I prelievi prevedono la commissione indicata nell'app. Commissione di scambio e importo finale sono visibili prima della conferma. Valori e minimi aggiornati sono nell'app e nel centro assistenza.

Crea fatture nel bot o automatizzale con la Merchant API. Una richiesta crea la fattura e un webhook ne segnala il pagamento. La documentazione dei metodi è nel centro assistenza.

Tutte le risposte sono disponibili nel centro assistenza Per altre domande, scrivi a @tgpayhelpbot

Apri il portafoglio in pochi passaggi

Avvia @tgpaycryptobot in Telegram. Il tuo portafoglio è pronto a ricevere crypto.

Apri in Telegram
Il tuo profilo:
Personale Per creator Per venditori Per sviluppatori