결제 승인

Last updated 1 year ago

결제 승인 파라미터

결제 요청

URL : /payment/v1/keyin Protocol : HTTP/1.1 Method : POST Encoding : UTF-8 Content-Type : application/json

method(10byte)

결제수단 CARD(신용카드)

mId(10byte)

상점 아이디

orderName(100byte)

상품명

orderId(40byte)

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

amount(15byte)

거래 금액 숫자만 입력

customerName(30byte)

구매자명 한글/특수기호 입력가능

cpCd(2byte)

카드사 코드

cardNo(16byte)

카드 번호

cardTypeCd(2byte)

카드 타입 코드 01 : 개인 02 : 법인

cardExpirationYear(2byte)

카드 유효연도 예시) yy(24)

cardExpirationMonth(2byte)

카드 유효 월 예시) mm(03)

quotaMon(2byte)

신용 카드의 할부 개월 수 00 : 일시불

ediDate(14byte)

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

hashString

결제정보 검증 데이터 (mid + ediDate + amount + 가맹점KEY) 인증 데이터 정합성을 위해 가맹점에서 HASH값 비교

trxCd(1byte)

거래코드 에스크로 사용여부 0 : 일반(default) 1 : 에스크로

escwAuthTypeCd(1byte)

에스크로 인증 타입(trxCd 값이 1일 경우 필수) 1 : 휴대폰 번호 2 : 사업자 번호

escwAuthNo(20byte)

에스크로 인증 번호(trxCd 값이 1일 경우 필수)

customerMobilePhone(20byte)

구매자 연락처

customerEmail(60byte)

구매자 이메일 주소

ordIp(20byte)

구매자 아이피 유저 접속 아이피(IPv4, IPv6 지원)

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

ordAuthNo(10byte)

카드인증번호 생년월일(사업자번호)(계약에 따라 필수 여부 다름)

cardPw(2byte)

카드 비밀번호 앞 2자리(계약에 따라 필수 여부 다름)

noIntUseFlg(1byte)

가맹점 무이자 적용 여부 0 : 일반 1 : 무이자

pointFlg(1byte)

카드로 결제할 때 설정하는 카드사 포인트 사용 여부 0 : 미사용 1 : 사용

goodsSplAmt(15byte)

결제 수수료의 공급가액(부가세 설정이 전송금액 기준이면 필수)

goodsVat(15byte)

결제 수수료 부가세(부가세 설정이 전송금액 기준이면 필수)

goodsSvsAmt(15byte)

상품 봉사료(부가세 설정이 전송금액 기준이면 필수)

connCd(4byte)

접속 타입 Default: userAgent 값을 확인하여 0001/0002 세팅 0001: PC Web 0002: Smartphone

결제 승인

resultCd(4byte)

승인 결과 코드, 실패 코드 : 0000 : 0000을 제외한 나머지

resultMsg(100byte)

결과 메시지 : 정상처리 : 기타 오류 메시지

tid(30byte)

인증 거래번호

mId(10byte)

상점 아이디

method(2byte)

지불수단 (결제방식) 01 : 카드결제

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: 체크

결제 승인 파라미터

결제 요청

URL : /payment/v1/keyin Protocol : HTTP/1.1 Method : POST Encoding : UTF-8 Content-Type : application/json

method(10byte)

결제수단 CARD(신용카드)

mId(10byte)

상점 아이디

orderName(100byte)

상품명

orderId(40byte)

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

amount(15byte)

거래 금액 숫자만 입력

customerName(30byte)

구매자명 한글/특수기호 입력가능

cpCd(2byte)

카드사 코드

cardNo(16byte)

카드 번호

cardTypeCd(2byte)

카드 타입 코드 01 : 개인 02 : 법인

cardExpirationYear(2byte)

카드 유효연도 예시) yy(24)

cardExpirationMonth(2byte)

카드 유효 월 예시) mm(03)

quotaMon(2byte)

신용 카드의 할부 개월 수 00 : 일시불

ediDate(14byte)

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

hashString

결제정보 검증 데이터 (mid + ediDate + amount + 가맹점KEY) 인증 데이터 정합성을 위해 가맹점에서 HASH값 비교

trxCd(1byte)

거래코드 에스크로 사용여부 0 : 일반(default) 1 : 에스크로

escwAuthTypeCd(1byte)

에스크로 인증 타입(trxCd 값이 1일 경우 필수) 1 : 휴대폰 번호 2 : 사업자 번호

escwAuthNo(20byte)

에스크로 인증 번호(trxCd 값이 1일 경우 필수)

customerMobilePhone(20byte)

구매자 연락처

customerEmail(60byte)

구매자 이메일 주소

ordIp(20byte)

구매자 아이피 유저 접속 아이피(IPv4, IPv6 지원)

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

ordAuthNo(10byte)

카드인증번호 생년월일(사업자번호)(계약에 따라 필수 여부 다름)

cardPw(2byte)

카드 비밀번호 앞 2자리(계약에 따라 필수 여부 다름)

noIntUseFlg(1byte)

가맹점 무이자 적용 여부 0 : 일반 1 : 무이자

pointFlg(1byte)

카드로 결제할 때 설정하는 카드사 포인트 사용 여부 0 : 미사용 1 : 사용

goodsSplAmt(15byte)

결제 수수료의 공급가액(부가세 설정이 전송금액 기준이면 필수)

goodsVat(15byte)

결제 수수료 부가세(부가세 설정이 전송금액 기준이면 필수)

goodsSvsAmt(15byte)

상품 봉사료(부가세 설정이 전송금액 기준이면 필수)

connCd(4byte)

접속 타입 Default: userAgent 값을 확인하여 0001/0002 세팅 0001: PC Web 0002: Smartphone

결제 승인

resultCd(4byte)

승인 결과 코드, 실패 코드 : 0000 : 0000을 제외한 나머지

resultMsg(100byte)

결과 메시지 : 정상처리 : 기타 오류 메시지

tid(30byte)

인증 거래번호

mId(10byte)

상점 아이디

method(2byte)

지불수단 (결제방식) 01 : 카드결제

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: 체크