운영

국내 계좌〉결과조회

연동하기

웹훅(Webhook)을 통한 결제 결과 수신에 실패한 경우에도 결제 결과를 확인하실 수 있습니다.
한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 합니다.
단건 조회, 다건 조회는 각각 별도의 유량 제어 정책이 적용됩니다.
단건 조회는 1초에 2회, 10분당 1,000회를 초과하는 요청은 거부됩니다.
다건 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.

연동 흐름

1. 파트너 인증 요청

Server

파라미터 확인 →

단건 조회

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_PAYCHK_FLAG": "Y"
5}

·주의사항

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

다건 조회

다건 조회 API에서도 파트너 인증 요청 방식은 단건 조회와 동일합니다.
다건 조회 인증/요청에는 PCD_PAYCHK_LIST_FLAG를 사용합니다.

2. 결과 조회 요청

Server

파라미터 확인 →

단건 조회

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

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

POSThttps://cpay.payple.kr/php/PayChkAct.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_PAYCHK_FLAG": "Y",
6  "PCD_PAY_TYPE": "transfer",
7  "PCD_PAY_OID": "order12345",
8  "PCD_PAY_DATE": "20231219"
9}

·주의사항

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

다건 조회

Header 설정 후 API를 요청해주세요.
조회 날짜 범위(PCD_START_DATE~PCD_END_DATE)는 최대 1년까지 가능합니다.
첫 요청에서는 PCD_LASTKEY를 생략합니다.
응답의 PCD_HAS_MORE가 true이면 반환된 PCD_LASTKEY를 다음 요청에 포함합니다.

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

POSThttps://cpay.payple.kr/php/PayChkActList.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_PAYCHK_LIST_FLAG": "Y",
6  "PCD_START_DATE": "20231219",
7  "PCD_END_DATE": "20231219",
8  "PCD_PAY_TYPE": "transfer",
9  "PCD_LIMIT": 5000
10}

다음 페이지 요청 Body

JSON

1{
2  "PCD_CST_ID": "UFVNNVZ...",
3  "PCD_CUST_KEY": "T3JzRkp5L...",
4  "PCD_AUTH_KEY": "a688ccb3555...",
5  "PCD_PAYCHK_LIST_FLAG": "Y",
6  "PCD_START_DATE": "20231219",
7  "PCD_END_DATE": "20231219",
8  "PCD_PAY_TYPE": "transfer",
9  "PCD_LIMIT": 5000,
10  "PCD_LASTKEY": "gmUZOwXKxH64MWh3CsL3xg=="
11}

Response

JSON

1{
2  "PCD_PAY_CODE": "PCHK0000",
3  "PCD_PAY_MSG": "success",
4  "PCD_DATA": {
5    "PCD_HAS_MORE": true,
6    "PCD_LASTKEY": "gmUZOwXKxH64MWh3CsL3xg==",
7    "PCD_LIMIT": 5000,
8    "PCD_CONTENT": [
9      {
10        "PCD_CST_ID": "PAYLAP01",
11        "PCD_PAY_OID": "order12345",
12        "PCD_PAY_TIME": "2023-12-19 13:42:23",
13        "PCD_PAY_TYPE": "transfer",
14        "PCD_PAYER_NO": "1234",
15        "PCD_PAYER_ID": "OVA3...",
16        "PCD_PAYER_EMAIL": "complete@payer-email.com",
17        "PCD_PAY_YEAR": "2023",
18        "PCD_PAY_MONTH": "12",
19        "PCD_PAY_GOODS": "테스트 상품",
20        "PCD_PAY_AMOUNT": 1000,
21        "PCD_PAY_TOTAL": 1000,
22        "PCD_PAY_ISTAX": "Y",
23        "PCD_PAY_TAXTOTAL": 500,
24        "PCD_REGULER_FLAG": "N",
25        "PCD_PAY_STATE": "결제완료",
26        "PCD_PAYER_NAME": "홍길동",
27        "PCD_PAYER_HP": "01012345678",
28        "PCD_PAY_BANK": "020",
29        "PCD_PAY_BANKNAME": "우리은행",
30        "PCD_PAY_BANKNUM": "123-********-456",
31        "PCD_TAXSAVE_FLAG": "Y",
32        "PCD_TAXSAVE_RST": "Y",
33        "PCD_TAXSAVE_MGTNUM": "G123456"
34      }
35    ]
36  }
37}

·주의사항

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