파라미터

1 .1 파트너 인증 요청

취소 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.

파트너 인증이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

1.2 취소 요청

파트너 인증 후 취소 요청 시 필요한 Request 파라미터는 아래와 같습니다.

취소 요청이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

2.1 파트너 인증 요청

결과조회 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다. 한 번의 파트너 인증 후 30분의 유효 시간 동안 조회 요청을 해야 합니다. 단건 조회, 다건 조회는 각각 별도의 유량 제어 정책이 적용됩니다.

단건 조회를 위한 인증 요청 시 PCD_PAYCHK_FLAG를 Y로 전송하고, 다건 조회를 위한 인증 요청 시 PCD_PAYCHK_LIST_FLAG를 Y로 전송하세요. 두 파라미터를 동시에 인증 요청에 사용할 경우 인증 응답이 안내와 다를 수 있습니다.

파트너 인증이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

2.2 단건 결과조회 요청

파트너 인증 후 단건 결과조회 요청 시 필요한 Request 파라미터는 아래와 같습니다. 단건 조회는 1초에 2회, 10분당 1,000회를 초과하는 요청은 거부됩니다.

단건 조회로 월 중복 방지 결제 건을 조회하기 위해서는 아래 파라미터를 포함해야 합니다.

단건 결과조회 요청이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

2.3 다건 결과조회 요청

파트너 인증 후 다건 결과조회 요청 시 필요한 Request 파라미터는 아래와 같습니다. 다건 조회는 1초에 1회, 2분당 20회를 초과하는 요청은 거부됩니다.

다건 결과조회 요청이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다. PCD_CONTENT의 각 항목은 원결제 1건의 정보(승인 금액, 상품명, 카드 정보 등)를 담고 있습니다. PCD_DATE_TYPE=EVENT_DATE 조회 시, 추가로 PCD_TRANSACTIONS 배열에 조회 기간 내 발생한 승인/취소 거래 이력이 함께 반환됩니다. 조회 결과가 없을 때 동작 차이 - PAY_DATE 모드 : 조회 결과가 없으면 오류로 응답합니다. (PCHK0002 - 내역이 존재하지 않습니다) - EVENT_DATE 모드 : 조회 결과가 없어도 정상 응답으로 빈 배열을 반환합니다. (PCD_CONTENT: [], PCD_HAS_MORE: false, PCD_LASTKEY: null) 정산 대사 등 거래 없는 날도 정상 호출되는 케이스를 위해 빈 응답을 보장합니다.

3.1 파트너 인증 요청

빌링키 조회 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다. 한 번의 파트너 인증으로 30분 동안 조회 요청이 가능합니다. 매 조회마다 새로운 인증이 필요하지 않습니다.

파트너 인증이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

3.2 빌링키 조회 요청

파트너 인증 후 빌링키 조회 요청 시 필요한 Request 파라미터는 아래와 같습니다.

빌링키 조회 요청이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

4.1 파트너 인증 요청

빌링키 해지 요청 시 요구되는 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다. 한 번의 파트너 인증으로 30분 동안 조회 요청이 가능합니다. 매 조회마다 새로운 인증이 필요하지 않습니다.

파트너 인증이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

4.2 빌링키 해지 요청

파트너 인증 후 빌링키 해지 요청 시 필요한 Request 파라미터는 아래와 같습니다.

빌링키 해지 요청이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.