마스터 필드

이 장에는 PCINS e- Payment취소 메시지를 기술하고 있습니다.

1. PeP1 Record
PeP1 record내용은 거래 내용에 따라 달라진다.
예를 들어, 카드발급날짜의 시작 번호를 가지고 있지 않은 경우,
이 필드는 PeP1 record에 포함될 필요가 없다.
remote system에서 PCINS host에 전송된 기록은 HTML을 사용하여 기술한다.
확정된record의 레이아웃은 순서에 상관이 없다.
필드는 HTML address body어디에 있어도 상관없다.
Response는 반드시 XML을 사용해야 한다.

---

2. Master Field Format

No	Field Name	Field Description	Size(byte)	Type Attribute	Condition
1	“?”	리퀘스트 시작	1	a	M
2	erst	메시지 스테이지	3	a	O
3	ver	“100”	3	n	M
4	merchantId	가맹점ID	10	a	M
5	merchantPwd	가맹점 패스워드	<16	a	M
6	mid	가맹점MID	10	a	M
7	ref	거래코드	<60	a	M
8	tradeGubun	거래구분	1	a	M
9	currType	거래통화	3	a	M
10	price	거래금액(반각)	<12	n	M
11	shop	가맹점이름	<255	a	O
12	payName	구매자이름（영어）	<25	a	M
13	paynameJP	구매자이름（일본어）	<30	a	O
14	cardNo	카드번호(半角)	<16	n	M
15	expireM	카드만료월(半角)	2	n	M
16	expireY	카드만료년(半角)	2	n	M
17	csc	카드보안코드(半角)	<4	n	O
18	cardType	카드종류 코드	3	a	O
19	payId	구매자ID	<20	a	O
20	payEmail	구매자 e-mail	<50	a	O
21	payTel	구매자 전화번호	<30	a	O
22	payAddr	구매자 주소	<100	a	O
23	payPostal	구매자 우편번호	<10	a	O
24	productName	상품명	<50	a	O
25	charset	언어코드	<10	a	O
26	lang	언어	2	a	O
27	transCode	거래상태코드	2	a	M
28	transNo	거래번호	<20	a	M
29	transTime	거래일시	14	n	M
30	errCode	에러코드	3	a	M
31	errMsg	에러 메시지	<50	a	M
32	approvalNo	승인코드	<8	a	M
33	transMsg	거래 메시지	<50	a	M
34	resultCode	결제결과코드	3	a	M
35	resultMsg	결제결과 메시지	<100	a	M
36	firstPrice	계속과금최초결제금액(半角)	8	n	C
37	sincePrice	계속과금 2회이상 금액(半角)	8	n	C
38	regularId	계속과금발행ID	100	a	C
39	regularPwd	계속과금발행패스워드	100	a	C
40	returnURL	화면전환URL	<1000	a	M
41	callbackURL	결제결과통지URL	<1000	a	M
42	referURL	결제페이지URL	<1000	a	C
43	transStaus	거래조회 상태	1	n	O
44	tradeInfo	결제추가정보	<6000	a	C

---

3. Field Content

1. “?”(리퀘스트 시작)
   “?” (Request Start) 은 PeP1 record의 시작을 알려주는 기호이다.
   PCINS URL뒤에 표기한다.

---

2. erst(메시지 스테이지)
   erst 은、메시지 스테이지를 가리키는 값이 들어있다.

값	정의
logon	Logon Stage
aures	Confirmation stage
logoff	Logoff Stage

---

3. ver(interface version)
   PeP1 current version “100”

---

4. merchantId(가맹점ID)
   merchantId 는 PCINS Host Management Information서비스를 사용하여 유효성 검사 및 정산을 지원하기 위해 PCINS에서 지정한 가맹점 로그인 ID를 기록한다. 대문자 소문자 모두 사용 가능.

---

5. merchantPwd(가맹점 패스워드)
   merchantPwd 는 PCINS에서 지정한 가맹점 패스워드를 입력한다.

---

6. mid(가맹점MID)
   mid 는 거래진행을 위해 PCINS Host가 은행에 연결하기 위해 할당된 가맹점 ID를 기록한다.

---

7. ref(거래코드)
   ref 원트랜잭션번호를 기록하고, 다음 거래 수요를 위해 유일하게 host 에 저장되어있는 증거다. 대소문자 모두 사용가능. 요구가 없을 때는 필드를 비워둔다.

• 주의
  개발자는 HTML을 사용하여 정확하게 encode하여 데이터 전송에 주의하십시오.

---

8. tradeGubun(거래구분)
   tradeGubun 은 거래구분을 기록한다. 다음 값들이 들어있다.

값	정의
1	판매（온라인 승인）
2	환불
7	확인
9	거래조회
11	계속과금 등록
12	계속과금 해지

---

9. currType(거래통화)
   currType 는 거래금액에 적용되는 통화코드를 기록한다.

값	정의
JPY	Japanese Yen
USD	US Dollar
EUR	Euro
KRW	Korean Won

---

10. price(거래금액)
    price은 거래금액을 기록한다.

• 주의
  JPY금액은 소수점을 허용하지 않는다. USD금액은 소수점 2자리까지 허용한다.

---

11. shop(가맹점 명)

---

12. payName(구매자이름（영문）)

---

13. paynameJP(구매자이름（일본어）)

---

14. cardNo(카드번호)
    cardNo는 카드번호를 기록한다. 이 번호는 거래상황을 확인하는 과정에 사용한다.
    스피드결제는 카드번호를 다음 경우에 지정한다.

값	정의
8888888888888888	merchantId＋전화번호＋payId 에 신용카드정보를 검색한다.
8888888888888881	merchantId＋전호번호에 신용카드 정보를 검색한다.
8888888888888882	merchantId + payId에 신용카드정보를 검색한다.

---

15. expireM (카드유효월)
    expireM 은 카드유효기한(월)을 기록한다.

• 주의
  요구형식은 MM이다.
  10이하의 경우 0을 반드시 포함한다(01,02,03…)

---

16. expireY (카드유효년)
    expireY 은 카드유효기한(년)을 기록한다.

• 주의
  요구형식은 YY이다.
  10이하의 경우 0을 반드시 포함한다(01,02,03…)

---

17. csc(카드 보안 코드)
    csc는 카드 소유자임을 증명하기 위해 사용되는CSC (Card Security Code) 와Address Verification System (AVS) 을 표시한다.

---

18. cardType (카드 종류 코드)
    cardType 은 카드종류별코드를 기록한다. 다음 값들이 들어있다.

값	정의
AMX	American Express
JCB	Japanese Credit Bank
MSC	MasterCard
VIS	VISA

---

19. payId
    payId 은 가맹점이 관리하는 화원아이디를 기록한다.

• 주의
  데이터 형식에는 알파벳과 숫자만 허용한다.

---

20. payEmail
    구매자 Email주소

---

21. payTel
    구매자의 전화번호

---

22. payAddr
    구매자의 주소

---

23. payPostal
    구매자의 우편번호

---

24. productName
    상품명

---

25. charset(언어코드)
    charset 은 디폴트 값은 UTF-8이다.

값	정의
UTF-8	Global
SHIFT-JIS	Japanese
EUC-KR	Korean

---

26. lang(언어)

값	정의
JP	Japanese
EN	English
CN	Chinese

---

27. transCode(거래상태코드)

값	정의
AS	승인성공
AF	승인실패

---

28. transNo(거래번호)
    transNo 은 유일하게 지정된 거래 key를 기록하고 거래 요청에 대한 추가 데이터를 검색하기 위해 반드시 제출한다.

---

29. transTime(거래일시)
    transTime 은 거래 시간과 일을 기록한다.

• 주의
  요구 형식은 YYYYMMDDHHMMSS 이다.

---

30. errCode(에러코드)
    errCode 는 거래 상태를 코드로 표시하여 기록한다.

• 주의
  Appendix Error code 참조하십시오.

---

31. errMsg(에러 메시지)
    errMsg 는 거래실패 이유를 기록한다.

• 주의
  Appendix Error code 참조해 주십시오.

---

32. approvalNo(승인코드)
    approvalNo 은 승인된 거래에 대해 승인기관에서 제공하는 국제표준 코드를 기록한다.

---

33. transMsg(거래 메시지)

---

34. resultCode(결제결과코드)
    resultCode는 결제결과를 코드로 표시하여 기록한다.
    Non-UI에서 사용한다.

• 주의
  Appendix Error code 참조해 주세요.

---

35. resultMsg (결제 결과 메시지)
    Non-UI에서 사용한다.

---

36. firstPrice (계속과금 최초 결제 금액)

---

37. sincePrice (계속과금 2회 이상 결제 금액)

---

38. regularId (계속과금발행ID)
    regularId는 해지할 때 사용한다.

---

39. regularPwd (계속과금발행 패스워드)
    regularPwd는 해지할 때 사용한다.

---

40. returnURL (화면전환URL)
    UI결제로 결제가 끝나고 가맹점 화면으로 전환되는 URL이다.

---

41. callbackURL (결제결과 통지URL)
    UI결제로 결제가 끝나고 가맹점 화면에 결제정보가 통지되는 URL이다.
    화면보안설정에서 61.74.60.18、61.74.60.19 IP연결만 허용한다.
    파라메터는 POST방식으로 보낸다.

---

42. referURL (결제페이지URL)
    UI결제를 시도하는 결제페이지 또는 홈페이지 주소 URL이다.

---

43. transStaus (거래조회상태)

값	정의
1	판매
2	환불

---

44. tradeInfo (결제추가정보)
    qrServiceType 값에 따라 정보를 차등적용하며,
    각 결제라인 별 데이터 정의표에 따라 값을 입력하여 전달한다.
    자세한 사항은 QR결제(UI) 챕터에서 설명한다.

---