# 개요

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

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

## 시작하기

통합을 시작하려면:

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

## Base URL

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

```
https://api.2328.io/api
```

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

## 가능한 작업

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

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

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