링크페이
안녕하세요. 몇가지 질문 드립니다.
1. 링크페이 callbackurl
- 관련하여 링크페이 API 연동 가이드(노션 PDF) 외에 추가적인 가이드가 있을까요?
2. ui세팅
기존에 이미 사용중이던 ui가 있고, 이번에 링크페이를 도입하면서 ui를 분리합니다.
'결제 UI 설정' 페이지에서 ui 추가하는 것 외에 추가적으로 설정해야하는 부분이 있을까요?
링크페이 API 연동 가이드 문서에는 'variantKey' 관련된 부분이 없어서, MID 세팅하여 생성 후 결제 테스트 진행하였는데 새로 생성된 UI가 적용되지 않아 문의드립니다.
21 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
1. api guide는 techsupport@tosspayments.com 에서만 답변드립니다.
2. 링크페이는 UI 변경을 정책적으로 막아두었습니다.
1. 확인했습니다.
2. 그렇다면 링크페이의 경우 기본 UI에서 결제수단 제외 (ex 네이버 페이를 결제창에 노출되지 않도록 삭제)가 불가능한가요?
노션 PDF 이외에 추가 가이드는 없습니다.
링크페이 UI 는 수정이 불가해서 네이버페이를 해당 링크페이 MID 에서 청약에서 제외해달라고 1544-7772 로 요청하셔야 할것 같아요.
네이버페이 결제를 안하고 싶으신거죠?
현업과 결제수단 순서 변경이나, 결제수단 추가/삭제 여부를 논의 중입입니다. 결제수단 순서 변경은 어려운 것으로 이해했습니다. 삭제 쪽으로 결정 되면 알려주신 번호로 요청하도록 하겠습니다.
추가 질문입니다.
Callbackurl의 경우 보안 세팅이 어떻게 될까요?
Callbackurl은 외부에서도 url만 알면 접근 가능한 공개용 엔드 포인트가 되므로, 헤더 세팅이나 시크릿 키 등의 인증 방법이 있으리라 생각됩니다.
링크페이 콜백(웹훅)이 두가지인데요
하나는 PDF 에서 callback 로 안내되는 상점 하나에 한개를 설정할 수 있는 내용이구요
다른 하나는 토스페이먼츠 공용웹훅과 동일하게 서비스됩니다.
문의하신 내용은 공용웹훅의 secret 값을 활용하시면 됩니다.(스크린샷)

공용웹훅을 사용하시려면 개발자센터에서 링크페이 상점아이디에 PAYMENT_STATUS_CHANGED 를 등록하고 사용하시면 되구요
보안 관련 으로 추가 조치를 하신다면 저희 IP 만 화이트 리스트로 처리해주시는것도 좋아 보입니다.
1안: PDF내 callback) PDF에는 상품(product) 생성 시 상품별로 callbackurl을 설정할 수 있는 것으로 나와있습니다. 일부 캡처하여 첨부드리니 같은 내용이이 맞는지 확인 부탁드립니다
2안: 공용웹훅) 문서 내용 확인했습니다. 링크페이를 위해 PAYMENT_STATUS_CHANGED 를 사용하는 경우 tosspayments-webhook-signature 이용해서 검증하면 되는 게 맞을까요?
기타) ip 확인 요청은 이메일(techsupport@tosspayments.com)로 드리면 될까요?

1. 네 맞습니다.
2. 링크페이는 signature가 제공되지 않습니다.
여기 IP 리스트를 처리해 주시면 됩니다.
감사합니다.
PDF내 callback을 사용할경우 toss -> 자사로 콜백 시 Oauth 2.0 세팅이 가능한가요?
안됩니다
공용웹훅에 대한 추가 질문입니다.
웹훅 등록 후 전송 내용까지 확인 했는데요, PAYMENT_STATUS_CHANGED 이벤트 웹훅 본문 내의 secret을 무엇과 비교해야 하는 걸까요? 링크페이는 payment를 자사에서 생성하지 않아 secret 값을 가지고 있지 않습니다.
링크페이는 승인응답을 받지 않으셨을거라 secret 을 비교하실수가 없을겁니다.
1. 저희 노티 서버 화이트 리스팅
2. 웹훅으로 받은 paymentkey 로 거래조회해서 실제 결제 여부 확인
이렇게 두가지 방식으로 해주셔야 할것 같아요.
확인했습니다.
추가 질문입니다.
현재 모든 테스트 상품이 결제 시 반복적으로 실패가 뜨고 있습니다
카카오페이로 테스트 중입니다.
확인 부탁드립니다.

💡 정보 제출
민감 정보를 안전하게 제출해주세요
에러발생하는 링크 제출해주세요
일시적 오류였던 것으로 보입니다. 오후 4시 27분경 동일 링크 재확인 하자 정상적으로 진행 되었습니다. 감사합니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.