빠른 시작

이 가이드는 Hosted Checkout 으로 첫 암호자산 결제를 받는 과정을 — API 키 발급부터 컨펌된 테스트 결제까지 — 약 5분 안에 안내합니다.

1. 테스트 API 키 발급

   ParaSta Dashboard → Developers → API Keys 에서 Secret test key (sk_test_ 로 시작) 를 복사합니다.

   주의

   시크릿 키는 비밀번호처럼 다루세요. 절대 커밋하지 말고, 클라이언트 코드에 노출하지 말고, 유출되면 Dashboard 에서 즉시 회전(rotate)하세요.

2. Checkout Session 생성

   amount 는 통화의 최소 단위 정수입니다 — USDT 는 소수점 6자리이므로 10000000 은 10 USDT 를 의미합니다.

   cURL

   curl https://api.parasta.io/v1/checkout/sessions \
     -H "Authorization: Bearer sk_test_..." \
     -H "Content-Type: application/json" \
     -d '{
       "line_items": [{ "name": "T-shirt", "amount": 10000000, "currency": "USDT" }],
       "success_url": "https://your-site.com/success",
       "cancel_url": "https://your-site.com/cancel"
     }'

   Node.js

   const session = await parasta.checkout.sessions.create({
     line_items: [{ name: 'T-shirt', amount: 10_000_000, currency: 'USDT' }],
     success_url: 'https://your-site.com/success',
     cancel_url: 'https://your-site.com/cancel',
   });

   Python

   session = parasta.checkout.Session.create(
     line_items=[{'name': 'T-shirt', 'amount': 10_000_000, 'currency': 'USDT'}],
     success_url='https://your-site.com/success',
     cancel_url='https://your-site.com/cancel',
   )

   응답에 url 이 포함됩니다. 결제자를 이 URL 로 리다이렉트하면 결제가 진행됩니다.

3. 웹훅 수신

   온체인에서 결제가 컨펌되면 ParaSta 가 checkout.session.completed 웹훅을 서버로 발송합니다. 주문 처리(fulfillment)의 신뢰 가능한 시그널은 웹훅입니다 — 리다이렉트만 신뢰하지 마세요.

   설정은 웹훅 → 개요를 참조하세요.

코드 없이 시도해 보기

Dashboard 의 API Playground 에서 브라우저를 떠나지 않고 샌드박스 계정으로 테스트 요청을 보내볼 수 있습니다.

다음 단계

가이드Hosted Checkout

통합 전체: 라이프사이클, URL 플레이스홀더, 선택 파라미터.

가이드QR 결제

매장·POS·키오스크용 — 결제자가 본인 지갑으로 QR 을 스캔합니다.

가이드정산 옵션

코인 그대로 받거나, 법정화폐(USD, KRW, IDR) 자동 환전, 또는 수신처 분할.