Braintree 자동화
고객, 구독, 결제 수단, 잔액 거래 내역 및 고객 검색을 포함한 Stripe 호환 도구를 통해 결제 처리 작업을 자동화합니다. Composio 플랫폼은 통합 결제 관리를 위해 Braintree 결제 워크플로우를 Stripe 도구 키트를 통해 라우팅합니다.
도구 키트 문서: composio.dev/toolkits/braintree
설정
이 스킬은 https://rube.app/mcp에 연결된 Rube MCP 서버가 필요합니다.
도구를 실행하기 전에 stripe 도구 키트에 활성 연결이 있는지 확인하세요. 활성 연결이 없으면 RUBE_MANAGE_CONNECTIONS를 통해 연결을 시작하세요.
핵심 워크플로우
1. 고객 생성 및 관리
새 고객을 생성하고 기존 고객의 세부 정보를 검색합니다.
도구:
STRIPE_CREATE_CUSTOMER-- 새 고객 생성STRIPE_GET_CUSTOMERS_CUSTOMER-- ID로 고객 검색STRIPE_POST_CUSTOMERS_CUSTOMER-- 기존 고객 업데이트STRIPE_LIST_CUSTOMERS-- 페이지네이션으로 고객 목록 조회STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS-- 이메일, 이름, 메타데이터로 고객 검색
STRIPE_CREATE_CUSTOMER의 주요 매개변수:
email-- 고객의 기본 이메일 주소name-- 전체 이름 또는 비즈니스 이름phone-- 국가 코드를 포함한 전화번호description-- 내부 참고 사항address--line1,city,state,postal_code,country를 포함한 청구지 주소 객체
STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS의 주요 매개변수:
query(필수) -- Stripe 검색 쿼리 언어.field:value구문을 사용해야 합니다:email:'[email protected]'-- 정확히 일치 (대소문자 구분 안 함)name~'John'-- 부분 문자열 일치 (최소 3자)metadata['key']:'value'-- 메타데이터 검색created>1609459200-- 타임스탬프 비교AND또는OR로 결합 (최대 10개 절, 혼합 불가)
limit-- 페이지당 결과 수 (1~100, 기본값 10)
예시:
도구: STRIPE_CREATE_CUSTOMER
인수:
email: "[email protected]"
name: "Jane Doe"
description: "엔터프라이즈 요금제 고객"
address: {
"line1": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postal_code": "94105",
"country": "US"
}
2. 구독 관리
구독을 생성하고 고객의 구독 세부 정보를 조회합니다.
도구:
STRIPE_CREATE_SUBSCRIPTION-- 기존 고객을 위한 새 구독 생성STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS-- 고객의 모든 구독 목록 조회STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID-- 특정 구독 조회
STRIPE_CREATE_SUBSCRIPTION의 주요 매개변수:
customer(필수) -- 고객 ID (예:"cus_xxxxxxxxxxxxxx")items(필수) -- 각 항목이 포함된 구독 항목 배열:price-- 가격 ID (예:"price_xxxxxxxxxxxxxx") (이것 또는price_data사용)price_data--currency,product,unit_amount,recurring을 포함한 인라인 가격 정의quantity-- 항목 수량
default_payment_method-- 결제 수단 ID (평가판 또는 청구서 결제의 경우 필요하지 않음)trial_period_days-- 평가판 기간(일) (평가판 중에는 결제 불필요)collection_method--"charge_automatically"(기본값) 또는"send_invoice"cancel_at_period_end-- 청구 기간 종료 시 취소 (부울)
STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS의 주요 매개변수:
customer(필수) -- 고객 IDstatus-- 필터:"active","all","canceled","trialing","past_due"등limit-- 페이지당 결과 수 (1~100, 기본값 10)
예시:
도구: STRIPE_CREATE_SUBSCRIPTION
인수:
customer: "cus_abc123"
items: [{"price": "price_xyz789", "quantity": 1}]
trial_period_days: 14
3. 결제 수단 관리
고객의 결제 수단을 목록으로 조회하고 연결합니다.
도구:
STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS-- 고객의 결제 수단 목록 조회STRIPE_ATTACH_PAYMENT_METHOD-- 결제 수단을 고객에게 연결
STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS의 주요 매개변수:
customer(필수) -- 고객 IDtype-- 유형별 필터:"card","sepa_debit","us_bank_account"등limit-- 페이지당 결과 수 (1~100, 기본값 10)
예시:
도구: STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS
인수:
customer: "cus_abc123"
type: "card"
limit: 10
4. 잔액 거래 내역 조회
고객의 잔액 변동 내역을 검색합니다.
도구: STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS
주요 매개변수:
customer(필수) -- 고객 IDcreated-- 비교 연산자를 사용한 생성 날짜 필터:{"gte": 1609459200}또는{"gt": 1609459200, "lt": 1640995200}invoice-- 관련 청구서 ID로 필터limit-- 페이지당 결과 수 (1~100)starting_after/ending_before-- 페이지네이션 커서
예시:
도구: STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS
인수:
customer: "cus_abc123"
limit: 25
created: {"gte": 1704067200}
알려진 함정
| 함정 | 세부 사항 |
|---|---|
| 검색 쿼리 구문 | STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS는 필드 접두사가 있는 쿼리(예: email:'x')가 필요합니다. 필드 접두사가 없는 문자열은 유효하지 않으며 오류가 발생합니다. |
| 구독 결제 수단 | trial_period_days 또는 collection_method='send_invoice'를 사용하는 경우 default_payment_method가 필요하지 않습니다. 그렇지 않으면 구독이 활성화되지 않을 수 있습니다. |
| 결제 수단 연결 | PaymentMethod는 고객에게 연결되기 전에 분리된 상태여야 합니다. 이미 연결된 메서드는 오류를 발생시킵니다. |
| 페이지네이션 커서 | 페이지 번호가 아닌 객체 ID와 함께 starting_after/ending_before를 사용하세요. 각 응답에서 마지막/첫 번째 객체 ID를 추출합니다. |
| 잔액 금액(센트 단위) | 모든 금액은 최소 통화 단위(예: USD의 경우 센트)로 표시됩니다. 1000 = $10.00입니다. |
| 구독 상태 기본값 | GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS는 기본적으로 취소된 구독을 제외합니다. 포함하려면 status: "all"을 전달하세요. |
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
STRIPE_CREATE_CUSTOMER | 새 고객 생성 |
STRIPE_GET_CUSTOMERS_CUSTOMER | ID로 고객 검색 |
STRIPE_POST_CUSTOMERS_CUSTOMER | 기존 고객 업데이트 |
STRIPE_LIST_CUSTOMERS | 페이지네이션으로 고객 목록 조회 |
STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS | 속성별 고객 검색 |
STRIPE_CREATE_SUBSCRIPTION | 고객을 위한 구독 생성 |
STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS | 고객 구독 목록 조회 |
STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID | 특정 구독 조회 |
STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS | 고객 결제 수단 목록 조회 |
STRIPE_ATTACH_PAYMENT_METHOD | 결제 수단을 고객에게 연결 |
STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS | 고객 잔액 거래 내역 목록 조회 |
Composio 제공