결제 승인

Last updated 1 year ago

결제 승인 파라미터

결제 요청

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

bid(30byte)

빌링 아이디(빌키)

method

결제수단 CARD(신용카드)

mId(10byte)

상점 아이디

orderId(40byte)

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

orderName(100byte)

상품명

amount(15byte)

거래 금액 숫자만 입력

customerName(30byte)

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

quotaMon(2byte)

카드 할부개월

ediDate(14byte)

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

hashString(256byte)

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

trxCd(1byte)

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

escwAuthTypeCd(1byte)

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

escwAuthNo(20byte)

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

goodsSplAmt(15byte)

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

goodsVat(15byte)

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

goodsSvsAmt(15byte)

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

ordIp(20byte)

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

customerMobilePhone(20byte)

구매자 연락처

customerEmail(60byte)

구매자 이메일 주소

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

noIntUseFlg(1byte)

가맹점 무이자 적용 여부 0 : 미적용(default) 1 : 적용

pointFlg(1byte)

포인트 사용 여부 0 : 미사용(default) 1 : 사용

connCd(4byte)

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

결제 승인

resultCd(4byte)

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

resultMsg(100byte)

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

tid(30byte)

인증 거래번호

mId(21byte)

상점 아이디

method(2byte)

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

spmCd(2byte)

결제 수단 Sub 코드 01 : 고정

ediDate(14byte)

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

orderId(40byte)

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

orderName(100byte)

상품명

amount(15byte)

결제 금액

customerName(30byte)

구매자명

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

trxCd(1byte)

거래코드 에스크로 사용여부 0 : 일반(default) 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/bill/pay Protocol : HTTP/1.1 Method : POST Encoding : UTF-8 Content-Type : application/json

bid(30byte)

빌링 아이디(빌키)

method

결제수단 CARD(신용카드)

mId(10byte)

상점 아이디

orderId(40byte)

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

orderName(100byte)

상품명

amount(15byte)

거래 금액 숫자만 입력

customerName(30byte)

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

quotaMon(2byte)

카드 할부개월

ediDate(14byte)

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

hashString(256byte)

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

trxCd(1byte)

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

escwAuthTypeCd(1byte)

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

escwAuthNo(20byte)

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

goodsSplAmt(15byte)

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

goodsVat(15byte)

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

goodsSvsAmt(15byte)

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

ordIp(20byte)

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

customerMobilePhone(20byte)

구매자 연락처

customerEmail(60byte)

구매자 이메일 주소

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

noIntUseFlg(1byte)

가맹점 무이자 적용 여부 0 : 미적용(default) 1 : 적용

pointFlg(1byte)

포인트 사용 여부 0 : 미사용(default) 1 : 사용

connCd(4byte)

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

결제 승인

resultCd(4byte)

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

resultMsg(100byte)

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

tid(30byte)

인증 거래번호

mId(21byte)

상점 아이디

method(2byte)

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

spmCd(2byte)

결제 수단 Sub 코드 01 : 고정

ediDate(14byte)

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

orderId(40byte)

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

orderName(100byte)

상품명

amount(15byte)

결제 금액

customerName(30byte)

구매자명

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

trxCd(1byte)

거래코드 에스크로 사용여부 0 : 일반(default) 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: 체크