카카오페이를 포트원으로 연동해야하는 이유

국내에서 두번째로 사용률이 높은 간편결제 '카카오페이' 포트원으로 연동해야하는 이유

2023. 5. 3.

국내에서 두 번째로 사용률이 높은 간편결제, 카카오페이를 포트원으로 연동해야 하는 이유는 무엇일까요? 이번 아티클을 통해 카카오페이의 특별한 구조와 연동 방식을 알아봅니다.

1. 카카오페이만의 독특한 구조

대부분의 PG사들은 서로 비슷한 구조과 개념을 가지고 있습니다. 하지만 카카오페이와 같은 간편결제사들은 이와 비슷한 듯 다른 자신들만의 고유한 개념을 가지고 있는데요. 이 때문에 용어를 새롭게 학습하는 과정이 필요합니다. 대표적으로 아래의 용어들은 반드시 학습해야 하는 개념들입니다.

용어

설명

PG사에 대응하는 개념

CID
가맹점 코드, 제휴를 통해 발급, 결제 유형과 단위의 정의
MID, 상점아이디
TID
결제 한 건에 대한 고유번호. 결제 준비 API가 성공적으로 호출되면 발급
TID, 거래번호
SID
정기결제에 사용되는 고유번호. 정기결제 1회차 프로세스가 완료되면 발급 2회차 정기결제부터는 SID를 통해 결제 요청
BillKey, BillingKey 결제정보와 매칭되는 정기결제 고유키
AID
결제, 취소, 정기결제 API 호출에 대한 고유번호. 각 API 호출 성공 시 발급
TraceNo, 하위거래번호
결제 연동 개발이 익숙하고 기존 PG 연동에 숙련된 개발자도 간편결제를 처음 도입한다면 일반적인 PG 연동 개발 때처럼 쉽게 개발을 마칠 수 없을 텐데요. 낯선 용어와 개념들을 새로이 파악하는 시간이 절대적으로 필요하기 때문입니다.
그러나, 포트원은 이러한 개념들을 공통화하여 제공하고 있어 낯선 용어들을 학습하는 시간을 최소화하실 수 있습니다. 포트원은 서로 다른 개념들을 공통화시키는 데에 그치지 않습니다. 결제 과정에서 불필요한 단계를 걷어내고 결제에 필요한 최소한의 단계만을 가맹점에 노출하고 있습니다.
기존 카카오페이의 결제 흐름
준비단계 → 인증단계 → 인증완료응답 → 결제승인 단계
카카오페이의 경우, 각 단계마다 전송해야 하는 데이터와 호출해야 하는 API가 모두 달라 실제 개발 과정이 번거로운데요. 이를 포트원이 대신 처리해드립니다.
카카오페이 결제 흐름 ⓒ포트원
고객이 결제를 취소했을 경우의 결제 흐름을 예로 들어보겠습니다. 결제 과정을 중단하려면 먼저 보안을 위해 주문 상세 조회 API를 호출해야 합니다. 주문 상세 조회 API를 호출한 뒤 조회 상태 값이 ‘QUIT_PAYMENT(사용자가 결제를 중단했다는 의미의 상태값)’인 것을 확인해야 합니다.
또한 요청 성공, 취소, 유효시간 경과 등 다양한 조건에 따라 각각 다른 주소로 redirect하게 됩니다. 만일 결제요청에 성공했다면 요청 성공 주소로 전달 받은 PG_Token을 결제 승인 API로 전송해야 합니다. 이때 각 요청에 따른 응답 처리 및 예외사항 처리가 뒤따릅니다.
카카오페이 API 인증 ⓒ포트원
요청이 성공하면 응답 바디에 JSON 객체로 다음 단계 진행을 위한 값들을 받습니다. 서버(Server)는 tid를 저장하고, 클라이언트는 사용자 환경에 맞는 URL로 리다이렉트(redirect)합니다.
카카오페이 결제 준비 ⓒ포트원
결제수단이 CARD, MONEY에 따라 RESPONSE가 다릅니다.
카카오페이 결제 승인 ⓒ포트원
보기에 단순한 결제 취소 케이스일지라도, 서버 위에서는 위와 같이 복잡한 통신 과정이 필요한데요. 포트원은 결제창 호출을 위한 함수 호출과 콜백(또는 redirect_url)을 통한 최종결과 수신으로 위 과정을 축약합니다. 여러 단계가 한 번의 REQUEST와 RESPONSE로 축약되면서 개발 및 테스트 과정을 단축할 수 있는 것이죠.
결제 단계별 로딩 ⓒ포트원
또한 포트원은 각 단계를 로깅 하기 때문에, 결제 실패사유를 확인하고 결제 성공률을 높히기 위한 인사이트까지 얻을 수 있습니다.

2. 카카오페이 정기결제에 예약 기능 더하기

카카오페이를 통해 정기결제를 구현하기 위해서는 납부자로부터 최초 1회에 한하여 카카오페이 인증을 받은 후, 결제시점에 SID로 정기결제 API를 전송해야 합니다.
이는 다음과 같은 가맹점의 정기결제 관리 cost를 요구합니다.
1. 고객별 정기결제 정보 관리 고객ID, SID, 정기결제일, 시작일, 종료일, 결제금액 등 2. 고객의 결제정보 변경에 따른 스케쥴 관리 SID 재생성, 결제금액/정기결제일 변경에 따른 중복결제 방지 등 3. 정기결제 배치 검증 프로세스 정상 수행여부, 누락/오결제에 대한 재처리 등
하지만, 포트원의 ‘예약 기능'을 사용한다면, 정기결제 시 결제 오류를 최소화 할 수 있습니다. 또한 결제 스케줄을 미리 등록하여 정기결제 누락을 방지하고, 필요에 따라서는 예약내역을 삭제하여 결제를 취소할 수도 있습니다. 이렇게 사전에 정기결제를 컨트롤 할 수 있기 때문에 최종 결제 API만 전송하는 사양을 보강해 줍니다.
포트원의 예약결제현황 캘린더로 정기결제 현황을 한 눈에 확인하고 관리하세요 ⓒ포트원

3. 결제수단과 PG사를 추가할수록 강력해지는 연동 효용성

카카오페이만을 결제수단으로 제공하고자 하는 가맹점은 많지 않을 것 입니다. 앞서 언급한 일반적인 내용 외에 프로모션, 현금영수증, 결제환경 별 사양정리 및 테스트까지 시스템에 반영하려면 복잡도는 더욱 증가합니다. 또한 다른 간편결제나 PG를 추가 도입하고자 한다면 새로운 학습과정 외에 기존 설계 구조를 변경해야 하는 비용과 수고를 감내해야 할지도 모릅니다.
사업과 서비스가 성장할수록 더욱 커지는 포트원의 효용성 ⓒ포트원
포트원은 카카오페이, 네이버페이, 토스페이, 페이코와 같은 국내 간편결제 뿐 아니라 해외 간편결제(알리페이, 페이팔)까지 최대한 공통화/간소화하여 가맹점에게 새로운 학습 곡선과 경험 곡선을 선보이고 있습니다. 사업이 성장하고 서비스가 확장될 수록 더욱 커지는 포트원의 효용성도 함께 경험하세요.
연동 개발이 끝난 후에도 데이터 통합 조회 및 분석이 가능한 애널리틱스 도구가 제공되기 때문에 결제 연동 서비스 도입을 고려하는 개발자, 시스템관리자, 경영자라면 당장 도입을 검토하시기를 추천드립니다. 포트원을 모르는 개발자는 있어도 알면서 안 쓰는 개발자는 없습니다! 이제 결제는 ‘결제 전문가 포트'에 맡기고 비즈니스에 더욱 집중하세요.
>>> 함께 읽으면 좋은 포트원 콘텐츠
네이버페이를 포트원으로 연동해야하는 5가지 이유
지금 바로 포트원 도입 문의하기를 통해
나의 비즈니스에 맞는 결제 솔루션을 상담받아보세요.
포트원에서 도입문의와 PG 연동까지 모든 과정을 무료로 진행하실 수 있습니다.
도입 문의하기