링크페이 플로우 문의 드립니다.
현재 진행중인 프로젝트가 학원이라 링크페이를 학원비 결제 용도로 사용 하려고 하는데 플로우 문의 사항이 있습니다.
1.학원이 클래스 별 수업 일자를 다르게 등록하여 학원비 결재마다 수업료가 다른데 매 결제마다 상품을 수량을 1로 매번 등록을 하고 url을 받아야 하나요?
2.만약 그렇다면 저렇게 상품을 등록하고 학부모들이 결제를 할 떄 결제 링크가 만료되었거나 결제가 실패되었을때 결제 url 재발급은 어떤 API를 사용 해야 하나요?
3.결제 url로 결제 완료시 결제 결과는 상품 등록 시 콜백url로 결과값을 받는건가요?
36 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
1. 맞습니다. 말씀하신대로라면 주문때마다 결제항목 및 금액이 가변적인것으로 보이므로,
a. 주문시 상품등록을 동시 진행 => 상품등록 완료시 해당 상품id 로 SMS 전송 API 호출 로 진행하셔야 할것 같습니다.
2. 기존 URL이 만료되었다면, 추가적인 상품등록없이 동일 상품 ID로 SMS 전송 API를 호출하시면 됩니다.
3. 맞습니다. 상품등록시 올린 callbackUrl 로 이후 승인결과가 웹훅으로 전송됩니다.
답변감사합니다!!
아 추가로 SMS 전송API는 해외 휴대폰번호로도 발송이 가능한가요??
해외휴대폰은 국내 SMS 방식을 사용하지 않으므로 발송이 불가능합니다.
아 그럼 해외 휴대폰 사용자는 따로 저희가 링크를 발송을 해줘야 하는군요 답변 감사합니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
혹시 기존 URL이 만료되었고 학부모가 해외 휴대폰 사용자면 상품조회로 결제URL(paymentLink) 받은 값으로 다시 전달을 하면 되는 부분일까요?
링크페이에서 만료기능을 사용하시나요?
링크페이에서 만료 파라미터가 보이진 않는데 혹시 만료 기간이 디폴트로 설정되어있는건가 싶어서요
기본적으로 링크페이 상품은 만료가 되지 않습니다.
특별히 설정 안하셨다면 만료되지 않아요.
아 넵 확인 감사합니다!
냥과장님 답변에 부연설명 드리면
상품생성 API에서 필수파라미터로 받는 type 이 있습니다.
NORMAL , ONETIME 중 하나로 올리는데, 디폴트는 NORMAL 이고 이렇게 올리면 상품은 만료되지 않습니다.
추가 답변 감사합니다!
여기서 successUrl과 failUrl은 페이지 url을 말하는걸까요?
네 링크페이 결제후에 이동할 페이지입니다.
결제 완료후에 보여주고 싶은 페이지가 있으시면 넣으시면 됩니다.
아하 네 알겠습니다.
추가적인 질문 드립니다. callbackUrl로 결제 성공 응답값을 줄때 해당 리스폰스 값은 주문 콜백전송과 동일한건가요? 그럼 성공 결과가 어떤 주문 또는 상품에 대한 결제 완료인지 키값은 없는건가요...?
callbackUrl 이 설정되면 그 URL 로 주문콜백이 전송됩니다. 동일한거에요.
콜백 보시면 어떤 상품 인지 정보 있습니다.
아 죄송합니다 문서 상단에 주문 콜백 포맷이있었네요 답변 감사합니다!
{
"status": "APPROVAL",
"amount": 100,
"orderId": "linkBfb_0yQkWPV",
"paymentKey": "6evl2J9MNzjkYG57Eba3Gbly99Dwl8pWDOxmA1QXRyZ4gLwK",
"paymentMethod": "CARD",
"customerPhoneNumber": "01011112222",
"queryParams": {},
"shipping": {
"fullAddress": "(06133) 서울특별시 강남구 테헤란로 131(역삼동) 15층",
"receiver": "추대윤",
"postalCode": "06133",
"address": "서울특별시 강남구 테헤란로 131(역삼동)",
"detailAddress": "15층"
}
}
해당 포맷에서 어떤 상품인지는 어떻게 알 수 있을까요?
아 콜백에서 주문번호이용해서 주문 상세조회 하시면 됩니다.
아 넵 알겠습니다.
혹시 취소는 부분취소가 없는건가요?? 전체 취소만 되는건가요??
문서 어떤 담당자에게 받으셨어요?
고객사 담당자분께서 계약 담당자분께 받은 문서입니다.
고객사 명이 어떻게 되나요?
베테랑스 인데 아직 계약이 진행이 된것은 아닌거로 알고 있습니다.
고객사 명은 베테랑스 입니다.
이거, 베테랑스 측에서 어떤 루트로 링크페이 API 문서 받으신건지 확인 좀 부탁 드릴게요
네 알겠습니다.
토스측에 문의해서 메일을 통해서 받았다고 하십니다.
네, 당연히 그러셨을것 같은데,
저희측 담당자가 어떤 분인지 알려주실 수 있으실까요?
techsupport@tosspayments.com 으로 메일주소 / 담당자 성함 등 전달 주시면 좋을것 같습니다.
고객사 담당자분께 확인되는대로 내용 전달 드리겠습니다.
고객사 담당자분께서 공식 문의 번호로 통해서 상담사랑 이야기하고 해당 메일 발신자로 받은거라고 하십니다.
어떤 인입 이력으로, 어떤 버전의 문서가 나갔는지를 보고 싶은것이니,
담당자 특정이 안된다면,
저희측 고객센터로 문의한 담당자 이름, 해당 파일을 수신한 담당자 이메일주소,
요청하고 메일 수신한 일자 등도 부탁 드립니다.
네 고객사 담당자분께 요청을 해보도록 하겠습니다.
확인 했고, 삭제 했습니다 (개인정보 이슈)
넵 알겠습니다.
내부 확인 했습니다.
계속 핑퐁 요청드려서 죄송합니다.
고객사 담당자 분께서, techsupport@tosspayments.com 으로
링크페이 public API 문서 요청 하실 수 있도록 내용 전달 도움을 부탁 드립니다.
저희는 토스페이먼츠 Technical Account Management Team 이며,
이제 대외로 공개되는 public API 의 이력 관리를 담당하고 있습니다.
넵 알겠습니다 확인 감사합니다.!