Stripe

읽기 전용 제한 키로 Stripe를 연결한 다음, Webhook을 추가해 새 결제가 바로 표시되게 합니다.

RevGlance는 직접 만든 키로 Stripe API를 통해 Stripe 계정을 읽습니다. 결제, 환불, 수수료, 분쟁, 구독을 읽으며, 결제나 환불을 하거나 어떤 것도 변경하지 않습니다.

시작하기 전에

RevGlance에서 해당 비즈니스의 소유자 또는 관리자여야 합니다. 뷰어는 소스를 추가할 수 없습니다.
비밀 키 대신 제한 키를 사용하세요. RevGlance는 둘 다(rk_… 또는 sk_…) 받지만, 제한 키는 허용한 것만 읽을 수 있습니다.
테스트 모드 키도 작동하므로 처음 살펴볼 때 편리합니다. 준비가 되면 라이브 키로 두 번째 소스를 연결하세요.

연결

Stripe Dashboard에서 Developers › API keys를 열고 Create restricted key를 선택합니다. 이름은 RevGlance로 지정합니다.
Balance, Charges, Customers, Disputes, Invoices, Checkout Sessions, Subscriptions, Coupons에 Read 권한을 줍니다. 나머지는 모두 None으로 둡니다.
키를 만들고 복사합니다. 키는 rk_live_로 시작합니다.
제한 키에 붙여넣고 Stripe 연결을 선택합니다. 첫 동기화는 전체 기록을 읽습니다.

양식에서 묻는 항목

필드	형식 예시
제한 키암호화하여 저장	`rk_live_…`

이름 필드는 선택 사항입니다. 한 비즈니스 안의 Stripe 계정 두 개를 구분할 때 사용합니다.

Webhook 추가하기

Webhook이 없으면 RevGlance는 Stripe를 매시간 동기화합니다. Webhook이 있으면 새 결제, 환불 또는 해지가 생길 때 몇 초 안에 동기화가 대기열에 들어갑니다.

RevGlance에서 설정 › 소스를 열고 Stripe 소스를 찾아 메뉴를 연 다음 Webhook을 선택합니다. URL을 복사합니다.
Stripe에서 Developers › Webhooks를 열고 그 URL로 엔드포인트를 추가합니다.
숫자를 바꾸는 이벤트를 선택합니다: charge.succeeded, charge.failed, charge.refunded, charge.dispute.closed, customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.paid. 어떤 이벤트든 작동합니다. 각 이벤트는 동기화를 시작할 뿐입니다.
엔드포인트의 signing secret(whsec_…)을 복사해 RevGlance의 서명 시크릿에 붙여넣고 저장합니다.

RevGlance가 동기화하는 항목

잔액 거래: 모든 결제, 환불, 분쟁, Stripe 수수료를 Stripe가 정산한 통화로 가져옵니다.
실패한 결제: 실패한 결제 지표와 회수에 사용됩니다.
모든 상태의 구독과 그 고객, 항목, 할인, 최신 인보이스: MRR, 플랜, 체험판, 해지에 사용됩니다. Stripe에 해지 이유와 고객의 코멘트가 있으면 함께 가져옵니다.

첫 동기화는 전체 기록을 읽습니다. 그 이후 각 동기화는 마지막 동기화보다 3일 전부터 읽어 늦게 반영된 변경을 잡아내며, 구독은 매번 전체를 읽습니다.

Stripe의 집계 방식

결제, 환불, Stripe 수수료는 잔액 거래 내역에서 가져오며, Stripe가 정산한 통화로 표시됩니다.
카드 환불은 Stripe가 기록한 날에 집계됩니다. 은행 결제(ACH, SEPA 및 기타 현지 결제 수단)도 집계되며, 은행이 반환한 환불은 환불 금액을 다시 줄입니다.
분쟁은 Stripe가 금액을 회수할 때 환불로 집계되며, 분쟁에서 이기면 환불이 취소됩니다. Stripe 분쟁 수수료는 수수료로 남습니다.
구독 및 개별 항목에 적용된 쿠폰은 MRR에서 차감됩니다. 정액 쿠폰은 해당 통화에서만 적용됩니다.
일시 중지 및 미결제 구독은 이탈로 집계되며, 연체된 구독은 Stripe가 카드 결제를 재시도하는 동안 계속 집계됩니다.
결제, 환불, 분쟁은 인보이스 또는 Checkout Session의 세금 비율에 따라 세전으로 집계됩니다. Checkout Sessions 읽기 권한이 없으면 인보이스 외 판매의 세금은 포함된 채로 남습니다.
세금 포함 가격은 최신 인보이스의 세금 비율에 따라 세전으로 MRR에 집계됩니다.
결제 수금 일시 중지는 Stripe가 날짜를 제공하지 않으므로 RevGlance가 처음 확인한 날부터 이탈로 집계됩니다.

모든 제공업체에 공통으로 적용되는 규칙은 집계 방식을 참고하세요.

회수 이메일

회수는 실패한 구독 결제를 Stripe의 미결제 인보이스 페이지로 연결하며, 고객은 그곳에서 새 카드로 결제할 수 있습니다. 미결제 인보이스가 없으면 대신 Stripe 고객 포털 세션을 엽니다. 이 대체 방법을 쓰려면 Stripe에서 포털을 켜고, 키에 Customer portal 세션 쓰기 권한이 있어야 합니다. 없으면 이메일은 자체 카드 업데이트 페이지로 연결됩니다.

문제 해결

"Stripe 비밀 키 또는 제한 키를 붙여넣으세요." 키는 rk_ 또는 sk_로 시작해야 합니다. 공개 가능 키(pk_)로는 아무것도 읽을 수 없습니다.
"Stripe refused that key." 키가 취소되었거나 Balance에 대한 읽기 권한이 없습니다.
"Stripe refused the failed-charge request" 또는 "the subscription request": 키가 Charges 또는 Subscriptions를 읽을 수 없습니다. 결제는 계속 동기화됩니다. 빠진 권한을 추가하고 다시 동기화하세요.