Stripe

• AI 에이전트가 Stripe 시크릿 키를 환경에 직접 삽입하지 않고 Stripe 고객, 상품 및 가격을 생성하거나 관리하도록 하고 싶을 때.
• 에이전트 워크플로우 내에서 구독 생성, 플랜 업데이트, 취소 등 구독 라이프사이클 작업을 자동화해야 할 때.
• Python 또는 JavaScript를 사용하여 프로그래밍 방식으로 결제 내역을 조회하거나, 인보이스 PDF를 가져오거나, 환불을 발행하고 싶을 때.
• 여러 Stripe 계정을 관리하며 Maton-Connection 헤더를 사용하여 특정 연결로 요청을 라우팅해야 할 때.

• Stripe 이외의 서드파티 서비스와 통합해야 하는 경우 — 대신 api-gateway skill을 사용하세요.
• 이 REST 프록시가 제공하지 않는 직접적인 Stripe 웹훅 처리 또는 실시간 이벤트 스트리밍이 필요한 경우.
• 유효한 Maton API 키가 없거나 네트워크에서 gateway.maton.ai에 접근할 수 없는 경우.

인증은 MATON_API_KEY를 통해 완전히 처리됩니다. Maton 게이트웨이가 api.stripe.com으로의 요청을 프록시하여 올바른 Stripe OAuth 토큰을 자동으로 주입하므로, Stripe 자격 증명을 직접 저장하거나 교체할 필요가 없습니다.

고객, 상품, 가격, 구독, 인보이스, 청구, 결제 인텐트, 결제 수단, 쿠폰, 환불에 걸쳐 CRUD 작업을 지원하며 — Stripe의 핵심 결제 및 청구 기능 전반을 포괄합니다.

ctrl.maton.ai의 Maton 제어판에서 여러 Stripe OAuth 연결을 관리하세요. API 호출 시 Maton-Connection 헤더를 사용하여 특정 Stripe 계정을 지정하거나, 게이트웨이가 가장 오래된 활성 연결을 기본값으로 사용하도록 설정할 수 있습니다.

모든 목록 엔드포인트는 starting_after 및 ending_before 쿼리 파라미터를 통해 Stripe의 네이티브 커서 기반 페이지네이션을 지원하며, 대용량 데이터셋 반복 처리를 간소화하기 위해 응답에 has_more가 포함됩니다.

기본적인 CRUD를 넘어서 — 전용 액션 엔드포인트(/finalize, /pay, /void)를 사용하여 초안 인보이스를 확정하거나, 결제 수집을 트리거하거나, 인보이스를 무효화할 수 있습니다. 호스팅된 인보이스 URL과 PDF 링크는 응답에 반환됩니다.

고객을 생성하고, 결제 수단을 연결하고, 반복 요금제에 대한 구독을 시작하세요 — 모두 에이전트 워크플로에서 처리할 수 있습니다. 구독 API를 사용하여 플랜을 업그레이드하거나 다운그레이드하고, 필요할 때 취소하세요.

잔액 거래를 조회하고, 고객 또는 날짜별로 필터링된 청구 목록을 확인하며, 결제 인텐트 상태를 검색하여 재무 요약을 생성하거나 결제 기록을 프로그래밍 방식으로 조정합니다.

사용자가 가입할 때 자동으로 Stripe 고객 레코드를 생성하고, 내부 사용자 ID와 같은 메타데이터를 첨부하며, 더 넓은 온보딩 자동화의 일환으로 고객 세부 정보를 조회하거나 업데이트합니다.

프로모션 캠페인을 위한 퍼센트 할인 또는 금액 할인 쿠폰을 생성하고, 기존 쿠폰을 조회하며, 만료된 쿠폰을 삭제할 수 있습니다 — Stripe 대시보드에 접속하지 않고 모두 API를 통해 처리할 수 있습니다.