🍏 개발일기

결제 API에 대하여

보배 진 2025. 11. 28. 11:14

 

 

 

 

 

⭐ API

API는 응용 프로그램 프로그래밍 인터페이스의 약자로,

두 소프트웨어 프로그램 간의 정보 교환을 돕는 컨퓨터 코드이다

 

가장 일반적으로 API는 한 프로그램이 다른 프로그램에서 작동할 수 있도록 한다

ex) 회사 웹사이트에 회사의 본사 위치 지도가 보이는 경우, 방문자는 구글 맵을 방문하기 위해

그 웹사이트를 벗어나지 않고도 해당 지도를 볼 수 있습니다. 

 

 

 

 

 

⭐ 결제 API

결제 API는 애플리케이션 및 온라인 스토어가 결제를 수락하고 처리할 수 있다

즉, 개발자가 직접 카드사나 은행과 통신할 필요없이, 결제 전문 회사의

시스템을 API 형태로 호출해서 결제를 처리하는 방식

▶▶결제를 대신 처리해주는 서비스와 연결되는 통로 ◀◀

 

 

 

 

 

⭐ 결제 API 동작 흐름

 

[사용자] → 결제 버튼 클릭
      ↓
[우리 서버(쇼핑몰)] → PG사 API 호출
      ↓
[PG사] → 카드사/은행과 통신하여 승인 처리
      ↓
PG사 → 결과를 우리 서버로 전달
      ↓
우리 서버 → 사용자에게 성공/실패 화면 제공

 

 

 

 

 

⭐ 결제 API가 필요한 이유

온라인 결제를 개발자가 직접 구현하려면

카드 정보 암호화

금융 보안 규정 준수

카드사, 은행, 간편 결제사와 직접 통신

결제 승인, 취소, 환불 로직

부정 결제 방지

인증 시스템 구축

-> 사실상 불가능에 가까움

 

그래서 결제 대행사가 대신 모든 어려운 걸 처리해주고, 개발자는 API만 이용하는 구조

 

 

 

 

 


 

 

 

 

 

 

⭐ 결제 API로 할 수 있는 일

1. 결제 요청
 ▪ 신용카드 결제
 ▪ 계좌이체
 ▪ 휴대폰 결제
 ▪ 간편 결제 (KakaoPay, 네이버페이, 토스 등)
2. 결제 승인/실패 확인
 결제가 성공 했는지, 실패했는지 결과 제공
3. 결제 취소 (환불)
 주문 취소 시 자동으로 환불 처리 가능
4. 정기 결제 (자동 결제)
 매달 자동으로 카드에서 요금 빠지게 만드는 기능
5. 결제 이력 조회
 결제됐던 기록을 조회

 

 

 

 

 

⭐ 결제 API가 동작하는 구조

1) 우리 서버 ➡ PG사 API 호출 : 이 금액을 이 사람에게 결제해줘

2) PG사 ➡ 카드사/은행과 통신 : 이 결제가 가능한지 확인할게요

3) PG사 ➡ 우리 서버에 결과 전달 : 결제 성공했어요! 또는 실패했어요!

4) 우리 서버 ➡ 사용자에게 결과 보여줌 : 결제가 완료되었습니다

 

 

 

 

 

⭐ 결제 API의 대표 종류

회사(PG)  특징
토스페이먼츠 간편하며 한국에서 많이 사용
아임포트(PortOne) 여러 결제수단 통합 지원
카카오페이 간편결제, QR결제 유명
네이버페이 쇼핑몰에서 많이 사용
Stripe 해외에서 가장 인기 있는 글로벌 결제 API
PayPal API 전 세계 결제 지원

 

 

 

 

 

 

⭐ 결제 API의 장점

▪ 결제 로직을 직접 구현할 필요 없음

▪ 금융 보안 문제도 PG사가 처리

▪ 결제 성공/실패/취소 로직을 통일된 방식으로 관리 가능

▪ 다양한 결제 수단 제공 가능

▪ 특히 보안성을 PG사가 책임져주므로, 개발자는 안전하게 결제 기능을 넣을 수 있음