본문으로 건너뛰기

거래 등록

결제 화면 호출을 하기 위해 주문정보를 등록하고 결제창 호출 URL을 응답으로 받을 수 있습니다.

요청​

요청 URL
POST https://{API 도메인}/easytalkpay/v1/orders.do
Content-type: application/json; charset=euc-kr
참고

API 멱등성 지원 대상 (API 멱등성 참조)

파라미터​

필드명타입길이필수여부설명
vanTidString8Byte✅VAN 터미널 ID
shopTransactionIdString60Byte✅상점 거래고유번호 (API 멱등성 키)
shopReqDateString14Byte✅요청일시(yyyyMMddHHmmss)
inflowPathString30Byte✅결제 유입경로 "SHP" 고정
shopOrderNoString40Byte✅상점 주문번호 반드시 Unique 값으로 생성
productNmString500Byte✅상품명
amountNumber✅총 결제금액(부가세 포함 금액)
taxNumber✅부가세 비과세일 경우 0원
returnUrlString1000Byte✅인증 완료 후 이동할 URL
completeUrlString1000Byte네이버페이 전용 승인완료 후 이동할URL
네이버페이 가이드
mallNmString200Byte✅상점명
bussNoString10Byte✅상점 사업자번호(숫자만 허용)
noticeMsgString3000Byte가맹점 안내 메시지로 결제창에 노출되는 메시지
요청 예시
{  
"vanTid": "{VAN 터미널ID}",
"shopReqDate": "20230915121212",
"shopTransactionId": "{API 멱등성 키}",
"inflowPath": "SHP",
"shopOrderNo": "GDS30004",
"productNm": "5월 학원비",
"amount": 47000,
"tax": 4700,
"returnUrl": "{인증완료 시 돌아갈 상점 URL}",
"completeUrl": "{네이버페이 승인완료 시 돌아갈 상점 URL}",
"mallNm": "일타수학",
"bussNo": "1178119949",
"noticeMsg": "안녕하세요. 일타수학 입니다. 홍길동학생 5월 학원비 납부입니다."
}

응답​

파라미터​

필드명타입길이설명
resCdString4Byte결과코드(정상 : “0000”)
resMsgString1000Byte결과 메시지
shopTransactionIdString60Byte전송한 값 그대로 사용
authPageUrlString256Byte결제창 호출 URL
응답 예시
{
"resCd": "0000",
"resMsg": "정상처리",
"shopTransactionId": "{전송한 값 그대로 사용}",
"authPageUrl": "{결제창 호출 URL}"
}