삼성페이 간편결제 (결제창 방식)
삼성페이 간편결제는 삼성 갤럭시 기기에서 등록된 카드로 빠르게 결제하는 서비스입니다.
테스트용 키 정보
API 정보
POST/card/cardDirect.do
Content-Type
application/x-www-form-urlencoded테스트
https://tbnpg.settlebank.co.kr/card/cardDirect.do운영
https://npg.settlebank.co.kr/card/cardDirect.do주의 사항
NOTE
삼성페이 이용 환경
삼성페이는 삼성 갤럭시 기기에서만 이용 가능합니다. PC 환경에서는 QR코드 결제를 지원합니다.
요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
필수 파라미터
└mchtIdAN(10)영문+숫자, 최대 10byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
└methodAN(20)영문+숫자, 최대 20byte*결제 구분 코드
결제 구분 코드
*고정값
└cardGbAN(4)영문+숫자, 최대 4byte*삼성페이 카드사 코드
삼성페이 카드사 코드
*삼성페이: SSP (고정값)
└trdDtN(8)숫자, 최대 8byte*요청일자 (yyyyMMdd)
요청일자 (yyyyMMdd)
└trdTmN(6)숫자, 최대 6byte*요청시간 (HH24MISS)
요청시간 (HH24MISS)
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유 주문번호 (한글 제외)
상점에서 생성하는 고유 주문번호 (한글 제외)
└mchtNameAHN(100)영문+한글+숫자, 최대 100byte*상점한글명
상점한글명
└mchtENameAN(100)영문+숫자, 최대 100byte*상점영문명
상점영문명
└pmtPrdtNmAHN(128)영문+한글+숫자, 최대 128byte*결제상품명
결제상품명
└trdAmtN(12)숫자, 최대 12byte*
AES-256AES-256/ECB/PKCS5Padding + Base64거래금액거래금액
└notiUrlAN(250)영문+숫자, 최대 250byte*결제 후 결과 전달되는 페이지의 URL (Server To Server 연동 URL)
결제 후 결과 전달되는 페이지의 URL (Server To Server 연동 URL)
└nextUrlAN(250)영문+숫자, 최대 250byte*결제 결과 화면으로 전환되는 URL
결제 결과 화면으로 전환되는 URL
*결제창 내 버튼 클릭 시 리다이렉트 됩니다. outStatCd 값으로 결제 성공(0021)/실패(0031) 여부를 확인하세요.
└cancUrlAN(250)영문+숫자, 최대 250byte*고객이 결제창의 X 버튼 클릭 시 리다이렉트 되는 URL
고객이 결제창의 X 버튼 클릭 시 리다이렉트 되는 URL
*브라우저 종료, 뒤로가기 등은 감지되지 않습니다.
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
NOTE
해쉬 생성 조합
mchtId + method + mchtTrdNo + trdDt + trdTm + trdAmt(평문) + hashKey
선택 파라미터
└mchtCustNmAHN(30)영문+한글+숫자, 최대 30byte
AES-256AES-256/ECB/PKCS5Padding + Base64고객명고객명
└mchtParamAHN(4000)영문+한글+숫자, 최대 4000byte상점 예약 필드 (결과 전달시 그대로 return)
상점 예약 필드 (결과 전달시 그대로 return)
└emailAN(60)영문+숫자, 최대 60byte
AES-256AES-256/ECB/PKCS5Padding + Base64이메일 주소이메일 주소
└prdtTermN(14)숫자, 최대 14byte상품제공기간 (yyyyMMddHHmmss). 값이 없으면 일반결제로 표기
상품제공기간 (yyyyMMddHHmmss). 값이 없으면 일반결제로 표기
└mchtCustIdAN(50)영문+숫자, 최대 50byte
AES-256AES-256/ECB/PKCS5Padding + Base64상점 고객아이디상점 고객아이디
└taxTypeCdA(1)영문, 최대 1byte면세여부. 공백일 경우 상점 설정에 따름
면세여부. 공백일 경우 상점 설정에 따름
N: 과세 Y: 면세 G: 복합과세└taxAmtN(12)숫자, 최대 12byte
AES-256AES-256/ECB/PKCS5Padding + Base64과세금액 (복합과세일 경우 필수)과세금액 (복합과세일 경우 필수)
└vatAmtN(12)숫자, 최대 12byte
AES-256AES-256/ECB/PKCS5Padding + Base64부가세금액 (복합과세일 경우 필수)부가세금액 (복합과세일 경우 필수)
└taxFreeAmtN(12)숫자, 최대 12byte
AES-256AES-256/ECB/PKCS5Padding + Base64비과세금액 (복합과세일 경우 필수)비과세금액 (복합과세일 경우 필수)
└svcAmtN(12)숫자, 최대 12byte
AES-256AES-256/ECB/PKCS5Padding + Base64봉사료봉사료
└instmtMonN(2)숫자, 최대 2byte할부개월수
할부개월수
00: 일시불 02~12: 해당 개월수└appSchemeAN(100)영문+숫자, 최대 100byte앱스키마 (AppScheme://~) 형식. 자체앱을 구축하는 경우 사용
앱스키마 (AppScheme://~) 형식. 자체앱을 구축하는 경우 사용
└custIpAN(15)영문+숫자, 최대 15byte고객 IP주소. 상점 서버의 IP가 아닌, 고객 기기의 IP주소. IPv4 형식으로 입력 (IPv6 불가)
고객 IP주소. 상점 서버의 IP가 아닌, 고객 기기의 IP주소. IPv4 형식으로 입력 (IPv6 불가)
응답 파라미터
결제 완료 또는 실패 시 nextUrl로, 고객이 결제창 내 X 버튼을 클릭하면 cancUrl로 리다이렉트되며 아래 파라미터가 전달됩니다. 브라우저 종료 및 뒤로가기는 감지되지 않습니다.
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└mchtIdAN(10)영문+숫자, 최대 10byte*상점아이디
nxca_jt_il상점아이디
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
0021거래상태코드
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드. 거래상태가 '0031'일 경우 상세 코드 전달
0000거절코드. 거래상태가 '0031'일 경우 상세 코드 전달
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*결과메시지 (URL Encoding, UTF-8)
정상적으로 처리되었습니다.결과메시지 (URL Encoding, UTF-8)
└methodAN(20)영문+숫자, 최대 20byte*결제수단
card결제수단
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점 주문번호
SAMSUNGPAY20211231100000상점 주문번호
└mchtCustIdAN(50)영문+숫자, 최대 50byte
AES-256AES-256/ECB/PKCS5Padding상점 고객아이디HongGilDong상점 고객아이디
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜 거래번호
STFP_PGCAnxca_jt_il0211129135810M1494620헥토파이낸셜 거래번호
└trdAmtN(12)숫자, 최대 12byte*
AES-256AES-256/ECB/PKCS5Padding거래금액1000거래금액
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└billKeyAN(50)영문+숫자, 최대 50byte삼성페이 빌키
SBILL_0123456789삼성페이 빌키
*영업 담당자를 통해 별도 신청 필요
└mchtParamAHN(4000)영문+한글+숫자, 최대 4000byte요청으로 받은 필드값을 응답으로 Bypass
name=HongGilDong&age=25요청으로 받은 필드값을 응답으로 Bypass
└authDtN(14)숫자, 최대 14byte승인일시
20211231100000승인일시
└authNoN(15)숫자, 최대 15byte승인번호
30001234승인번호
└intMonN(2)숫자, 최대 2byte할부개월수
00할부개월수
└fnNmAH(20)영문+한글, 최대 20byte카드사명
삼성카드카드사명
└fnCdAN(4)영문+숫자, 최대 4byte카드사코드
SSC카드사코드
노티 전문 (결과통보)
결제 완료 후 헥토파이낸셜에서 가맹점으로 노티(결과통보)가 전송됩니다.
NOTE
노티 전문 확인
삼성페이 결제 결과통보는 신용카드 노티 전문과 동일한 형식으로 전송됩니다. 신용카드 노티 전문 문서를 참고하세요.
