AI 에이전트 결제 연동 API: 코딩 에이전트가 암호화폐 결제를 추가하게 하기
AI 코딩 에이전트는 이제 몇 분 안에 동작하는 제품을 만들 수 있습니다. 화면을 만들고, 서버 라우트를 작성하고, 데이터베이스를 추가하고, 연동을 연결할 수 있습니다. 결제는 여전히 다릅니다. 대부분의 결제 제공사는 아직도 사람이 관리 화면을 열고, 계정을 만들고, 제품을 설정하고, Webhook을 구성한 뒤 그 정보를 다시 앱에 가져온다고 가정합니다.
이 수동 과정은 에이전트의 작업 흐름을 끊습니다. 사용자가 “결제를 추가해 줘”라고 말했을 때 에이전트가 사용자를 설정 단계로 보내서는 안 됩니다. 에이전트에게는 Yolfi를 발견하고, 결제 링크를 준비하고, 결제 페이지를 추가하고, Webhook을 설정하고, 결과를 검증할 공식 경로가 있어야 합니다.
Yolfi Agent Kit은 이 과정을 위해 설계되었습니다.
문제
에이전트는 앱을 만들 수 있지만, 결제 설정은 여전히 관리 화면에서 수동 작업을 요구하는 경우가 많습니다.
- 계정 만들기;
- 올바른 개발자 문서 찾기;
- 결제 링크나 제품 만들기;
- Webhook URL 설정하기;
- 서명 검증하기;
- 결제 상태를 앱의 접근 권한 로직에 연결하기.
사람 개발자에게는 번거로운 작업입니다. AI 코딩 에이전트에게는 제공사가 기계가 읽을 수 있고 안전 경계가 분명한 경로를 제공하지 않으면 완전히 막히는 지점입니다.
Yolfi의 접근 방식
Yolfi Agent Kit은 개발자가 오늘 사용하는 동일한 제품 기능을 코딩 에이전트가 찾고 따를 수 있는 형태로 제공합니다.
- 에이전트용 가이드는 안전한 연동 경로를 설명합니다.
- npm 패키지는 구조화된 명령을 제공합니다.
- MCP 서버는 에이전트 환경에 Yolfi 작업을 노출합니다.
- 기존 Yolfi API는 결제 링크, 조직 설정, 결제 상태의 기준으로 남습니다.
중요한 패턴은 간단합니다. 사용자는 비즈니스 결정을 승인하고, 에이전트는 제품 코드베이스 안에서 연동 작업을 처리합니다.
에이전트 과정
코딩 에이전트는 다음을 할 수 있습니다.
- 대상 앱을 살펴봅니다.
- Yolfi가 이미 설정되어 있는지 확인합니다.
- 필요하면 Yolfi 작업 공간을 준비합니다.
- 사용자에게 지갑 주소, 제품, 가격, 통화, 결제 유형을 묻습니다.
- 정산 지갑과 Webhook URL을 설정합니다.
- 결제 링크를 만들거나 기존 링크를 다시 사용합니다.
- 결제 링크 ID를 환경 변수나 앱 설정에 저장합니다.
- 결제 페이지나 서버 라우트를 추가합니다.
- Webhook 서명 검증을 추가합니다.
- Yolfi를 통해 결제 상태를 확인합니다.
설치
npx -y @yolfi/agent help
MCP를 지원하는 환경에서는 다음을 실행할 수 있습니다.
npx -y @yolfi/agent mcp
안전 규칙
결제 자동화가 무조건적인 금융 자동화를 뜻해서는 안 됩니다.
에이전트는 다음을 선택하기 전에 사용자에게 물어야 합니다.
- 정산 지갑 주소;
- 제품 이름;
- 가격;
- 통화;
- 반복 결제 주기;
- 결제 링크 비활성화 같은 파괴적 작업;
- 비밀 정보를 저장할 위치.
에이전트는 브라우저 리디렉션을 결제 확인으로 간주해서는 안 됩니다. 결제 상태나 Webhook 이벤트를 검증해야 합니다.
Webhook 이벤트
Yolfi는 Webhook 이벤트에 서명하므로, 수신 앱은 이벤트가 실제로 Yolfi에서 온 것인지 확인할 수 있습니다.
에이전트는 크레딧을 지급하거나, 기능을 열거나, 주문을 결제 완료로 표시하기 전에 서명 검증을 추가해야 합니다. 구현 세부 사항은 대상 앱 안의 임시 지시가 아니라 공식 문서와 패키지 예시에 있어야 합니다.
링크
- Yolfi Agent Kit
- Yolfi 문서
- GitHub
- npm
- MCP 디렉터리: 각 디렉터리 요구 사항 검토 후 제공 예정
