Search
🧾

현금영수증 발행 (계좌)

이 글의 목차

1. 정의

계좌이체로 결제가 발생한 거래의 현금영수증을 개별적으로 발행하는 API입니다.
1. 결제금액을 초과한 금액을 현금영수증 발행할 수 없습니다. 2. 이미 현금영수증 발행이 완료된 거래건에 현금영수증을 추가로 발행할 수 없습니다.

2. 프로세스 개요

3. 파트너 인증

파트너 서버

Request Message

파라미터 정보
Search
Parameter
더 알아보기
Type
Length
Parameter value
Reference
custKey
Open
String
255
abcd1234567890
파트너 인증키
PCD_PAY_WORK
Open
String
20
TSREG
현금영수증 발행용 Parameter
COUNT3
Request sample
/* * TEST : https://democpay.payple.kr/php/auth.php * REAL : https://cpay.payple.kr/php/auth.php */ POST /php/auth.php HTTP/1.1 Host: democpay.payple.kr Content-Type: application/json Cache-Control: no-cache referer: https://파트너사 도메인 /* ※ referer 설정 방법 * REAL : referer에는 파트너사 도메인으로 등록된 도메인을 넣어주셔야합니다. * 다른 도메인을 넣으시면 [AUTH0004] 에러가 발생합니다. */ { "cst_id": "test", "custKey": "abcd1234567890", "PCD_PAY_WORK": "TSREG" }
JSON
PHP 샘플코드
JAVA 샘플코드
NODE 샘플코드

Response Message

파트너 인증이 성공하면 페이플에서 파트너에 다음과 같은 성공 리턴을 드립니다.
파라미터 정보
Search
Parameter
더 알아보기
Parameter value
Reference
server_name
Open
democpay.payple.kr
파트너 인증시 페이플의 요청 URL
result
Open
success
결과확인
result_msg
Open
사용자 인증 완료!!
결과메세지
cst_id
Open
UFVNNVZpZk4reWo5UFRualUwcGV4dz09
파트너 ID
custKey
Open
T3JzRkp5L1FTcEFDa1FQdHo5Um1UZz09
파트너 Key
AuthKey
Open
a688ccb3555c25cd722483f03e23065c3d0251701ad6da895eb2d830bc06e34d
파트너 인증토큰
PCD_PAY_HOST
Open
https://democpay.payple.kr
결제요청 도메인
PCD_PAY_URL
Open
<return_uri>
결제요청 URI *고정값으로 사용하지 않기를 권장합니다.
return_url
Open
<return full uri>
결제요청 URI (PCD_PAY_HOST + PCD_PAY_URL) *고정값으로 사용하지 않기를 권장합니다.
COUNT9
Response sample
{ "server_name" : "요청 URL" "result" : "결과확인" "result_msg" : "결과 메시지" "cst_id" : "파트너사 아이디" "custKey" : "파트너사 키" "AuthKey" : "파트너사 인증토큰", "PCD_PAY_HOST" : "요청 도메인, (예: https://democpay.payple.kr)" "PCD_PAY_URL" : "요청 URL, (예: /auth.php)" "return_url" : "요청 URL (PCD_PAY_HOST + PCD_PAY_URL)" }
JSON
실패 리턴 (result = error)을 받으신 경우, result_msg 의 응답코드를 확인하고 잘못된 부분을 수정합니다. 응답코드 리스트는 이 곳 에서 확인하실 수 있습니다.

4. 현금영수증 발행 요청

파트너 서버
파트너는 파트너 인증 완료 후 현금영수증 발행 요청을 수행합니다.
이때 파트너 인증 후 Response 받은 cst_id, custKey, AuthKey 값을 각각 PCD_CST_ID, PCD_CUST_KEY, PCD_AUTH_KEY 에 넣어 요청을 보냅니다.
파트너 인증 후 Response 받은 cst_id, custKey,AuthKey 값은 고정값이 아니므로 저장해놓고 계속해서 사용하면 안됩니다. + 한 번의 파트너 인증과 하나의 요청이 매칭되어야 합니다. 즉 한 번의 파트너 인증으로 받은 cst_id, custKey,AuthKey 값을 여러 요청에 사용하면 안됩니다.

Request Message

현금영수증 발행_필수
Search
Parameter
더 알아보기
Type
Length
Parameter value
Reference
PCD_CST_ID
Open
String
255
UFVN...
파트너 인증 후 리턴 받은 cst_id Token
PCD_CUST_KEY
Open
String
255
T3Jz...
파트너 인증 후 리턴 받은 custKey Token
PCD_AUTH_KEY
Open
String
255
a688c...
파트너 인증 후 리턴 받은 인증 AuthKey Token
PCD_PAYER_ID
Open
String
255
VEJMT0F...
카드/계좌등록 후 리턴 받은 빌링키
PCD_PAY_OID
Open
String
255
test0688133500162
주문번호
PCD_TAXSAVE_AMOUNT
Open
Number
-
1000
현금영수증 발행요청 금액
COUNT6
선택 파라미터 정보
Search
Parameter
더 알아보기
Type
Length
Parameter value
Reference
PCD_TAXSAVE_TRADEUSE
Open
String
-
personal
현금영수증 발행 구분 personal=소득공제, company=지출증빙 (미입력시 결제내역 정보 이용)
PCD_TAXSAVE_IDENTINUM
Open
String
-
01012345678
현금영수증 발행대상 번호 (미입력시 결제내역 정보 이용)
COUNT2
Request sample
#현금영수증 발행요청 POST 파트너 인증 후 리턴받은 PCD_PAY_URL HTTP/1.1 Host: 파트너 인증 후 리턴받은 PCD_PAY_HOST Content-Type: application/json Cache-Control: no-cache { "PCD_CST_ID": "파트너 인증 후 리턴받은 cst_id", "PCD_CUST_KEY": "파트너 인증 후 리턴받은 custKey", "PCD_AUTH_KEY": "파트너 인증 후 리턴받은 AuthKey", "PCD_PAYER_ID": "NS9qNTgzU2xRNHR2...", "PCD_PAY_OID": "test201804000001", "PCD_TAXSAVE_AMOUNT": "1000" }
JSON

Response Message

파라미터 정보
Search
Parameter
더 알아보기
Parameter value
Reference
PCD_PAY_RST
Open
success
요청 결과 (success, error)
PCD_PAY_CODE
Open
TSRG0000
현금영수증 발행완료 코드
PCD_PAY_MSG
Open
현금영수증 발행완료
요청 결과 메시지
PCD_PAY_WORK
Open
TSREG
현금영수증 발행 결과 메시지 (현금영수증 발행 완료|실패)
PCD_PAYER_ID
Open
d0tojkj43kjb3knsl3
등록 후 리턴받은 빌링키
PCD_PAY_OID
Open
test099942200156938
주문번호
PCD_TAXSAVE_AMOUNT
Open
1000
현금영수증 발행 금액
PCD_TAXSAVE_MGTNUM
Open
G..
현금영수증 국세청 발행번호
Response sample
{ "PCD_PAY_RST" : "success" "PCD_PAY_CODE" : "TSRG0000" "PCD_PAY_MSG" : "현금영수증 발행완료" "PCD_PAY_WORK" : "TSREG" "PCD_PAYER_ID" : "NS9qNTgzU2xRNHR2RmFBWWFBTWk5UT09" "PCD_PAY_OID" : "test201804000001" "PCD_REGULER_FLAG" : "N" "PCD_TAXSAVE_AMOUNT" :> "1000" "PCD_TAXSAVE_MGTNUM" : "G.." }
JSON
PCD_PAY_RST = success, PCD_PAY_CODE = "0000"이 포함될 경우 요청성공으로 판단합니다. PCD_PAY_RST = error 일 경우 요청실패로 판단합니다.
실패 리턴(PCD_PAY_RST = error )을 받으신 경우, PCD_PAY_CODE 의 응답코드를 확인하고 잘못된 부분을 수정합니다. 응답코드 리스트는 이 곳 에서 확인하실 수 있습니다.