운영

국내 카드〉취소

연동하기

승인 완료된 결제를 취소할 수 있습니다. 테스트 서버에서는 부분취소가 불가한 점 참고해주세요.

연동 흐름

1. 파트너 인증 요청

Server

파라미터 확인 →

1.1 요청 예시

Header 설정 후 API를 요청해주세요.

POSThttps://democpay.payple.kr/php/auth.php테스트 환경

POSThttps://cpay.payple.kr/php/auth.php라이브 환경

Header

1Content-Type: application/json
2Cache-Control: no-cache
3Referer: https://your-domain.com

Body

JSON

1{
2  "cst_id": "test",
3  "custKey": "abcd1234567890",
4  "PCD_PAYCANCEL_FLAG": "Y"
5}

·주의사항

Referer 필드에는 페이플에 등록된 파트너(상점)의 도메인을 정확히 입력해주세요.
도메인이 일치하지 않을 경우, ‘AUTH0004’ 오류 메시지가 반환됩니다.

2. 취소 요청

Server

파라미터 확인 →

2.1 요청 예시

Header 설정 후 API를 요청해주세요.
중복 방지 결제건의 경우 결제 취소에 필요한 필수 요청 파라미터가 상이하므로, 파라미터 페이지를 참고해주세요.

POSThttps://democpay.payple.kr/php/account/api/cPayCAct.php테스트 환경

POSThttps://cpay.payple.kr/php/account/api/cPayCAct.php라이브 환경

Header

1Content-Type: application/json
2Cache-Control: no-cache
3Referer: https://your-domain.com

Body

JSON

1{
2  "PCD_CST_ID": "UFVNNVZ...",
3  "PCD_CUST_KEY": "T3JzRkp5L...",
4  "PCD_AUTH_KEY": "a688ccb3555...",
5  "PCD_REFUND_KEY": "a41ce010e...",
6  "PCD_PAYCANCEL_FLAG": "Y",
7  "PCD_PAY_OID": "order12345",
8  "PCD_PAY_DATE": "20231219",
9  "PCD_REFUND_TOTAL": "1000"
10}

·주의사항

Referer 필드에는 페이플에 등록된 파트너(상점)의 도메인을 정확히 입력해주세요.
도메인이 일치하지 않을 경우, ‘AUTH0004’ 오류 메시지가 반환됩니다.