Merchant API

Accetta pagamenti nel tuo bot

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

10 criptovalute · 8 reti in un unico saldo Un server MCP permette al tuo agente AI di preparare l'integrazione →
Schermata della Merchant API: app e collegamento di un agente AI
Webhook: fattura pagata
Testnet
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 ha un server MCP. Collegalo in un client agente compatibile: l'agente può leggere la documentazione, richiedere la creazione di un'app, configurare i webhook e aiutare a scrivere l'integrazione. Tu approvi l'app in Telegram, poi verifichi e provi il risultato.

  1. Passaggio 1

    Invia la richiesta al tuo agente

  2. Passaggio 2

    Approva l'app in Telegram

  3. Passaggio 3

    Completa e prova l'integrazione

Funzionamento, richieste per ogni client e permessi dell'agente →
Richiesta da inviare al tuo agente
Connect the MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the 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 testnet

Prova il percorso di pagamento nel bot separato della testnet, @tgpaycrypto_testnet_bot, prima di proporlo 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.

10 criptovalute · 8 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
La conferma del prelievo
Indirizzo valido
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 Prima di confermare, controlla l'indirizzo del destinatario, la rete e il memo se richiesto. Un formato valido non prova che l'indirizzo appartenga al destinatario previsto.
  • 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 dei prelievi Ricevi le notifiche secondo le tue impostazioni. Gli avvisi critici di sicurezza restano attivi.
Condizioni

Condizioni visibili in anticipo

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

Depositi nel portafoglio I fondi vengono accreditati dopo le conferme della rete. Gli importi inferiori al minimo della rete non vengono accreditati. Il primo indirizzo su ogni rete è gratuito, ogni indirizzo aggiuntivo costa 5 USD. 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 La commissione è inclusa nel tasso. Tasso e importo finale compaiono nella schermata di scambio. Visibili prima della conferma
Prelievo sulla blockchain Il formato dell'indirizzo viene controllato prima dell'invio. Indirizzo, rete e Memo compaiono nella schermata di conferma. Commissione di prelievo indicata nell'app

Le commissioni e gli importi minimi aggiornati sono indicati nell'app.

USDT GRAM BTC ETH SOL BNB LTC DOGE
10 criptovalute · 8 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 nell'app
Il mio prelievo TRC-20 non è arrivato. Cosa devo fare? Stiamo controllando la transazione. Ti rispondiamo qui in chat.
Apri il portafoglio
Domande frequenti

Domande frequenti

L'essenziale su portafoglio, trasferimenti e pagamenti.

No. Il portafoglio viene creato quando apri @tgpaycryptobot per la prima volta, senza un accesso aggiuntivo né frase di recupero. L'accesso è legato al tuo account Telegram. Per inviare fondi devi prima impostare un PIN.

Dieci 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 o l'ID numerico di Telegram. Non serve un indirizzo: il trasferimento avviene all'interno del portafoglio, senza commissioni di rete. Se il destinatario non ha mai aperto TgPay Crypto, il trasferimento resta in attesa e viene accreditato alla prima apertura del bot. Se non lo riceve entro 30 giorni, i fondi tornano a te. Puoi anche inviare un buono: un link che può riscattare la prima persona che lo apre.

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.

Non hai trovato la risposta? Scrivi all'assistenza nell'app

Apri il portafoglio in pochi passaggi

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

Il tuo profilo: