개요
결제흐름
구매자가 결제를 요청하면 가맹점에서 해당 결제정보를 등록하고, 구매자는 결제창에서 결제를 진행하면 가맹점의 returnUrl로 암호화된 인증정보를 전달합니다.
가맹점은 암호화된 인증정보를 이지페이로 승인을 요청합니다. 결제 성공 응답을 받으면 가 맹점은 최종 결제완료 처리를 합니다.
본 연동가이드는 신용카드, 간편결제(카카오, 네이버, 페이코, 토스, SSG, Lpay), 계좌이체, 휴대폰소액결제 서비스를 지원합니다.
모든 API 응답 대기시간은 최대 30초를 권장합니다.
HTTP 헤더
HTTP POST 방식으로 요청하는 모든 API 호출 시 아래 내용을 필수로 추가해 주시기 바랍니다.
| 항목 | Desc | 설명 |
|---|---|---|
| Content-type | application/json | |
| Charset | UTF-8 |
오류처리
HTTP Status Code
이지페이에서 제공하는 API 응답으로 전달되는 HTTP Status Code는 아래와 같은 기본 Rule을 충족합니다.
| 2XX | HTTP요청이 성공적으로 처리되었음을 의미합니다.(예. 200, 201, 204) |
| 4XX | 가맹점의 요청이 잘못 되거나, 요청정보가 없음을 의미합니다.(예. 400, 403, 404) |
| 5XX | 이지페이의 서버 이상 또는 내부 오류가 발생했음을 의미합니다.(예. 500, 503) |
API 오류응답
HTTP Status Code가 2XX(성공)일 경우만 API요청에 대한 응답코드, 응답메시지가 전송됩니다.
응답코드와 응답 메시지는 서비스 업데이트 시 변경될 수 있습니다.