알리페이 웹훅 으로 결제완료시 확인 요청 드립니다.
안녕하세요. 쓰리빌리언의 최지웅이라고 합니다.
다름이 아니라 저희가 이번에 알리페이를 추가 오픈하면서, 사용중에 있는데요. 일부 건에 대해서 pending URL 호출이 되지 않고, 바로 웹훅 호출로 이어지고 있어서 문의드립니다.
저희쪽에선 pending URL 이 호출되면 내부적으로 이건 alipay 로 인한 결제라는 태깅을 합니다. 그와 관련된 정보를 저장하고, 웹훅이 오면, 그 정보들을 확인하여 결제완료 처리를 하는데요.
이 과정에서 pending URL 이 호출되지 않은 상태로 웹훅만 호출되어서, 결제완료로 상태가 넘어가지 않은 상태가 발견되어서 확인 요청드립니다.
혹시 이같은 경우엔 어떻게 처리하는게 좋을까요?
저희가 사용하는 mid 는 3billip6qu 입니다.
잘된 케이스와 안된 케이스 공유드립니다.
pending URL 호출 없는 케이스
1. O-250610-US-A-706 GCash
1. 결제 일시 2025-06-11 21:41:26
2. 최초 웹훅 호출시기 : 2025-06-11T21:41:27.577
3. pending URL 호출 없음
2. O-250514-US-A-444 GCash
1. 결제 일시 : 2025-06-07 11:06:24
2. 최초 웹훅 호출 시기 : 2025-06-07T11:06:26.370
3. pending URL 호출 없음
3. O-250530-US-A-659 GCash 1. 결제 일시 : 2025-06-03 10:23:46 2. 최초 웹훅 호출 시기 : 2025-06-03T10:23:47.992 3. pending URL 호출 없음
호출 잘된 케이스 1. O-250613-US-A-139 GCash 1. 결제 일시 : 2025-06-16 17:51:00 2. 최초 웹훅 호출 : 2025-06-16T17:51:02.254, 추후 재시도 2025-06-16T17:52:18 후 결제 완료 3. pending URL 호출 : 2025-06-16T17:51:15 2. O-250609-US-A-872 터치앤고 1. 결제 일시 : 2025-06-09 18:17:18 2. 최초 웹훅 호출 : 2025-06-09T18:17:19, 추후 재시도 2025-06-09T18:18:23.184 후 결제 완료 3. pending URL 호출 : 2025-06-09T18:17:33.682
3. O-250530-US-A-659 GCash 1. 결제 일시 : 2025-06-03 10:23:46 2. 최초 웹훅 호출 시기 : 2025-06-03T10:23:47.992 3. pending URL 호출 없음
호출 잘된 케이스 1. O-250613-US-A-139 GCash 1. 결제 일시 : 2025-06-16 17:51:00 2. 최초 웹훅 호출 : 2025-06-16T17:51:02.254, 추후 재시도 2025-06-16T17:52:18 후 결제 완료 3. pending URL 호출 : 2025-06-16T17:51:15 2. O-250609-US-A-872 터치앤고 1. 결제 일시 : 2025-06-09 18:17:18 2. 최초 웹훅 호출 : 2025-06-09T18:17:19, 추후 재시도 2025-06-09T18:18:23.184 후 결제 완료 3. pending URL 호출 : 2025-06-09T18:17:33.682
16 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
고객이 결제만 하고 결제가 시작된 브라우저나 앱으로 되돌아 가지 않은경우에 pendingURL 은 호출이 되지 않고 결제 웹훅만 올수 있습니다.
그리고 실제 결제가 빠르게 완료된 경우 pending URL 호출전에 웹훅이 먼저 도착할수도 있구요.
음 네 순서는 보장안된다고 알고 있어서 그건 처리를 해뒀는데
pending URL 이 안불릴수도 있단걸 생각하고 그냥 orderId 만 매칭해서 처리해야하는 것일까요?
pendingURL이 아예 호출안되는 경우는 고객이 정상적으로 결제 시작했던 화면으로 못왔다고 판단하시고 그냥 결제 를 취소 시켜 버리시거나 order ID 만 가지고 매칭 하시거나 하셔야 할것 같습니다.
무조건 pendingURL 이 불리는것은 아니라는 말씀이군요
국내카드의 경우도 successURL 이 불리지 않을수 있습니다. 다만 국내카드는 호출이 되지 않으면 승인 API 호출이 안되서 결제가 안되는 것이고 알리페이 경우는 승인 API 없이 바로 결제되는 케이스라서 핸들링을 다르게 해주셔야 해요.
혹시 이 같은 대응 방법의 문서를 좀 찾을 수 있을까요? 아무래도 pendingURL 이 안불리게 되면 저희가 매칭하는 paymentKey 의 조회라던가 이런곳에서 보안적인 위험이 있을것 같거든요.
이건 고객이 원 결제 페이지로 이동을 안하시는 것이라 대응방법이라고 할만한게 없습니다.
그게 순서가 원결제 페이지로 이동하는게 고객입장에서는 간편결제를 이용한 뒤에 이동하는 것인가요?
간펴결제(알리페이앱) 에서 결제 완료하고 이전 브라우저나 가맹점앱으로 돌아가는 행위입니다.
그러면 그때의 결제취소는 저희쪽 페이지에 돌아오지 않은 건을 캐치해서 토스페이먼츠 API 로 결제취소를 진행하란 말씀이신거죠?
네 맞습니다.
추가로 한가지만 더 질문드릴게요. 저희가 건수는 적지만 GCash 에서 많이 발생하고 있어서요. 혹시 앱을 켰다가 다시 저희 사이트로 돌아오는 액션이 GCash나 다른 어떤 알리페이+간편결제 에서는 기본으로 돌아온다거나, 아니면 안돌아오는것이 있다거나 하는것이 있을까요?
물론 클라이언트나 각 간편결제앱의 이슈라서 아실진 모르겠지만, 도움주실 수 있음 좋겠습니다.
기본적으로 iOS 는 안돌아오는 것으로 알고 있습니다. 안드로이드는 간편결제 앱마다 다를텐데 저희도 모든 결제수단을 다 확인해볼수 있는것은 아니라서 정확하게 안내는 어렵네요.
음 네 알겠습니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.