Search
🔎

결제결과 조회 (카드 / 계좌)

1. 정의

결제결과 조회란 거래건의 결제결과를 확인하는 기능입니다.
해당 기능은 결제결과가 Webhook으로 미수신 될 경우, 결제결과를 조회하는 용도로 활용할 수 있으며, Webhook으로 결제결과가 왔음에도 불구하고 다른 목적으로 요청하시면 안되니, 참고해주시기 바랍니다.
기타 사유로 결제결과를 수신받지 못하는 경우, 결제결과 조회API를 통해 결과값을 조회할 수 있습니다.
(스케쥴링등으로 복수건 결제결과 확인시 파트너인증은 단 1회로 30분안에 순차적으로 요청 바랍니다. 해당 규칙을 준수하기 어려우시면 사전 논의 부탁드립니다.)

2. 프로세스 개요

3. 파트너 인증

파트너 서버

Request Message

기본 보기
Search
파라미터 정보
Parameter
더 알아보기
Type
Length
Parameter value
Reference
custKey
Open
String
255
abcd1234567890
파트너 인증키
PCD_PAYCHK_FLAG
Open
String
1
Y
결제결과 조회용 Parameter
COUNT3
Request sample
Header 정보
/* * Request HTTP URL * TEST : https://democpay.payple.kr/php/auth.php * REAL : https://cpay.payple.kr/php/auth.php */ Request URL: "https://democpay.payple.kr/php/auth.php" HTTP Method: POST Content-Type: application/json Cache-Control: no-cache Referer: https://파트너사 도메인 /* ※ Referer 설정 방법 * REAL : referer에는 파트너사 도메인으로 등록된 도메인을 넣어주셔야합니다. * 다른 도메인을 넣으시면 [AUTH0004] 응답이 발생합니다. */
JSON
Referer에 대한 자세한 설명은 이곳에서 확인해보세요!
Body(Payload) 값
{ "cst_id": "test", "custKey": "abcd1234567890", "PCD_PAYCHK_FLAG": "Y" }
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
UFVNNVZ...
파트너 ID
custKey
Open
T3JzRkp5L...
파트너 Key
AuthKey
Open
a688ccb3555...
파트너 인증토큰
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) ※ 요청시 Request 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 ) - 해당 값의 유효기간은 30분입니다. - 한 번의 파트너 인증으로 유효기간(30분) 이내에 조회 요청을 보내셔야 합니다. - 매 조회요청마다 새로운 파트너 인증을 하지 않아도, 한 번의 파트너 인증 요청 후 받은 응답값으로 30분이내의 조회 요청건들은 모두 정상처리 됩니다. 즉, 최초 1회 파트너 인증 요청 후 Response 받은 인증토큰으로 조회 요청을 진행해주시길 바랍니다.

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...
파트너 인증 후 리턴 받은 인증 Token
PCD_PAYCHK_FLAG
Open
String
1
Y
결과조회 여부(Y, N)
PCD_PAY_TYPE
Open
String
20
card
결제수단(card, transfer)
PCD_PAY_OID
Open
String
255
test099942200156938
주문번호
PCD_PAY_DATE
Open
Number
8
20200320
거래건이 결제된 원거래일자
COUNT7
Request sample
Header 정보
/* * 결과조회 요청 * Request HTTP URL * ※파트너 인증 후 리턴받은 return_url로 설정해주세요. * (return_url = PCD_PAY_HOST + PCD_PAY_URL) * TEST : https://democpay.payple.kr/(파트너 인증 후 리턴 받은 요청 URL(PCD_PAY_URL)) * REAL : https://cpay.payple.kr/(파트너 인증 후 리턴 받은 요청 URL(PCD_PAY_URL)) */ Request URL: "https://democpay.payple.kr/(파트너 인증후 리턴받은 PCD_PAY_URL)" HTTP Method: POST Content-Type: application/json Cache-Control: no-cache Referer: http://localhost:8080
JSON
Body(Payload) 값
{ "PCD_CST_ID": "파트너 인증 후 리턴받은 cst_id" "PCD_CUST_KEY": "파트너 인증 후 리턴받은 custKey" "PCD_AUTH_KEY": "파트너 인증 후 리턴받은 AuthKey", "PCD_PAYCHK_FLAG": "Y", "PCD_PAY_TYPE": "card", "PCD_PAY_OID": "test201804000001", "PCD_PAY_DATE": "20200320" }
JSON

Response Message

기본 보기
Search
Parameter
더 알아보기
결제수단
Parameter value
Reference
PCD_PAY_RST
Open
카드
계좌
success
요청 결과(success, error)
PCD_PAY_CODE
Open
카드
계좌
PAYC0000
요청 결과코드
PCD_PAY_MSG
Open
카드
계좌
결제완료
요청 결과 메시지(결제완료, 실패 등)
PCD_PAY_OID
Open
카드
계좌
test099942200156938
주문번호
PCD_PAY_TYPE
Open
카드
계좌
card
결제수단 - 카드: card - 계좌이체: transfer
PCD_PAYER_ID
Open
카드
계좌
d0to...
카드 및 계좌 등록 후 리턴받은 빌링키
PCD_PAYER_EMAIL
Open
카드
계좌
dev@payple.kr
해당 이메일 주소로 결제 안내메일이 발송됩니다.
PCD_PAYER_NAME
Open
카드
계좌
홍길동
결제고객 이름
PCD_PAY_GOODS
Open
카드
계좌
상품1
상품명
PCD_PAY_TOTAL
Open
카드
계좌
1000
결제금액
PCD_PAY_ISTAX
Open
카드
계좌
Y
과세설정 (Default: Y 이며, 과세:Y, 복합과세:Y, 비과세: N) PCD_PAY_ISTAX : Y, PCD_PAY_TAXTOTAL : 공란이면, 페이플에서 10% 부가세를 자동으로 적용합니다.
PCD_PAY_TAXTOTAL
Open
카드
계좌
10
복합과세(과세+면세) 주문건에 필요한 금액이며 가맹점에서 전송한 값을 부가세로 설정합니다.과세 또는 비과세의 경우 사용하지 않습니다.
PCD_PAY_CARDNAME
Open
카드
BC카드
카드사명
PCD_PAY_CARDNUM
Open
카드
1111-****-****-2222
카드번호
PCD_PAY_CARDTRADENUM
Open
카드
2020031413203326920
거래 키
PCD_PAY_CARDAUTHNO
Open
카드
98123445
승인번호
PCD_PAY_CARDRECEIPT
Open
카드
https://www.danal..
매출전표 출력 링크
PCD_PAY_PAYMENT_TYPE
Open
카드
간편결제 | 앱카드
카드 세부 결제방식
PCD_PAY_BANK
Open
계좌
081
은행코드
PCD_PAY_BANKNAME
Open
계좌
KEB하나은행
은행명
PCD_PAY_BANKNUM
Open
계좌
123-********-021
계좌번호
PCD_PAY_TIME
Open
카드
계좌
2020-03-20 19:50:00
결제완료 시간
PCD_TAXSAVE_FLAG
Open
계좌
Y
현금영수증 발행여부 (발행: Y, 미발행: N)
PCD_TAXSAVE_RST
Open
계좌
Y
현금영수증 발행결과 (성공: Y, 실패: N) (PCD_TAXSAVE_FLAG : Y 일 때 응답)
PCD_TAXSAVE_MGTNUM
Open
계좌
G...
현금영수증 국세청 발행번호 (PCD_TAXSAVE_FLAG : Y 일 때 응답)
COUNT25
카드 응답 예시
Response sample
{ "PCD_PAY_RST": "success", "PCD_PAY_MSG": "결제완료", "PCD_PAY_OID": "test201804000001", "PCD_PAY_TYPE": "card", "PCD_PAYER_ID": "NS9qNTgzU2xRNHR2RmFBWWFBTWk5UT09", "PCD_PAYER_EMAIL": "dev@payple.kr", "PCD_PAY_GOODS": "상품1", "PCD_PAY_TOTAL": "100", "PCD_PAY_ISTAX": "Y", "PCD_PAY_TAXTOTAL": "10", "PCD_CARDNAME": "BC카드", "PCD_CARDNUM": "1111- ****-**** -2222", "PCD_CARDTRADENUM": "202003141320332692022400", "PCD_PAY_CARDAUTHNO": "98123445", "PCD_PAY_CARDRECEIPT": "https://...", "PCD_PAY_PAYMENT_TYPE": "간편결제", "PCD_PAY_TIME": "2020-03-20…", "PCD_PAYER_NAME": "홍길동" }
JSON
계좌이체 응답 예시
Response sample
{ "PCD_PAY_RST": "success", "PCD_PAY_CODE": "PCHK0000", "PCD_PAY_MSG": "전송완료", "PCD_PAY_OID": "test201804000001", "PCD_PAY_TYPE": "transfer", "PCD_PAYER_ID": "NS9qNTgzU2xRNHR2RmFBWWFBTWk5UT09", "PCD_PAY_GOODS": "상품1", "PCD_PAY_TOTAL": "1000", "PCD_PAY_BANK": "081", "PCD_PAY_BANKNAME": "KEB하나은행", "PCD_PAY_BANKNUM": "123-********-021", "PCD_PAY_TIME": "2020-03-20...", "PCD_TAXSAVE_FLAG": "Y", "PCD_TAXSAVE_RST": "Y", "PCD_TAXSAVE_MGTNUM": "G...", "PCD_PAYER_NAME": "홍길동" }
JSON
PCD_PAY_RST = success, PCD_PAY_CODE = "0000"이 포함될 경우 요청성공으로 판단합니다. PCD_PAY_RST = error 일 경우 요청실패로 판단합니다.
실패 리턴(PCD_PAY_RST = error )을 받으신 경우, PCD_PAY_CODE 의 응답코드를 확인하고 잘못된 부분을 수정합니다. 응답코드 리스트는 이 곳 에서 확인하실 수 있습니다.