웹훅으로 Zapier, Make 등의 앱에 주문 보내기

웹훅을 추가하면 Payly가 새 주문, 발송, 환불, 구독을 Zapier, Make 또는 웹훅을 받는 모든 앱으로 보냅니다.

웹훅은 스토어에서 일어나는 이벤트를 발생하는 즉시 다른 앱으로 보내 줍니다. 웹훅을 추가하면 결제된 모든 주문이 Zapier나 Make로 전달되고, 거기서 Google Sheets, Slack, 이메일 목록, 회계 앱 등 수천 개의 앱으로 이어집니다. 코드는 필요 없습니다.

웹훅 추가하기

사이트 대시보드에서 연동을 클릭합니다.
자동화 아래에서 웹훅을 켭니다. 팝업이 열립니다.
이벤트를 선택하고, 앱에서 받은 웹훅 주소를 붙여 넣은 다음 웹훅 추가를 클릭합니다.
테스트 보내기를 클릭해 샘플 주문을 보낸 다음 완료를 클릭합니다.

웹훅은 추가하는 즉시 작동합니다. 게시하지 않아도 됩니다.

Zapier에 연결하기

Zapier에서 Zap을 만듭니다. 트리거로 Webhooks by Zapier를 선택한 다음 Catch Hook을 선택합니다.
Zapier가 보여 주는 웹훅 URL을 복사합니다.
Payly에서 주문 결제 완료 웹훅을 추가하고 그 URL을 붙여 넣습니다.
테스트 보내기를 클릭합니다. Zapier로 돌아가 Test trigger를 클릭합니다. John Smith의 샘플 주문 #9999가 표시됩니다.
Google Sheets에 새 행을 추가하는 것처럼 원하는 액션을 추가하고, Order Number, Order Total, Order Customer Email 등의 필드를 매핑합니다.
Zap을 게시합니다. 이제 결제된 주문마다 이 Zap이 실행됩니다.

Webhooks by Zapier는 Zapier의 프리미엄 앱 중 하나이므로 유료 Zapier 요금제가 필요합니다.

Make에 연결하기

Make에서 시나리오를 만듭니다. Webhooks, Custom webhook을 차례로 추가하고 Add를 클릭해 새 웹훅을 만듭니다.
Make가 보여 주는 주소를 복사합니다.
Payly에서 그 주소로 웹훅을 추가하고 테스트 보내기를 클릭합니다. Make가 샘플을 읽고 필드를 파악합니다.
원하는 모듈을 추가하고 필드를 매핑한 다음 시나리오를 켭니다.

이벤트

주문 결제 완료: 주문이 결제되었을 때. 구독의 첫 결제, 매 갱신, 직접 결제 완료로 추가한 주문도 포함됩니다.
주문 발송: 주문을 발송 처리했을 때. 주문을 나누어 발송하면 발송할 때마다 전송됩니다.
주문 환불: 돈이 환불되었을 때. Payly에서 환불하든 Stripe나 PayPal에서 환불하든 마찬가지이며, 부분 환불도 각각 전송됩니다.
구독 시작: 구독의 첫 주문.
구독 갱신: 첫 결제 이후의 매 결제.
구독 종료: 구독이 취소되거나 기간이 끝났을 때. 종료되는 날에 전송됩니다.

Payly가 보내는 내용

각 이벤트는 JSON으로 전송됩니다. 모든 주문 이벤트에는 다음이 포함됩니다:

#1000과 같은 주문 번호, 상태, 결제된 시각
소계, 할인과 할인 코드, 배송비, 세금, 합계, 환불된 금액 및 통화
각 상품의 이름, SKU, 수량, 가격, 항목별 합계
고객의 이름, 이메일, 전화번호와 배송지 주소
Stripe나 PayPal 같은 결제 방법
test_mode: 테스트 모드에서 접수된 주문이면 true입니다

발송 이벤트에는 배송사와 운송장 번호가 추가됩니다. 환불 이벤트에는 지금까지 환불된 총액이 추가됩니다. 구독 이벤트에는 플랜, 가격, 청구 주기, 다음 갱신일이 추가됩니다. 테스트 보내기로 보낸 샘플에는 "test": true가 들어 있습니다. 카드 번호는 Stripe와 PayPal에만 보관되므로 웹훅에는 절대 포함되지 않습니다.

웹훅이 실패하는 경우

앱은 5초 안에 응답해야 합니다. 응답이 없거나 오류로 응답하면 Payly는 약 4시간 반 동안 최대 7번 더 다시 시도합니다. 팝업에는 각 웹훅의 최근 전송 내역이 표시되므로 어떤 일이 있었는지 확인할 수 있습니다.

이벤트 3건이 연속해서 모든 시도에 실패하면 웹훅이 일시 중지되고, 연동 화면에 그 사실이 표시됩니다. 주소를 확인한 다음 다시 켜기를 클릭하세요.

웹훅이 내 스토어에서 보낸 것인지 확인하기

Zapier와 Make에서는 필요하지 않습니다. 직접 앱을 만든다면 모든 요청에 X-Payly-Hmac-Sha256 헤더가 포함됩니다. 이 값은 요청 본문을 스토어의 서명 시크릿으로 HMAC-SHA256 서명한 뒤 base64로 나타낸 것입니다. 시크릿은 웹훅 팝업에 있습니다. 원본 본문으로 같은 서명을 계산해 두 값을 비교하세요.

X-Payly-Webhook-Id 헤더는 전송을 다시 시도해도 같은 값으로 유지되므로, 앱은 이미 처리한 전송을 건너뛸 수 있습니다.