거래 등록

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

요청

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

참고

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

파라미터

필드명	타입	길이	필수여부	설명
vanTid	String	8Byte	✅	VAN 터미널 ID
shopTransactionId	String	60Byte	✅	상점 거래고유번호 (API 멱등성 키)
shopReqDate	String	14Byte	✅	요청일시(yyyyMMddHHmmss)
inflowPath	String	30Byte	✅	결제 유입경로 "SHP" 고정
shopOrderNo	String	40Byte	✅	상점 주문번호 반드시 Unique 값으로 생성
productNm	String	500Byte	✅	상품명
amount	Number		✅	총 결제금액(부가세 포함 금액)
tax	Number		✅	부가세 비과세일 경우 0원
returnUrl	String	1000Byte	✅	인증 완료 후 이동할 URL
completeUrl	String	1000Byte		네이버페이 전용 승인완료 후 이동할URL 네이버페이 가이드
mallNm	String	200Byte	✅	상점명
bussNo	String	10Byte	✅	상점 사업자번호(숫자만 허용)
noticeMsg	String	3000Byte		가맹점 안내 메시지로 결제창에 노출되는 메시지

요청 예시
{  
  "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월 학원비 납부입니다."
}

응답

파라미터

필드명	타입	길이	설명
resCd	String	4Byte	결과코드(정상 : “0000”)
resMsg	String	1000Byte	결과 메시지
shopTransactionId	String	60Byte	전송한 값 그대로 사용
authPageUrl	String	256Byte	결제창 호출 URL

응답 예시
{
  "resCd": "0000",
  "resMsg": "정상처리",
  "shopTransactionId": "{전송한 값 그대로 사용}",
  "authPageUrl": "{결제창 호출 URL}"
}

요청​

파라미터​

응답​

파라미터​

요청

파라미터

응답

파라미터