결제 통보
결제 결과 데이터를 URL로 전달 받는 방법을 제공합니다.
결제 데이터 통보 URL 설정 방법
씨드페이먼츠 가맹점 관리자 접속 -> 로그인 -> 가맹점정보 -> 결제환경 설정 -> 결제결과 통보관리
항목 설명
지불수단
결제 데이터 통보를 수신할 결제 수단의 종류입니다.
URL
결제 결과 데이터를 수신할 URL을 입력합니다.
인코딩방식
UTF-8, EUC-KR 중 하나를 선택합니다.
재전송간격
결제 데이터 통보 실패 시점에서 다음 통보 간격을 입력 합니다.(최대 60분)
재전송횟수
최초 결제 데이터 통보 실패 이후 재통보 할 횟수를 입력합니다.(최대 10회)
초기화
URL, 인코딩방식, 재전송간격, 재전송횟수를 초기화 합니다.
방화벽 설정
3.35.204.59
HTTPS
INBOUND
결제통보 연동 시 주의사항
URL 유효성 검증 결제 결과 데이터를 수신할 URL이 유효하지 않은 경우 결제 통보가 정상적으로 진행되지 않습니다.
호출 오류 방화벽 설정이 정상인지 확인
통보 실패 통보 실패가 발생하는 경우 기술담당자 메일로 통보 실패 사유를 전달합니다.
결제 데이터 통보 재전송 방법
가맹점애서 결제 데이터 통보를 받지 못하였거나, 이전 성공한 내역에 대해 다시 통보를 받고 싶을 경우 씨드페이먼츠 가맹점 관리자 페이지를 통해 재통보가 가능합니다.
씨드페이먼츠 가맹점 관리자 접속 -> 결제내역 -> 결제내역 조회 -> 결제통보 조회 -> 거래 선택 -> 재전송
파라미터
결제 데이터 통보(공통)
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
Last updated