API 에 대한 상세한 스펙을 확인할 수 있는 문서를 받아볼 수 있을까요?
이 링크의 문서들은 전부 읽었으나
확인하기 어려운 부분들이나 충돌되는 내용들이 있는것 같아 개발에 어려움이 있습니다.
예를들면,
위 링크에서는 “Redirect시 approval_url에 쿼리스트링(Query string)으로 pg_token을 전달드립니다.”
라고 설명하지만
이 링크에서는 “사용자가 카카오톡 결제 화면에서 결제 수단을 선택하고 비밀번호 인증까지 마치면, 결제 대기 화면은 결제 준비 API 요청 시 전달받은 approval_url 에 pg_token 파라미터를 붙여 대기화면을 approval_url 로 redirect 합니다.”
라고 파라미터와 쿼리스트링이 충돌합니다.
결제준비 이후 승인까지의 타임아웃은 있나? 얼마인가?
유저의 결제인증 타임아웃은 15분 인가?
동일 유저아이디로는 동시에 두가지 결제가 진행될 수 없는것이 보장되나? 어떤 에러?
동일 주문아이디로는 동시에 또는 첫번째 결제 승인 이후에 두번째 결제 시도시 어떤 에러?
결제준비 이후 결제준비 취소요청과 결제승인 이후 취소요청은 같은 API 이용하나? 자세한 사용은?
approval_url 로 redirect 될때 pg_token 을 쿼리스트링으로 전달하는가? 파라미터로 전달하는가?
approval_url 로 redirect 되어 받은 요청에 대한 응답은 카카오페이 서버와 유저에게 어떤 역할을 하나?
approval_url 로 redirect 가 4xx, 5xx 등 에러경우 카카오페이는 어떻게 처리하는가?
등등 확인할 수 없는 부분이 많은것 같습니다.
잘 정리된 API 문서가 있을것 같은데? 어디에서 볼 수 있나요?
안녕하세요 카카오페이 온라인결제 입니다.
보고계신 카카오페이 개발자센터 내 API 가이드가 가맹점용 API 문서가 맞으며 그 외 상세한 요건 등은 포럼 내 온라인결제 FAQ를 함께 참고 해 보시면 도움이 될 것 같습니다.
https://developers.kakaopay.com/forum/t/faq-api-faq/414/2
pg_token redirect 호출 샘플 :
https://developers.kakao.com/approval?user_id=123&pg_token=9ebdc54cb6f43d04f980
-결제준비 이후 15분 이내 승인이 되지 않을 경우 해당 거래는 실패(FAIL) 처리 됩니다.
-가맹점의 주문번호(partner_order_id)는 정보성 필드로 활용되며 중복 검증을 하지 않습니다.
-결제준비 성공 상태는 실제 결제가 이루어진 상태가 아니므로 취소가 불필요합니다. 결제 승인이 완료된 거래는 결제취소 API로 취소 요청할 수 있습니다.
-approval_url로의 redirect는 결제창 진입 이후 대기 상태인 브릿지페이지(next_redirect_pc/app/web_url)를 가맹점의 approval_url로 redirection 것으로 redirection 이후에 카카오페이 서버에서 응답을 추가적으로 처리하는 부분은 없습니다. redirection은 가맹점으로 결제인증(사용자의 비밀번호 인증) 결과를 noty하는 역할 및 pg_token을 전달하기 위한 것으로 유저가 아닌 가맹점 서버에서 redirection 결과에 따라 적절한 후속 액션을 취하도록 구현 해 주시면 됩니다.
오류 케이스 별 상세한 확인 등은 오류 거래 정보(tid 등)와 가맹점정보와 함께 카카오페이 온라인지원 그룹메일 kakaopay_pg@kakaopaycorp.com 으로 주시면 더욱 빠른 확인이 가능합니다.
감사합니다.
