결제 승인

본 페이지에서는 결제 승인 요청에 대해 설명합니다. 결제창 연동을 통해 인증 결과를 수신 받았다면 승인 요청을 진행해 주셔야 합니다.

결제 승인 호출 데이터 예시

# 결제 승인 API 호출 예시
Method : POST
Content-Type : application/json

{
    "nonce": "cpxczte60av3x20230913170406555",
    "tid": "123121234m0101230913a283fae003",
    "ediDate": "20230913170406",
    "mId": "123121234m",
    "amount" : "1004",
    "mbsReserved": "MallReserved",
    "hashString": "C54758756558BB9E6AA6FAAA67F121F180882D035788FE7066C466A238681762",
    "payData":     
}

결제 승인 파라미터

결제 승인 요청

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

전문 번호

인증 거래번호

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

상점 아이디

결제 금액

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

결제 정보 암호화 데이터

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

결제 승인 응답 (공통)

인증 거래번호

상점아이디

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

서브 결제 수단 코드 01 : 고정

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

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

상품명

결제 금액

구매자명

상점 예약 필드에 셋팅한 값

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

결제일 형태 : yyyyMMdd 예시) 20230914

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

결제 승인 응답 (신용카드)

발급 카드사명

카드 번호

승인 번호

카드 할부개월 할부 기간(예: 00, 02, 03, …, 12, 두자리)

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

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

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

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

결제 승인 응답 (계좌이체)

은행명

은행 코드

계좌이체 승인 번호

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

결제 승인 응답 (가상계좌)

은행

은행 코드

가상계좌 번호

입금 기한 형태 : yyyyMMdd 예시) 20230914

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

승인 요청 후 결제 승인응답(responseBody)을 받아 가맹점 내부 처리(DB 저장 등)를 합니다. 승인 응답은 결제수단에 따라 상이하며, 승인 실패 시에는 실패에 따른 데이터만 전송됩니다.

결과 데이터는 추가될 수 있으며, 순서는 변동될 수 있습니다.

PreviousAPI 연동 Next결제 취소

Last updated 1 year ago

결제 승인

본 페이지에서는 결제 승인 요청에 대해 설명합니다. 결제창 연동을 통해 인증 결과를 수신 받았다면 승인 요청을 진행해 주셔야 합니다.

결제 승인 호출 데이터 예시

# 결제 승인 API 호출 예시
Method : POST
Content-Type : application/json

{
    "nonce": "cpxczte60av3x20230913170406555",
    "tid": "123121234m0101230913a283fae003",
    "ediDate": "20230913170406",
    "mId": "123121234m",
    "amount" : "1004",
    "mbsReserved": "MallReserved",
    "hashString": "C54758756558BB9E6AA6FAAA67F121F180882D035788FE7066C466A238681762",
    "payData":     
}

결제 승인 파라미터

결제 승인 요청

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

nonce(30byte)

전문 번호

tid(30byte)

인증 거래번호

ediDate(14byte)

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

mId(10byte)

상점 아이디

amount(15byte)

결제 금액

hashString

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

payData

결제 정보 암호화 데이터

mbsReserved(500byte)

상점 예약 필드에 셋팅한 값

결제 승인 응답 (공통)

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)

발급 카드사명

cardNo(20byte)

카드 번호

appNo(20byte)

승인 번호

appCardCd(2byte)

카드 발급사 코드

acqCardCd(2byte)

카드 매입사 코드

quotaMon(2byte)

카드 할부개월 할부 기간(예: 00, 02, 03, …, 12, 두자리)

noIntFlg(1byte)

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

pointFlg(1byte)

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

cardTypeCd(2byte)

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

chkcardFlg(1byte)

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

ezpAuthCd(2byte)

간편 결제사 코드, 간편결제인 아닌 경우 공백

결제 승인 응답 (계좌이체)

fnNm(20byte)

은행명

bankCd(4byte)

은행 코드

appNo(20byte)

계좌이체 승인 번호

crctReqType(1byte)

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

결제 승인 응답 (가상계좌)

fnNm(20byte)

은행

bankCd(4byte)

은행 코드

vacntNo(20byte)

가상계좌 번호

lmtDay(8byte)

입금 기한 형태 : yyyyMMdd 예시) 20230914

crctReqType(1byte)

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

결과 데이터는 추가될 수 있으며, 순서는 변동될 수 있습니다.

PreviousAPI 연동 Next결제 취소

Last updated 1 year ago