본문으로 건너뛰기

결제 카탈로그 조회

GET 
/catalog

활성 지원 국가와 각 국가에서 결제 가능한 재화(통화/자산), 그리고 각 재화의 표시 소수점 자릿수를 담은 카탈로그를 반환한다. 카탈로그는 호출한 merchant 로 스코프된다: merchant 에게 프로비저닝된 결제수단을 통해 결제 가능한 재화만 나열하며, merchant 가 결제할 수 없는 국가는 생략된다.

  • decimals 는 재화의 결제/표시 정밀도다 (fiat 은 ISO 4217 — 예: JPY 0, USD 2; crypto 심볼은 프로젝트 컨벤션 4). 체인마다 다른 온체인 토큰 decimals 가 아니다 (예: USDT: Ethereum 6, BSC 18) — 최소 단위 변환 시에는 chain/token 메타데이터에서 조회한다.
  • 활성 CRYPTO 제한이 걸린 국가에서는 crypto 재화가 제외되어 (최근 변경사항 참고), 해당 지역의 hosted checkout 이 실제 제공하는 것과 카탈로그가 일치한다.
  • 응답은 캐시 기반이며 updated_at 에서 파생된 ETag 와 Cache-Control: private, max-age=300 을 싣는다. If-None-Match 로 재검증하면 재다운로드 대신 저렴한 304 를 받는다.

Request​

Responses​

카탈로그 조회 성공

Response Headers
    ETag

    updated_at 에서 파생된 신선도 태그; 기반 국가/재화 데이터가 바뀔 때만 변한다.

    Cache-Control

    private, max-age=300 — merchant 키로 게이트되므로 공유 캐시에 저장하면 안 된다.