영수증 미리보기
모듈 연동
스마트로페이 결제모듈 연동을 위한 가이드입니다
해당 메뉴얼의 Parameter 들은 가맹점에 통보 없이 응답값이 추가 될 수 있습니다.
응답값 추가도 고려하여 개발 진행하시길 권장합니다 .
응답값 추가도 고려하여 개발 진행하시길 권장합니다 .
전표
Smartro PG 결제내역 확인 방법 입니다.
가맹점 상황에 따라 'URL을 통한 전표 출력' 또는 'API 조회를 통한 거래데이터 확인'
두 가지 방법으로 제공하고 있습니다. (가맹점 관리자 페이지를 통해서도 전표 확인이 가능합니다.)
가맹점 상황에 따라 'URL을 통한 전표 출력' 또는 'API 조회를 통한 거래데이터 확인'
두 가지 방법으로 제공하고 있습니다. (가맹점 관리자 페이지를 통해서도 전표 확인이 가능합니다.)
1. URL을 통한 전표 출력
거래 TID를 통해 조회 가능하며 팝업 등 가맹점 상황에 맞게 호출 해주세요
https://www.smilepay.co.kr/issue/IssueLoader.jsp?TID=[TID설정]&type=[type설정]
① TID : 스마트로 거래 ID
② type : 지불수단 타입[0 - 각 지불 수단(신용카드,휴대폰결제,계좌이체… 등), 2 - 현금영수증]
https://www.smilepay.co.kr/issue/IssueLoader.jsp?TID=[TID설정]&type=[type설정]
① TID : 스마트로 거래 ID
② type : 지불수단 타입[0 - 각 지불 수단(신용카드,휴대폰결제,계좌이체… 등), 2 - 현금영수증]
| 구분 | URL 예시 |
|---|---|
| 테스트 | https://test.smilepay.co.kr/issue/IssueLoader.jsp?TID=SMTPAY001m01012203101503424338&type=0 |
| 운영 | https://www.smilepay.co.kr/issue/IssueLoader.jsp?TID=smtauth01m01012203101417423544&type=0 |
2. API를 통한 전표데이터 요청
웹 브라우저를 통하여 직접 API를 호출하는 방식을 사용할 경우
apikey로 사용되는 MerchantKey가 외부에 노출되어 보안사고가 발생할 수 있으니 Server to Server 호출 방식으로 연동 바랍니다.
apikey로 사용되는 MerchantKey가 외부에 노출되어 보안사고가 발생할 수 있으니 Server to Server 호출 방식으로 연동 바랍니다.
Header 설정
| 필드 | INPUT | 설명 |
|---|---|---|
| Content-Type | application/json | 가맹점 요청 방식 |
| Accept | application/json | 응답 방식 |
| Accept-Charset | utf-8 | 응답 charset |
| apikey | ex. 0/4GFsSd7ERVRGX... | 스마트로 가맹점 서버 API KEY(mid의 merchantKey) |
요청 URL
| 구분 | 요청 URL |
|---|---|
| 테스트 | https://tapi.smilepay.co.kr/receipt |
| 운영 | https://api.smilepay.co.kr/receipt |
서비스 호출 예제
POST https://tapi.smilepay.co.kr/receipt
CONTENT-TYPE : application/json
ACCEPT : application/json
ACCEPT-CHARSET : UTF-8
APIKEY : {Mid의 merchantKey}
{
"mid":"Dpay00001m",
"tid": "Dpay00001m02012101041423347943"
}
응답
| 파라미터 | 항목명 | 길이(char) | 필수여부 | 상세설명 |
|---|---|---|---|---|
| tid | 거래번호 | 30 | Y | |
| moid | 주문번호 | 64 | Y | |
| stateCd | 승인취소 구분 | 1 | Y | |
| stateNm | 승인취소 구분명 | 10 | Y | |
| svcCd | 지불수단 코드 | 2 | Y | |
| svcNm | 지불수단명 | 10 | Y | |
| ordNm | 주문자명 | 30 | Y | |
| goodsNm | 상품명 | 40 | Y | |
| goodsAmt | 상품가격 | 12 | Y | |
| supplyAmt | 공급가 | 12 | N | 신용카드 |
| vatAmt | 부가세 | 12 | N | 신용카드 |
| svcAmt | 봉사료 | 12 | N | 신용카드 |
| appNo | 승인번호 | 10 | N | 신용카드 |
| appDt | 승인일자 | 8 | N | YYYYMMDD |
| appTm | 승인시간 | 6 | N | HHMMSS |
| ccNo | 취소승인번호 | 10 | N | |
| ccDt | 취소일자 | 8 | N | YYYYMMDD |
| ccTm | 취소시간 | 6 | N | HHMMSS |
| ccyCd | 통화코드 | 3 | N | 신용카드 |
| ccyNm | 통화코드명 | 3 | N | 신용카드 |
| cardNo | 카드번호 | 16 | N | 신용카드 |
| appCo | 발급사코드 | 2 | N | 신용카드 |
| appNm | 발급사명 | 10 | N | 신용카드 |
| instmntMon | 할부개월 | 2 | N | 신용카드 |
| fnNo | 카드사 가맹점번호 | 20 | N | 신용카드 |
| cardType | 카드 유형 | 2 | N | 01 : 개인, 02 : 법인 |
| cardCl | 신용체크 구분 | 1 | N | 0 : 신용, 1 : 체크 |
| bankCd | 은행 코드 | 3 | N | 가상계좌, 계좌이체 |
| bankCd | 은행명 | 10 | N | 가상계좌, 계좌이체 |
| acctNo | 계좌번호 | 10 | N | 계좌이체 |
| vacctNo | 가상계좌번호 | 10 | N | 가상계좌 |
| vacctBaseDt | 가상계좌 입금일 | 8 | N | YYYYMMDD 가상계좌 |
| vacctDueDt | 가상계좌 입금기한일 | 8 | N | YYYYMMDD 가상계좌 |
| cashReceiptReqCl | 현금영수증 발행구분 | 1 | N | 0 : 미발행, 1 : 발행 / 가상계좌, 계좌이체 |
| cashReceiptTid | 현금영수증 거래번호 | 30 | N | 가상계좌, 계좌이체 |
| cashReceiptType | 현금영수증 유형 | 30 | N | 1 : 소득공제, 2 : 지출증빙 / 현금영수증 |
| cashReceiptNo | 현금영수증 발급번호 | 10 | N | 소득공제(휴대폰), 지출증빙(사업자) / 현금영수증 |
| partCancelInfo | 부분취소정보 리스트 | N | ||
| transDt | 취소 일자 | 8 | N | YYYYMMDD |
| transTm | 취소 시간 | 6 | N | HHMMSS |
| transAmt | 부분취소 금액 | 12 | N | |
| transSupplyAmt | 부분취소 공급가 | 12 | N | |
| transVatAmt | 부분취소 부가세 | 12 | N | |
| transSvcAmt | 부분취소 봉사료 | 12 | N | |
| refundReqDt | 환불 등록 일자 | 8 | N | YYYYMMDD |
| refundReqTm | 환불 등록 시간 | 6 | N | HHMMSS |
| refundAmt | 환불 금액 | 12 | Y | |
| merchantInfo | 가맹점정보 리스트 | |||
| coNo | 사업자번호 | 10 | Y | |
| coNm | 사업자명 | 40 | Y | |
| bossNm | 대표자명 | 30 | Y | |
| bossNm | 가맹점명 | 100 | Y | |
| addr | 가맹점주소 | 220 | Y |