자체 봇에서 결제받기
토큰을 받고 코드로 청구서를 만든 뒤 결제 웹훅을 처리하세요. 테스트 토큰으로 출시 전에 전체 흐름을 확인할 수 있어요.
코인 8종 · 자산과 네트워크 조합 16개를 하나의 잔액으로 관리 MCP 서버로 AI 에이전트가 연동을 준비해요 →
토큰 받기
봇에서 앱을 만들고 Merchant API 토큰을 받으세요.
청구서 만들기
금액, 코인, 설명을 넣어 API를 호출해요. 웹훅 URL은 앱 설정에서 등록해요.
결제 링크 보여주기
링크나 버튼을 제공하면 Telegram에서 결제해요.
웹훅 처리하기
결제 이벤트를 검증한 후 상품을 전달하거나 서비스 이용 권한을 주세요.
AI 에이전트가 연동을 준비해요
Merchant API는 MCP 서버를 제공해요. URL을 주면 에이전트가 문서를 읽고, 승인을 받아 앱을 만들고, 웹훅과 코드를 준비해요. 토큰을 직접 복사할 필요 없어요.
- 단계 1
에이전트에게 요청 보내기
- 단계 2
Telegram에서 앱 승인
- 단계 3
에이전트가 설정 완료
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
제품에 결제 기능 연결
요청으로 청구서를 만들고 웹훅으로 상태를 받아요. 나머지는 제품에 맞게 구성하세요.
토큰과 테스트 환경
별도의 테스트 토큰으로 실제 이용자에게 공개하기 전에 결제 과정을 확인해요.
코드에서 청구서 관리
HTTP 요청으로 만들고, 취소하고, 상태를 확인해요. SDK는 필수가 아니에요.
정기 결제
이용자가 한 번 동의하면 Merchant API가 일정에 맞춰 구독료를 결제해요.
결제 웹훅
결제 후 이벤트를 보내고 실패하면 다시 시도해요. 수신 쪽에서 서명을 검증하고 중복 처리를 막아야 해요.
문서와 예시
도움말 센터에서 메서드, 오류 코드, 요청 예시를 확인하세요.
코인 8종 · 자산과 네트워크 조합 16개를 하나의 잔액으로 관리
GRAM
BTC
ETH
SOL
BNB
LTC
DOGE
TRX
USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL
USDCERC-20 · BEP-20 · SOL
잔액 일부에서 자동으로 쌓이는 보상
Earn에 넣은 금액의 보상은 자동으로 계산해 지갑에 반영해요. 언제든 자산을 추가하거나 출금할 수 있어요.
USDT
4%
처음 500 USDT
1%
500 초과분
GRAM
6%
처음 300 GRAM
3%
300 초과분
보내기 전 확인과 보호
출금은 외부 주소로 자산을 보내는 기능이에요. 확정 전후에 다음 확인과 보호가 적용돼요.
- 확정 전
- 주소, 네트워크, 메모를 전체 표시 "4f3a…9c2b"처럼 줄인 주소만 보지 않고, 전체 주소와 네트워크를 확인할 수 있어요.
- 저장한 주소 미리 저장한 주소로만 출금하도록 설정할 수 있어요.
- PIN 또는 Face ID 출금할 때마다 PIN이나 PIN으로 등록한 기기의 생체 인증이 필요해요. 세션당 한 번의 확인으로 끝나지 않아요.
- 출금 확정
- 확정 후
- 큰 금액 출금 늦추기 이 보호 기능을 켜면 해당 출금을 보내기 전에 잠시 보류해요. 이 시간에는 취소할 수 있어요.
- 트랜잭션 AML 검사 자산을 보내기 전에 검사해요.
- 거래 알림 설정에 따라 거래 알림을 받아요. 중요한 보안 알림은 항상 보내요.
미리 확인하는 조건
수수료를 포함해 차감할 금액은 확정 전에 표시돼요.
현재 수수료와 최소 금액은 앱에서 확인할 수 있어요. 전체 목록은 도움말 센터에서 확인하세요.
자주 묻는 질문
지갑, 송금, Earn, 결제에 관한 기본 안내예요.
