결제 승인

본 페이지에서는 결제 승인 요청에 대해 설명합니다. 가상계좌 결제는 웹 페이지에서 카드정보를 입력해 결제를 진행합니다.

결제요청 파라미터

결제 요청

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

method(10byte)

결제수단 ALL(모두), CARD(신용카드), BANK(계좌이체), VACNT(가상계좌)중 하나 선택

mId(10byte)

상점 아이디

amount(15byte)

거래 금액

orderId(40byte)

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

orderName(100byte)

상품명

customerName(30byte)

구매자명

cpCd(4byte)

은행 코드

ediDate(14byte)

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

hashString

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

trxCd(1byte)

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

customerMobilePhone(20byte)

구매자 연락처

customerEmail(60byte)

구매자 이메일 주소

ordIp(20byte)

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

lmtDay(8byte)

입금 기한

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

crctReqType(1byte)

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

crctPubType(2byte)

현금 영수증 발급 타입 crctReqType 값이 1 또는 2일 경우 필수 1: 카드번호 3: 사엽자등록번호 4: 휴대폰 번호

crctId(20byte)

현금 영수증 발급 번호 crctReqType 값이 1 또는 2일 경우 필수, 현금 영수증 발급 번호(숫자만 허용)

goodsSplAmt(15byte)

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

goodsVat(15byte)

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

goodsSvsAmt(15byte)

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

connCd(4byte)

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

escwAuthTypeCd(1byte)

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

escwAuthNo(20byte)

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

가상계좌 채번 결과 응답

resultCd(4byte)

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

resultMsg(100byte)

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

tid(30byte)

인증 거래번호

mId(10byte)

상점 아이디

method(2byte)

지불수단 (결제방식) 01 : 카드결제 02 : 실시간 계좌이체 03 : 가상계좌 (무통장 입금)

spmCd(2byte)

서브 결제 수단 코드 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)

발급 카드사명

bankCd(4byte)

은행 코드

vacntNo(20byte)

가상계좌 번호

lmtDay(8byte)

입금 기한

crctReqType(1byte)

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

Previous가상계좌 Next환불/채번 취소

Last updated 1 year ago

결제요청 파라미터

결제 요청

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

method(10byte)

결제수단 ALL(모두), CARD(신용카드), BANK(계좌이체), VACNT(가상계좌)중 하나 선택

mId(10byte)

상점 아이디

amount(15byte)

거래 금액

orderId(40byte)

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

orderName(100byte)

상품명

customerName(30byte)

구매자명

cpCd(4byte)

은행 코드

ediDate(14byte)

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

hashString

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

trxCd(1byte)

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

customerMobilePhone(20byte)

구매자 연락처

customerEmail(60byte)

구매자 이메일 주소

ordIp(20byte)

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

lmtDay(8byte)

입금 기한

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

crctReqType(1byte)

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

crctPubType(2byte)

현금 영수증 발급 타입 crctReqType 값이 1 또는 2일 경우 필수 1: 카드번호 3: 사엽자등록번호 4: 휴대폰 번호

crctId(20byte)

현금 영수증 발급 번호 crctReqType 값이 1 또는 2일 경우 필수, 현금 영수증 발급 번호(숫자만 허용)

goodsSplAmt(15byte)

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

goodsVat(15byte)

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

goodsSvsAmt(15byte)

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

connCd(4byte)

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

escwAuthTypeCd(1byte)

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

escwAuthNo(20byte)

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

가상계좌 채번 결과 응답

resultCd(4byte)

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

resultMsg(100byte)

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

tid(30byte)

인증 거래번호

mId(10byte)

상점 아이디

method(2byte)

지불수단 (결제방식) 01 : 카드결제 02 : 실시간 계좌이체 03 : 가상계좌 (무통장 입금)

spmCd(2byte)

서브 결제 수단 코드 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)

발급 카드사명

bankCd(4byte)

은행 코드

vacntNo(20byte)

가상계좌 번호

lmtDay(8byte)

입금 기한

crctReqType(1byte)

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