정의
토스페이먼츠가 제공하는 통합결제창을 이용해서 신용/체크카드로 결제하는 결제 방식입니다.
가장 일반적이고 연동 공수가 적게 드는 방식입니다.
아래와 같이 토스페이먼츠에서 간편결제사, 카드사를 일괄적으로 표시하고, 사용자가 카드사를 선택하면 각 카드사가 제공하는 인증화면으로 이동해서 인증을 진행하는 방식입니다.
최초 사용자가 결제창을 호출하고 본인이 결제하려고 하는 카드사를 선택하면, 각 카드사가 제공하는 인증 화면으로 이동하고, 여기에서 다양한 방법(앱카드, SMS, ARS등) 을 통해 인증을 완료하면, 가맹점이 설정한 successURL 로 승인에 필요한 paymentKey 가 전달 됩니다.
가맹점에서는 해당 paymentKey 를 이용해서 결제 승인 API 를 호출해 주시면 최종적으로 결제가 진행됩니다.
사용 시나리오
1.
대부분의 인터넷 쇼핑몰에서 제공하는 신용/체크카드를 이용한 1회성 결제를 진행하는 경우
2.
가장 기본적인 카드 결제 방식으로 특별한 요구사항이 없다면 통합결제창 방식을 쓰시기를 권장합니다.
고려 사항
통합결제창은 카드 결제에 필요한 기본적인 결제창을 토스페이먼츠가 제공하기 때문에 통합결제창 내에 표시되는 부가정보(무이자 할부, 즉시할인 프로모션) 등을 토스페이먼츠에서 설정된 값에 따라 자동으로 표시해 드립니다.
그렇기 때문에 가맹점에서 기본적인 무이자 할부정보 및 즉시할인 적용을 위해 별도의 구현을 하지 않으셔도 됩니다.
반면에 특정 결제건에 프로모션을 적용하지 않으시려는 상황이나, 결제창을 커스터마이징 하기를 원하시는 경우는 지원할 수 없는 제한점이 있습니다.
또한, 통합결제창 내에 표시 되는 카드사의 순서와 결제창 최상단에 표시되는 무이자 할부 표시 등은 카드사와 협의를 통해 정해진것으로 가맹점 임의대로 변경하는 것이 불가합니다. 하지만 가맹점 특성상 특정 카드를 표시 하지 않는 것은 청약을 통해 가능합니다. 이때 표시 되지 않는 카드사는 매입사 기준입니다. 즉 비씨 카드를 청약에서 제외하게 되면, 매입사가 비씨 카드인 전북, 제주, 광주 등이 표시 되지 않습니다.
하지만, 간편 결제의 경우 가맹점 요청에 따라 순서를 바꾸는 것이 가능하고 이는 연동 파라미터등으로 되는 것이 아니라 토스페이먼츠 내부 설정으로 수정하는 것으로 고객센터를 통해 요청해 주시기 바랍니다.
즉, 가장 기본적인 기능을 토스페이먼츠에서 제공하지만, 가맹점이 원하시는 특별한 시나리오가 있다면 지원이 어려운 방식입니다.
토스페이먼츠가 제공하는 통합결제창 방식
통합결제창은 그대로 사용한다면 가맹점이 신경 쓰실 것이 많지 않습니다. 단순하게 기본 연동만 하게 되면 결제를 진행하는데 큰 문제가 없습니다.
하지만 통합결제창에서 가맹점의 특정 요구사항을 만족하기 위해 전체 카드사를 표시하지 않고 한개의 카드사만을 띄우는 것이 가능합니다.
프로모션, 무이자 할부, 포인트 사용 유무등에 대한 개발을 줄이기 위해 통합결제창을 사용하면서 카드사 별로 다른 할부 기간을 제공해야 하거나 특정 카드사로 결제시 상점이 수수료를 부담하는 무이자 할부기간을 통합결제창에 표시하는 것이 가능합니다.
포인트 사용은 기본적으로 카드사와 협의 되어 해당 상점이 포인트결제가 가능하도록 설정이 되어 있어야 하며, 통합결제창을 호출할 때, useCardPoint 파라미터를 이용해서 조절이 가능합니다.
고객님이 포인트 사용여부를 선택하도록 하려면 useCardPoint 를 아예 보내지 않거나, useCardPoint : null 로 보내주시면 되고, useCardPoint : true 이면 포인트 사용, useCardPoint : false 이면 포인트 사용 UI 가 아예 표시 되지 않습니다.
간편 결제의 경우 상점 청약(계약) 내용에 따라 통합결제창 내에 표시하거나 표시 하지 않는 것이 가능합니다.
기본적으로 통합결제창은 프로모션이 자동으로 적용됩니다. 다만 프로모션 이 가능한것으로 통합결제창에 표시된 상태에서 고객님이 결제를 진행하는 와중에 예산을 다 사용하는 경우가 있습니다. 이런 경우 해당 고객님은 이미 프로모션 적용이 가능한것으로 표시가 되었기 때문에 예산이 다 소모 되었어도 프로모션이 적용됩니다. (예산은 -로 처리 됩니다)