결제 통보

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

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

씨드페이먼츠 가맹점 관리자 접속 -> 로그인 -> 가맹점정보 -> 결제환경 설정 -> 결제결과 통보관리

항목 설명

항목

설명

지불수단

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

URL

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

인코딩방식

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

재전송간격

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

재전송횟수

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

초기화

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

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

방화벽 설정

연결 대상

프로토콜

연결 방향

3.35.204.59

HTTPS

INBOUND

결제통보 연동 시 주의사항

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

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

가맹점애서 결제 데이터 통보를 받지 못하였거나, 이전 성공한 내역에 대해 다시 통보를 받고 싶을 경우 씨드페이먼츠 가맹점 관리자 페이지를 통해 재통보가 가능합니다.

씨드페이먼츠 가맹점 관리자 접속 -> 결제내역 -> 결제내역 조회 -> 결제통보 조회 -> 거래 선택 -> 재전송

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

파라미터

결제 데이터 통보(공통)

resultCd(4byte)

성공, 실패 코드 : 0000 : 0000을 제외한 나머지

resultMsg(100byte)

결과 메시지

tid(30byte)

인증 거래번호

mId(10byte)

상점아이디

method(2byte)

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

spmCd(2byte)

결제 수단 Sub 코드 01 : 고정

ediDate(14byte)

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

orderId(40byte)

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

orderName(100byte)

결제 상품명

amount(15byte)

거래 금액

customerName(30byte)

구매자명

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

trxCd(1byte)

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

trDt(8byte)

결제 일 형태 : yyyyMMdd 예시) 20230914

trTm(6byte)

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

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

fnNm(20byte)

발급 카드사명

cardNo(20byte)

카드 번호

appNo(20byte)

승인 번호

appCardCd(2byte)

카드 발급사 코드

acqCardCd(2byte)

카드 매입사 코드

quotaMon(2byte)

카드 할부개월

noIntFlg(1byte)

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

pointFlg(1byte)

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

cardTypeCd(2byte)

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

chkcardFlg(1byte)

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

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

fnNm(20byte)

은행명

bankCd(4byte)

은행 코드 은행 코드 바로가기

appNo(20byte)

승인 번호

crctReqType(1byte)

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

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

fnNm(20byte)

은행명

bankCd(4byte)

은행 코드 은행 코드 바로가기

vacntNo(20byte)

가상계좌 번호

crctReqType(1byte)

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

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

resultCd(4byte)

성공, 실패 코드 : 0000 : 0000을 제외한 나머지

resultMsg(100byte)

결과 메시지

tid(30byte)

인증 거래번호

mId(21byte)

상점아이디

method(2byte)

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

spmCd(2byte)

결제 수단 Sub 코드 01 : 고정

ediDate(14byte)

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

orderId(40byte)

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

orderName(100byte)

상품명

amount(15byte)

거래 금액

customerName(30byte)

구매자명

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

trxCd(1byte)

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

trDt(8byte)

결제일 형태 : yyyyMMdd 예시) 20230914

trTm(6byte)

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

fnNm(20byte)

발급 카드사명

cardNo(20byte)

카드 번호

appNo(20byte)

승인 번호

appCardCd(2byte)

카드 발급사 코드

acqCardCd(2byte)

카드 매입사 코드

quotaMon(2byte)

카드 할부개월

noIntFlg(1byte)

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

pointFlg(1byte)

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

cardTypeCd(2byte)

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

chkcardFlg(1byte)

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

취소 데이터

resultCd(4byte)

성공, 실패 코드 : 0000 : 0000을 제외한 나머지

resultMsg(100byte)

결과 메시지

tid(30byte)

인증 거래번호

mId(21byte)

상점아이디

trDt(8byte)

취소 일 형태 : yyyyMMdd 예시) 20230914

trTm(6byte)

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

trxStCd(2byte)

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

method(2byte)

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

spmCd(2byte)

결제 수단 Sub 코드 01 : 고정

ccAmt(15byte)

결제 취소 결과 금액

orderId(40byte)

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

otid(30byte)

원거래 아이디

partCanFlg(1byte)

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

netCanFlg(500byte)

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

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

ediDate(14byte)

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

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

Last updated 2 years ago

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

hashtag항목 설명

hashtag방화벽 설정

hashtag결제통보 연동 시 주의사항

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

hashtag파라미터

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

항목 설명

방화벽 설정

결제통보 연동 시 주의사항

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

파라미터