Sign in
소개/일반 정보

개요

2328.io와 암호화폐 결제 처리 및 출금을 통합하기 위한 기술 사양.

Markdown으로 보기·llms.txt

2328.io API 문서에 오신 것을 환영합니다. 본 레퍼런스는 암호화폐 결제 처리 및 출금을 애플리케이션에 통합하는 방법을 설명합니다.

시작하기

통합을 시작하려면:

  1. 2328.io에서 가맹점 계정과 프로젝트를 생성합니다
  2. 프로젝트 설정에서 project UUID와 API key를 발급받습니다
  3. 출금 기능을 사용할 계획이라면 별도의 Payout API key를 생성합니다
  4. Authentication 섹션을 읽고 요청 서명 방법을 익힙니다
  5. 첫 번째 Create Payment 호출을 수행합니다

Base URL

모든 프로덕션 API 요청은 다음 base URL을 사용합니다:

Text
https://api.2328.io/api

모든 요청은 반드시 HTTPS로 이루어져야 합니다. HTTPS를 사용하지 않는 요청은 차단됩니다.

가능한 작업

2328.io API로 다음과 같은 작업을 수행할 수 있습니다:

  • 암호화폐 결제 수락 — 결제 세션을 생성하고 고객을 호스팅된 결제 페이지 또는 Telegram MiniApp으로 리디렉션
  • 자금 출금 — 가맹점 잔액에서 임의의 블록체인 주소로 프로그래밍 방식의 출금 실행
  • 잔액 조회 — 통화별 머천트 계정 잔액, USD 환산액, AML로 잠긴 금액을 확인합니다
  • 정적 지갑 사용 — 사용자 또는 주문에 연결된 영구 입금 주소 생성
  • 환율 조회 — 법정화폐 및 암호화폐 페어의 실시간 환율 조회
  • Webhook 수신 — 결제 상태가 변경될 때 즉시 알림 수신

요청 제한

API는 프로젝트당 초당 최대 10회 요청을 허용합니다. 제한을 초과한 요청은 HTTP 429 Too Many Requests 응답을 받습니다 — 잠시 대기 후 재시도하세요.