Search
🔙

결제 취소 (카드 / 계좌)

이 글의 목차

1. 정의

결제 취소란 결제된 거래건을 취소하는 기능입니다.
‼️
신용카드 취소는 취소수수료가 발생하지 않기 때문에 기본적으로 서비스가 오픈되어 있지만, 계좌이체 취소는 취소수수료가 발생하기 때문에 파트너사의 요청이 있어야 오픈됩니다.
‼️
테스트 서버에서는 카드결제 부분취소 및 비과세 설정이 불가합니다.
🔗
서버 환경별 결제 기능 비교이곳에서 확인해보세요.

2. 프로세스 개요

3. 파트너 인증

파트너 서버

Request Message

파라미터 정보
Search
Parameter
더 알아보기
Type
Length
Parameter value
Reference
custKey
Open
String
255
abcd1234567890
파트너 인증키
PCD_PAYCANCEL_FLAG
Open
String
1
Y
취소 요청 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 { "cst_id": "test", "custKey": "abcd1234567890", "PCD_PAYCANCEL_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
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 값은 고정값이 아니므로 저장해놓고 계속해서 사용하면 안됩니다. + 해당 값의 유효기간은 30분입니다. + 한 번의 파트너 인증과 하나의 요청이 매칭되어야 합니다. 즉 한번의 파트너 인증으로 받은 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...
파트너 인증 후 리턴 받은 인증 Token
PCD_REFUND_KEY
Open
String
-
a41c...
환불서비스 Key (파트너 관리자 > 상점정보 > 기본정보에서 확인하실 수 있습니다.)
PCD_PAYCANCEL_FLAG
Open
String
1
Y
‘Y’ - 고정값
PCD_PAY_OID
Open
String
255
test099942200156938
주문번호
PCD_PAY_DATE
Open
Number
8
20200320
취소 대상 거래건이 결제된 원거래일자
PCD_REFUND_TOTAL
Open
Number
20
100
결제취소 요청금액 (기존 결제금액보다 적은 금액 입력 시 부분취소로 진행)
COUNT8
선택 파라미터 정보
Search
Parameter
더 알아보기
Type
Length
Parameter value
Reference
PCD_REFUND_TAXTOTAL
Open
Number
11
100
복합과세(과세+면세) 거래건을 취소할때는 PCD_REFUND_TAXTOTAL 에 취소할 과세금액을 별도로 지정해서 취소요청을 진행합니다.
COUNT1
Request sample
/* * TEST : https://democpay.payple.kr * REAL : https://cpay.payple.kr */ 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_REFUND_KEY" : "a41ce010ede9fcbfb3be86b24858806596a9db68b79d138b147c3e563e1829a0", "PCD_PAYCANCEL_FLAG": "Y", "PCD_PAY_OID": "test099942200156938", "PCD_PAY_DATE": 20200320, "PCD_REFUND_TOTAL": 1000 }
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_PAY_GOODS
Open
카드
계좌
상품1
상품명
PCD_REFUND_TOTAL
Open
카드
계좌
1000
환불금액
PCD_REFUND_TAXTOTAL
Open
카드
계좌
10
과세 및 복합과세(과세+면세) 주문건에 필요한 금액이며 파트너사에서 전송한 값을 부가세로 설정합니다. 비과세의 경우 사용하지 않습니다.
PCD_PAY_CARDTRADENUM
Open
카드
-
카드 승인취소 거래 키
PCD_PAY_CARDRECEIPT
Open
카드
-
매출전표 출력 링크
COUNT11
카드 취소 응답 예시
Response sample
{ "PCD_PAY_RST" => "success", "PCD_PAY_CODE" => "PAYC0000", "PCD_PAY_MSG" => "환불성공", "PCD_PAY_OID" => "test201804000001", "PCD_PAY_TYPE" => "card", "PCD_PAYER_ID" => "d0to...", "PCD_PAY_GOODS" => "상품1", "PCD_REFUND_TOTAL" => "100", "PCD_REFUND_TAXTOTAL" => "10", "PCD_PAY_CARDTRADENUM" => "", "PCD_PAY_CARDRECEIPT" => "" }
JSON
계좌이체 취소 응답 예시
Response sample
{ "PCD_PAY_RST" => "success", "PCD_PAY_CODE" => "PAYC0000", "PCD_PAY_MSG" => "환불성공", "PCD_PAY_OID" => "test201804000001", "PCD_PAY_TYPE" => "transfer", "PCD_PAYER_ID" => "NS9qNTgzU2xRNH...", "PCD_PAY_GOODS" => "상품1", "PCD_REFUND_TOTAL" => "1000", "PCD_REFUND_TAXTOTAL" => "10" }
JSON
‼️
PCD_PAY_RST = success, PCD_PAY_CODE = "0000"이 포함될 경우 요청성공으로 판단합니다. PCD_PAY_RST = error 일 경우 요청실패로 판단합니다.
💡
실패 리턴(PCD_PAY_RST = error )을 받으신 경우, PCD_PAY_MSG 의 응답코드를 확인하고 잘못된 부분을 수정합니다. 응답코드 리스트는 이 곳↗ 에서 확인하실 수 있습니다.
TOP