Openclaw용 API 가맹점 수수료 조회

포괄적인 가맹점 수수료 구조 및 단말기 정보를 조회하기 위한 전문적인 API 통합입니다.

sgfa005

v1.0.0

Apr 16, 2026

설치

정보

Skill.md

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.


                  npx clawhub@latest install api-merchant-fee

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌

~/.openclaw/skills/

워크스페이스

<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.


                  Clawhub를 사용해서 api-merchant-fee 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

API 가맹점 수수료 조회란 무엇인가요?

API Merchant Fee 스킬은 특정 가맹점에 대한 상세 수수료 정보를 검색하기 위해 대리점용으로 설계된 강력한 도구입니다. 이 스킬은 자동화된 인터페이스를 통해 신용카드 기본 요율, 체크카드 한도, 클라우드 플래시 페이(UnionPay) 요율 및 특수 스캔 수수료(WeChat/Alipay)에 직접 액세스할 수 있는 구조화된 방법을 제공합니다. 이 스킬은 Openclaw Skills 생태계의 일부로, 결제 서비스 제공업체의 재무 데이터 검색을 간소화하는 데 중점을 둡니다.

이 스킬을 통합함으로써 사용자는 복잡한 가맹점 관계를 보다 효과적으로 관리할 수 있습니다. 인증 상태 관리를 자동으로 처리하여 민감한 자격 증명을 다시 입력하지 않고도 반복적인 쿼리를 수행할 수 있으므로 가맹점 관리 작업의 운영 효율성이 향상됩니다.

API 가맹점 수수료 조회 활용 사례

결제 대리점의 가맹점 수수료 구조에 대한 대량 쿼리.
특정 가맹점 계정에 대한 체크카드 수수료 한도 및 관리비 검증.
문제 해결을 위한 단말기 SN 연동 및 클라우드 플래시 페이 요율 확인.
대리점 이전 또는 팀 재구성 중 가맹점 요율의 신속한 감사.

API 가맹점 수수료 조회 작동 원리

사용자는 가맹점 식별자(userId 및 tusn)를 제공하며, 처음 사용하는 경우 대리점 자격 증명(agentNo 및 apikey)을 제공합니다.
스킬은 입력을 구문 분석하여 숨겨진 auth 파일에 로컬 인증 데이터가 존재하는지 확인합니다.
자격 증명이 누락된 경우 사용자에게 메시지를 표시하고, 그렇지 않으면 Python 기반 API 요청을 백엔드 서비스로 트리거합니다.
시스템은 AES 암호화된 API 응답을 처리하고 수수료 세부 정보, 단말기 SN 및 대리점 메타데이터를 추출합니다.
명확한 백분율 기반 요율과 금액별 수수료 한도가 표시된 서식 있는 보고서가 생성됩니다.

API 가맹점 수수료 조회 설정 가이드

환경 내에서 API Merchant Fee 스킬을 초기화하려면 필요한 스크립트와 로컬 저장소 권한이 있는지 확인하세요.

# Python 환경이 준비되었는지 확인
# 이 스킬은 지속적인 세션을 위해 로컬 auth 파일을 사용합니다
touch scripts/.auth.json

# 자격 증명을 저장하기 위한 첫 번째 쿼리
# 제공: agentNo, apikey, userId, 및 tusn

API 가맹점 수수료 조회 데이터 스키마 및 분류 체계

이 스킬은 로컬 구성 파일과 구조화된 API 매개변수를 통해 작동합니다:

데이터 구성 요소	형식	설명
agentNo	32자 문자열	대리점 고유 식별자
apikey	Base64 문자열	API 인증을 위한 AES 암호화 키
.auth.json	JSON 파일	agentNo 및 apikey 저장을 위한 로컬 캐시
Fee Metadata	백분율/통화	0.55% 또는 CNY (元) 단위 형식
SN Records	목록	쉼표로 구분된 단말기 일련번호