실시간으로 확인하는 매출
결제 서비스가 웹훅을 보내는 즉시 모든 매출, 결제 실패, 구독 해지 소식이 휴대폰으로 도착해요.
모든 결제 서비스와 호환
Stripe, PayPal, Paddle, LemonSqueezy의 엔드포인트에 웹훅 URL을 추가하면 바로 매출 알림을 받을 수 있어요.
금액과 고객 정보
금액, 고객 이메일, 이벤트 유형을 매핑해서 실제 매출 내역처럼 읽히는 푸시 알림을 받아 보세요.
원하는 이벤트만 선택
결제 성공, 결제 실패, 구독 해지처럼 필요한 이벤트만 구독하세요.
결제 실패와 구독 해지 감지
charge.failed와 customer.subscription.deleted용 웹훅을 따로 만들면 결제 재시도와 구독 해지를 각각 다른 채널로 받을 수 있어요.
실시간 매출 확인
결제가 완료되면 바로 알려 드려요. 대시보드를 새로고침하거나 일일 리포트를 기다릴 필요가 없어요.
직접 연결하고 안전하게
웹훅 URL마다 범위가 지정되고 HTTPS로 안전하게 보호되므로, Stripe에 바로 연결해도 안심할 수 있어요.
결제 알림 설정 3단계
웹훅 만들기
Stripe 페이로드를 매핑하는 GJSON 템플릿으로 Pocket Alert 웹훅을 만들고 수신 URL을 복사하세요.
Stripe 엔드포인트 추가
수신 URL을 Stripe 엔드포인트에 붙여 넣고 charge.succeeded, charge.failed 등 원하는 이벤트를 구독하세요.
매출 확인하기
테스트 결제를 해 보세요. 금액과 고객 이메일이 담긴 알림이 휴대폰에 도착해요.
Stripe 연결하기
1. Pocket Alert 웹훅 만들기
이름을 정하고, Stripe 페이로드 필드를 매핑하는 GJSON message 템플릿을 작성하세요. 완료되면 수신 URL이 발급돼요.
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"name":"Stripe Payments","application_id":"qm47b9pzxzxg","message":"Payment %data.object.amount% %data.object.currency% from %data.object.billing_details.email%"}'
응답에는 slug가 포함되어 있고, 수신 URL은 https://p4a.me/wh/1234abcd이 돼요. 웹훅 페이지에서도 만들 수 있어요.
2. Stripe에 수신 URL 등록하기
Stripe 대시보드에서 Workbench를 열고 Webhooks 탭으로 이동한 뒤 Create an event destination을 클릭하세요. 페이로드 스타일은 Snapshot을 선택하세요. thin 이벤트는 객체 ID만 담고 템플릿이 비어 있으므로 Snapshot이 필요해요. 그다음 charge.succeeded, charge.failed, customer.subscription.deleted 같은 이벤트를 선택하고, 엔드포인트 URL에 Pocket Alert 수신 URL을 붙여 넣으세요.
3. 필드 매핑하기
Stripe는 이벤트 JSON을 수신 URL로 POST 요청으로 보내요. 템플릿은 이 데이터를 기준으로 렌더링돼요. %data.object.amount%(최소 통화 단위, 예: 센트), %data.object.currency%, %data.object.billing_details.email%을 사용할 수 있어요. 이벤트 이름을 표시하려면 %type%을 사용하세요. GJSON 경로에 대한 자세한 내용은 문서에서 확인하세요.
궁금한 점을 답해드려요
Pocket Alert에서 메시지 템플릿을 설정한 웹훅을 만든 다음, 발급된 수신 URL을 Stripe에 엔드포인트로 등록하세요. Stripe 이벤트(charge.succeeded, charge.failed, customer.subscription.deleted)가 발생하면 템플릿에 따라 메시지가 만들어지고 푸시 알림으로 전달돼요.
네. GJSON 템플릿에서 Stripe 페이로드의 필드를 바로 가져올 수 있어요. %data.object.amount%와 %data.object.billing_details.email%을 사용하면 "New payment 4900 · [email protected]"처럼 알림에 표시됩니다. Stripe 금액은 최소 통화 단위(센트)로 전달돼요.
Stripe 엔드포인트에서 charge.succeeded, charge.failed, customer.subscription.deleted처럼 원하는 이벤트만 구독하세요. 구독한 이벤트만 수신 URL로 전송되고 휴대폰에 도착해요.
Stripe, PayPal, Paddle, LemonSqueezy, Chargebee 등 웹훅을 보내는 결제 서비스라면 모두 사용할 수 있어요. 해당 서비스의 엔드포인트를 Pocket Alert 수신 URL로 지정하고, 템플릿에서 페이로드 필드를 매핑하면 됩니다.
네. 이벤트 유형별로 Pocket Alert 웹훅을 하나씩 만드세요. 예를 들어 charge.failed용과 customer.subscription.deleted용을 따로 만들고, 각각 다른 애플리케이션에 연결하면 결제 재시도와 구독 해지 알림을 쉽게 구분할 수 있어요.
웹훅마다 기본 중요도를 설정할 수 있어요. 일반 매출은 기본으로 두고, charge.failed 웹훅은 높음으로 설정하면 iPhone의 집중 모드에서도 알림이 울려요. 구독 해지 이벤트는 기록용이라면 무음으로 보내세요. 중요도를 '긴급'으로 설정하면 Android에서도 방해 금지 모드를 뚫고 알림이 와요. 결제 실패로 운영 계정 서비스가 중단된 경우에 특히 유용해요.