QR 결제

QR Session 은 대면 결제(POS 단말, 키오스크, 매대)를 위해 설계되었습니다. 가맹점이 QR 을 생성하면, 결제자가 본인 지갑으로 스캔합니다.

흐름

1. 가맹점 POS 가 amount, currency, network 와 함께 POST /v1/qr/sessions 를 호출합니다.
2. 응답에 image_url (PNG) 과 deeplink (ethereum:, solana: URI) 가 포함됩니다.
3. 가맹점이 QR 을 표시하고, 결제자가 본인 암호자산 지갑으로 스캔합니다.
4. 결제자 지갑에 수신 주소와 금액이 사전 채움됩니다.
5. 컨펌 후 ParaSta 가 qr.session.completed 와 payment.succeeded 웹훅을 발송합니다.

세션 생성 시 네트워크 선택

QR 세션은 하나의 네트워크/토큰에 바인딩됩니다. 여러 네트워크를 받으려면 네트워크별로 여러 QR 을 렌더링하세요 — 대부분의 지갑 앱은 한 가지 URI 스킴만 인식합니다.

만료

expires_in (기본 600초) 가 QR 유효 시간을 결정합니다. 만료 후 스캔하면 지갑 앱에서 “session expired” 안내가 표시됩니다.

API 레퍼런스

POST /v1/qr/sessions · GET /v1/qr/sessions/{id}