결제 통보

Previous결제 취소 Next카드사 / 은행 / 간편결제

Last updated 1 year ago

결제 통보

결제 결과 데이터를 URL로 전달 받는 방법을 제공합니다.

결제 데이터 통보 URL 설정 방법

-> 로그인 -> 가맹점정보 -> 결제환경 설정 -> 결제결과 통보관리

항목 설명

항목

설명

지불수단

결제 데이터 통보를 수신할 결제 수단의 종류입니다.

URL

결제 결과 데이터를 수신할 URL을 입력합니다.

인코딩방식

UTF-8, EUC-KR 중 하나를 선택합니다.

재전송간격

결제 데이터 통보 실패 시점에서 다음 통보 간격을 입력 합니다.(최대 60분)

재전송횟수

최초 결제 데이터 통보 실패 이후 재통보 할 횟수를 입력합니다.(최대 10회)

초기화

URL, 인코딩방식, 재전송간격, 재전송횟수를 초기화 합니다.

가맹점으로 통보 송신 후 HTTP Return Status 응답이 200이 아닌 경우 설정한 기준에 따라 재전송 처리합니다.

방화벽 설정

연결 대상

프로토콜

연결 방향

3.35.204.59

HTTPS

INBOUND

결제통보 연동 시 주의사항

URL 유효성 검증 결제 결과 데이터를 수신할 URL이 유효하지 않은 경우 결제 통보가 정상적으로 진행되지 않습니다.
호출 오류 방화벽 설정이 정상인지 확인
통보 실패 통보 실패가 발생하는 경우 기술담당자 메일로 통보 실패 사유를 전달합니다.

결제 데이터 통보 재전송 방법

결제 데이터 통보 재전송은 결제(취소) 시간 기준으로 24시간 이내에 전송 할 수 있습니다.

파라미터

결제 데이터 통보(공통)

결과 메시지

인증 거래번호

상점아이디

결제 수단 코드 01 : 신용카드 02 : 계좌이체 03 : 가상계좌

결제 수단 Sub 코드 01 : 고정

인증처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133

주문 번호 주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다. 중복되지 않는 고유한 값을 발급해야 합니다.

결제 상품명

거래 금액

구매자명

상점 예약 필드에 셋팅한 값

거래 코드 0 : 일반 1 : 에스크로

결제 일 형태 : yyyyMMdd 예시) 20230914

결제 시간 형태 : HHmmss 예시) 164934

결제 데이터 통보(신용카드)

발급 카드사명

카드 번호

승인 번호

카드 발급사 코드

카드 매입사 코드

카드 할부개월

무이자 여부 0 : 일반 1 : 무이자

포인트 사용 여부 0 : 미사용 1 : 사용

카드 타입 코드 데이터 없으면 공백 리턴 01 : 개인 02 : 법인

체크 카드 여부 데이터 없으면 공백 리턴 0: 신용 1: 체크

결제 데이터 통보(계좌이체)

은행명

승인 번호

현금영수증 요청타입 0 : 미발행 1 : 소득공제 2 : 지출증빙

결제 데이터 통보(가상계좌)

은행명

가상계좌 번호

현금영수증 요청타입 0 : 미발행 1 : 소득공제 2 : 지출증빙

결제 데이터 통보(오프라인)

결과 메시지

인증 거래번호

상점아이디

결제 수단 코드 01 : 신용카드 02 : 계좌이체 03 : 가상계좌

결제 수단 Sub 코드 01 : 고정

인증처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133

주문 번호 중복되지 않는 Unique 값으로 생성

상품명

거래 금액

구매자명

상점 예약 필드에 셋팅한 값

거래 코드 0 : 일반 1 : 에스크로

결제일 형태 : yyyyMMdd 예시) 20230914

결제 시간 형태 : HHmmss 예시) 164934

발급 카드사명

카드 번호

승인 번호

카드 발급사 코드

카드 매입사 코드

카드 할부개월

무이자 여부 0 : 일반 1 : 무이자

포인트 사용 여부 0 : 미사용 1 : 사용

카드 타입 코드 데이터 없으면 공백 리턴 01 : 개인 02 : 법인

체크 카드 여부 데이터 없으면 공백 리턴 0: 신용 1: 체크

취소 데이터

결과 메시지

인증 거래번호

상점아이디

취소 일 형태 : yyyyMMdd 예시) 20230914

취소 시간 형태 : HHmmss 예시) 164934

거래 상태 0 : 승인 1 : 전취소 2 : 후취소 3 : 채번완료 4 : 채번취소 9 : 망취소

결제 수단 코드 01 : 신용카드 02 : 계좌이체 03 : 가상계좌

결제 수단 Sub 코드 01 : 고정

결제 취소 결과 금액

주문 번호 중복되지 않는 Unique 값으로 생성

원거래 아이디

부분 취소 여부 0 : 전체취소 1 : 부분취소

망취소 여부 0 : 일반취소 1 : 망취소

상점 예약 필드에 셋팅한 값

인증처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133

Previous결제 취소 Next카드사 / 은행 / 간편결제

Last updated 1 year ago