결제 링크 — 개요

결제 링크는 이미 구성한 호스팅 결제 페이지로 구매자를 안내하는 공유 가능한 URL입니다. SDK도, 서버 연동도 필요 없습니다 — 대시보드에서 발급하고 공유하면, 온체인에서 자금이 확인될 때 동일한 payment.settled 웹훅이 발생합니다.

내부적으로 결제 링크는 CheckoutSession입니다 — “결제 링크”는 구매자 주도 SDK 흐름으로 생성되지 않은 세션의 대시보드 측 이름일 뿐입니다. 동일한 웹훅 계약, 동일한 온체인 정산, 동일한 수수료가 적용됩니다.

일반적인 사용 사례:

• 코드를 작성하지 않고 일회성 고객에게 인보이스 발행
• 커스텀 카트가 없는 판매 페이지
• B2B 후속 — 이메일에 링크를 붙여넣기
• “커피 한 잔 사주세요” 스타일의 고정 금액 팁 페이지

생성하기

대시보드에서 결제 링크를 생성합니다.

1. 가맹점 대시보드 에 로그인
2. Payments → Payment Links → + New link
3. 두 가지 경로 중 하나를 선택:
   • 새 주문 — 라인 아이템, 통화, 고객 정보, 선택적 메타데이터를 입력합니다. 대시보드가 한 번의 호출로 Order와 결제 링크를 생성합니다.
   • 기존 주문 — PENDING 주문(예: 구매자가 이전 링크를 포기한 경우)을 선택합니다. 동일한 주문을 기반으로 새 링크를 재발급하여 주문 이력을 유지합니다.
   • New order에서 금액만으로 바꾸면 상품 목록 없이 정해진 금액을 청구할 수 있습니다.
4. 저장 → 대시보드가 복사 버튼과 QR 코드 다운로드와 함께 https://checkout.infraio.xyz/cst_… URL을 표시합니다. 테스트 모드 링크는 checkout-dev.infraio.xyz를 사용하므로 환경이 호스트명에 인코딩됩니다.

구매자가 보는 것

1. 구매자는 checkout.infraio.xyz/<session_key>에 도착합니다 — SDK가 발급한 세션에서 얻는 것과 동일한 호스팅 결제 페이지 UI입니다.
2. 체크아웃 — 개요에서 설명한 표준 자산 선택 → 자금 전송 → 확인 대기 흐름을 진행합니다.
3. payment.settled가 주문, 인텐트, 영수증, 온체인 tx 해시, 확인 수와 함께 웹훅으로 발생합니다 — 다른 정산된 결제와 동일한 페이로드입니다. 스키마는 웹훅을 참조하세요.

대시보드에서 제공되는 기능

결제 링크 표면은 현재 다음을 제공합니다.

• 목록 뷰 — 발급한 모든 링크. 커서 페이지네이션, 상태, 금액, 부모 주문 번호, 고객, 만료일, 구매자 URL로 원클릭 이동.
• 필터 — 상태(ACTIVE / COMPLETED / EXPIRED / CANCELED), 날짜 범위, 주문 번호, 고객명, 이메일, 외부 참조에 대한 전문 검색.
• CSV 내보내기 — 원클릭. 현재 필터를 따릅니다.
• KPI 스트립 — 현재 환경(live 또는 test)의 상태별 카운트이며, 테이블에 표시되는 내용과 일치합니다.
• 상세 페이지 — 주문 요약, 세션 이력(이 주문에 대한 모든 시도), 블록 익스플로러 링크가 포함된 온체인 이력, 결제 전에 만료된 세션에 대한 Re-create link 액션.

현재 제한 사항

• 프로그래밍 API 없음 — 링크는 대시보드에서만 생성할 수 있습니다. POST /b2b/v1/checkout-sessions/quick을 통해 동등한 일회용 세션을 생성할 수 있지만(API 레퍼런스 참조), 공유 가능한 링크는 대시보드에서만 생성됩니다.
• 구매자별 인증 없음 — URL을 가진 모든 사용자가 결제할 수 있습니다. 각 링크는 일회용이므로 이를 어느 정도 제한합니다.
• 브랜딩은 전역적임 — 링크는 Settings → Branding의 가맹점 전체 로고, 브랜드 컬러, 보더 라디우스를 사용합니다. 링크별 브랜딩 오버라이드는 사용할 수 없습니다.

참고

• 개념 → 세션 — 구매자가 결제하는 동안 세션 및 인텐트 레이어에서 일어나는 일.
• 체크아웃 → 개요 — 구매자가 실제로 보는 것.
• 웹훅 → 개요 — 가맹점 서버가 반응하는 payment.settled 이벤트.