응답 코드
코드값으로 원인과 조치를 찾습니다. 같은 숫자라도 발생 영역에 따라 뜻이 다르니 영역을 함께 확인하세요.
해외 카드/간편결제
| 코드 | 메세지 | 설명 |
|---|---|---|
| T0000 | Process Success | 성공 코드입니다. |
| T0100 | Wrong Method Call | 데이터 전송박식 오류인 경우에 발생하며, POST 방식으로 전송이 필요합니다. |
| T0101 | JSON Format Error | 요청 BODY 가 JSON 포맷이 아닌 경우 발생합니다. |
| T0102 | JSON Data Error | |
| T0103 | BODY(POST) Data Error | 파트너 인증 토큰 발급 요청 시 BODY가 공백인 경우에 발생합니다. |
| T0104 | BODY(JSON) Data Error | 파트너 인증 토큰 발급 요청 시 BODY가 공백인 경우에 발생합니다. |
| T0200 | Authentication Request Denied - service_id value does not exist. | service_id 를 전송하지 않거나 공백으로 보낼 경우 발생합니다. |
| T0201 | Authentication Request Denied - service_key value does not exist. | service_key 를 전송하지 않거나 공백으로 보낼 경우 발생합니다. |
| T0210 | Authentication Request Denied - code value does not exist. | code 를 전송하지 않거나 공백으로 보낼 경우 발생합니다. |
| T0211 | Authentication Request Denied - code value is English letters + Numbers 10 digits | code 형식을 잘못 전송한 경우에 발생합니다. |
| T0300 | Authentication Request Denied - User Mismatched | 파트너 인증 요청의 service_id 와 조회된 계정 정보가 일치하지 않는 경우 발생합니다. service_id 가 비어 있으면 T0200, 등록되지 않았으면 T0322, service_key 가 다르면 T0324 가 응답됩니다. |
| T0310 | Authentication Request Denied - Not Registered WHITE IP. | 등록된 White IP가 아닌 경우에 발생합니다. |
| T0320 | Token User Mismatched - T/B | 요청 본문의 service_id 와 Access 토큰을 발급받은 service_id 가 다른 경우 발생합니다. |
| T0322 | Not Registered Partner service_id. | 존재하지 않는 service_id 를 전송할 경우 발생합니다. |
| T0323 | Token User Mismatched (group). | 토큰을 발급한 계정정보와 요청시 보낸 계정정보가 일치하지 않은 경우 발생합니다. |
| T0324 | Not Registered Partner service_key. | 존재하지 않는 service_key 를 전송할 경우 발생합니다. |
| T0325 | Not Status of Approval. | 서비스의 승인이 되어있지 않은 경우 발생합니다. |
| T0326 | Payment key value does not exist. | 결제에 필요한 키가 존재하지 않을 경우 발생합니다. 페이플 고객센터(help@payple.kr)로 문의해주시기 바랍니다. |
| T0327 | Service Setting Error - comm_rate value does not exist. | 결제 수수료율이 지정되지 않은 경우 발생합니다. 페이플 고객센터(help@payple.kr)로 문의해주시기 바랍니다. |
| T0328 | Service Setting Error - pay_currency not registered for merchant. | 가맹점에 결제 통화(pay_currency)가 등록되어 있지 않을 때 발생합니다. 가맹점 서비스 설정 관련 응답입니다. |
| T0400 | Token Denied | 발급받은 토큰이 아닌 경우에 발생합니다. |
| T0401 | Token Denied - Access Token Type | 토큰 유형이 Bearer 가 아닌 경우에 발생합니다. |
| T0402 | Token Expired | 발급받은 토큰의 만료 시간(10분)이 경과한 경우에 발생합니다. |
| T0998 | Token value does exist. | 발급받은 토큰 Authorization 이 공백인 경우 발생합니다. |
| T0999 | Header value does not exist. | API 요청시 헤더 정보를 보내지 않는 경우에 발생합니다. |
| R0100 | service_oid value duplicated. | 주문번호 중복 시 발생하는 응답입니다. |
| R0101 | service_oid value does not exist. | service_oid 값이 존재하지 않을 경우 발생합니다. |
| R0111 | service_oid value not vaild. | service_oid 값이 유효하지 않을 경우 발생합니다. |
| R0102 | comments value not exist. | comments 값이 존재하지 않을 경우 발생합니다. |
| R0112 | comments value should be below 255 byte. | comments 값이 255바이트를 초과하는 경우 발생합니다. 현재 결제, 빌링키 승인 요청의 상품명 길이 초과는 R0122 로 응답됩니다. |
| R0122 | comments value not vaild. | comments 값이 유효하지 않을 경우 발생합니다. |
| R0103 | card_number value does not exist. | card_number 값이 존재하지 않을 경우 발생합니다. |
| R0113 | card_number value not vaild. | card_number 값이 유효하지 않을 경우 발생합니다. |
| R0104 | card_expirationMonth value does not exist. | card_expirationMonth 값이 존재하지 않을 경우 발생합니다. |
| R0114 | card_expirationMonth value not vaild. | card_expirationMonth 값이 유효하지 않을 경우 발생합니다. |
| R0105 | card_expirationYear value does not exist. | card_expirationYear 값이 존재하지 않을 경우 발생합니다. |
| R0115 | card_expirationYear value not vaild. | card_expirationYear 값이 유효하지 않을 경우 발생합니다. |
| R0106 | totalAmount value does not exist. | totalAmount 값이 존재하지 않을 경우 발생합니다. |
| R0116 | totalAmount value not vaild. | totalAmount 값이 유효하지 않을 경우 발생합니다. |
| R0126 | if you pay by KRW, don't put in other than numbers in total amount. | 원화(KRW) 결제는 정수만 가능합니다. (소수점 불가) 외화(USD, JPY, CNY)는 소수점 둘째 자리까지만 허용됩니다. |
| R0136 | totalAmount is less than the approval minimum amount per transaction. | 결제금액이 건당 최소 승인금액보다 적을 때 발생합니다. |
| R0146 | Approval maximum amount per transaction Exceeded. | 건당 최대 승인금액이 초과될 때 발생합니다. |
| R0156 | totalAmount and cancellation amount do not match. | 결제금액과 취소금액이 일치하지 않을 때 발생합니다. |
| R0107 | currency value does not exist. | currency 값이 존재하지 않을 때 발생합니다. |
| R0117 | currency value not vaild. | currency 값이 유효하지 않을 때 발생합니다. |
| R0108 | cvn value does not exist. | cvn 값이 존재하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0118 | cvn value not vaild. | cvn 값이 유효하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0201 | firstName value does not exist. | firstName 값이 존재하지 않을 때 발생합니다. |
| R0211 | firstName value not vaild. | firstName 값이 유효하지 않을 때 발생합니다. |
| R0202 | lastName value does not exist. | lastName 값이 존재하지 않을 때 발생합니다. |
| R0212 | lastName value not vaild. | lastName 값이 유효하지 않을 때 발생합니다. |
| R0203 | address value does not exist. | address 값이 존재하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0213 | address value not vaild. | address 값이 유효하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0204 | locality value does not exist. | locality 값이 존재하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0214 | locality value not vaild. | locality 값이 유효하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0205 | administrativeArea value does not exist. | administrativeArea 값이 존재하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0215 | administrativeArea value not vaild. | administrativeArea 값이 유효하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0206 | postalCode value does not exist. | postalCode 값이 존재하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0216 | postalCode value not vaild. | postalCode 값이 유효하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0235 | country value not vaild. | country 값이 유효하지 않을 때 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0207 | email value does not exist. | email 값이 존재하지 않을 때 발생합니다. |
| R0209 | email Form does not match. | email 형식이 맞지 않을 때 발생합니다. |
| R0301 | resultUrl value does not exist. | resultUrl 값이 존재하지 않을 때 발생합니다. |
| R0311 | resultUrl value not vaild. | resultUrl 값이 유효하지 않을 때 발생합니다. |
| R0501 | api_id value does not exist. | pay_id(결제결과로 받은 api_id) 값이 없는 경우 발생합니다. 매출전표 GET 조회는 token 값이 없는 경우에도 발생합니다. |
| R0511 | api_id value not vaild. | pay_id 값이 50자를 넘거나 형식(영문, 숫자, -, _)에 맞지 않는 경우 발생합니다. 매출전표 GET 조회는 token 을 해석할 수 없는 경우에도 발생합니다. |
| R0521 | Already Requested with this api_id value. | 해당 api_id 값으로 이미 요청한 상태입니다. |
| R0601 | billingkey value does not exist. | 존재하지 않는 billingkey로 요청했을때 발생합니다. |
| R0998 | Error - General system failure. | 일반 시스템 오류로 인해 발생합니다. 요청 파라미터 검증 시 발생합니다. |
| R0126 | if you pay by KRW, don't put in other than numbers in total amount. | 원화(KRW) 결제는 정수만 가능합니다. (소수점 불가) 외화(USD, JPY, CNY)는 소수점 둘째 자리까지만 허용됩니다. |
| A0000 | Processing Success | 요청 업무에 대해 정상적으로 처리되었을때 응답합니다. |
| A0002 | Request Data Error | 요청 데이터에 오류가 있는 경우 발생합니다. 간편결제 응답에서 주로 발생합니다. |
| A0003 | Authentication Request Denied - Billing key does not exist. | 존재하지 않는 빌링키를 전송한 경우 발생합니다. |
| A0004 | Authentication Request Denied - Billing key Blocked. | 차단된 빌링키를 전송한 경우 발생합니다. 차단된 빌링키는 차단/해제 API 를 통해 해제가 가능합니다. |
| A0005 | Authentication Request Denied - Billing key has already been unblocked. | 이미 차단 해제된 빌링키를 해제하는 경우 발생합니다. |
| A0006 | Processing In Progress | 결제 상태가 아직 확정되지 않은 경우이며, 실패가 아닙니다. 간편결제에서만 발생합니다. 최종 승인, 취소 여부는 결과조회 API로 확인해주세요. |
| A0995 | No Cancellation Request Information. | 취소 요청 정보가 없을 때 발생합니다. 간편결제 응답에서 주로 발생합니다. |
| A0996 | Refund Amount Error | 취소금액을 잘못 설정한 경우 발생합니다. |
| A0997 | Internal Processing Error | 내부 처리 오류가 발생한 경우 응답합니다. 간편결제 응답에서 주로 발생합니다. |
| A0998 | None data | 데이터가 없을 때 발생합니다. 간편결제 응답에서 주로 발생합니다. |
| A0999 | Processing Failure | 결제 실패시 발생하는 응답으로, 에러 메시지를 통해 실패 사유를 확인할 수 있습니다. 해당 응답은 승인 업무를 담당하는 대외기관(Cybersource)으로부터의 응답입니다. |
| A0999 | Error - General system failure. | 브랜드사(VISA, MASTER, JCB)의 시스템 오류로 인해 발생합니다. 해당 응답은 승인 업무를 담당하는 대외기관(Cybersource)으로부터의 응답입니다. |
| A0999 | Decline - General decline of the card. No other information provided by the issuing bank. | 카드 발급사의 거절로 인해 발생합니다. 거절 사유를 확인하기 위해서는 카드 회원이 발급사에 직접 문의해야 합니다. 해당 응답은 승인 업무를 담당하는 대외기관(Cybersource)으로부터의 응답입니다. |
| A0999 | The order has been rejected by Decision Manager | 이상거래탐지시스템(FDS)인 Decision Manager 에 의해 감지된 의심 거래로 인해 거절된 경우에 발생합니다. 해당 응답은 이상거래탐지 업무를 담당하는 대외기관(Cybersource)으로부터의 응답입니다. |
| C0998 | The client has closed the payment window. | 구매자가 결제 완료 전 결제창을 종료한 경우에 발생합니다. |
| C0999 | End the payment. | 결제창에서 오류가 발생한 경우의 응답으로, 함께 반환되는 error 를 확인해주세요. |
국내 카드 / [INDEX] 결제창 호출
결제창 호출 과정 중 INDEX 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| INDEX0001 | MEM ERROR - 인증시간 만료 | 아래와 같은 경우 발생합니다. 1. 인덱스 화면에 REST API 를 호출 2. 요청 파라미터가 제대로 설정이 되지 않았거나 누락 3. 결제 요청 화면과 결제창을 띄우는 웹뷰가 서로 다른 브라우저인 경우 4. 크롬80 이슈 → Samesite=none 설정을 서버 또는 파일에 설정 필요 5. 구매자 브라우저의 캐시가 오래된 인증세션을 저장했다가 호출 → 시크릿모드 또는 캐시를 지우고 시도 |
국내 카드 / [AUTH] 파트너 인증
파트너 인증 과정 중 AUTH 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| AUTH0001 | 가맹점 인증에 필요한 cst_id 를 확인해주세요. | 파트너(상점)로부터 페이플로 전송된 cst_id 가 페이플에서 발급한 cst_id 와 일치하지 않거나 공백일 경우 발생합니다. 테스트와 운영 환경에서 사용되는 cst_id 가 서로 다름을 확인해주세요. 테스트 cst_id 는 여기에서 확인할 수 있으며, 운영 cst_id 는 최초 오픈 안내 이메일에 첨부하여 발송됩니다. |
| AUTH0002 | 가맹점 인증에 필요한 custKey 를 확인해주세요. | 파트너(상점)로부터 페이플로 전송된 custKey 가 페이플에서 발급한 custKey 와 일치하지 않거나 공백일 경우 발생합니다. 테스트와 운영 환경에서 사용되는 custKey 가 서로 다름을 확인해주세요. 테스트 custKey 는 여기에서 확인할 수 있으며, 운영 custKey 는 최초 오픈 안내 이메일에 첨부하여 발송됩니다. |
| AUTH0003 | 가맹점 계정이 존재하지 않습니다. | cst_id 가 일치하는 파트너 정보를 찾지 못하는 경우에 발생합니다. |
| AUTH0004 | 접속하시는 서버의 도메인 확인이 필요합니다. | 페이플에 등록된 파트너의 도메인과 IP 만이 페이플 서버에 접속할 수 있습니다. 페이플에 등록된 파트너 도메인(your-domain.com)의 서브도메인(sub.your-domain.com)은 별도의 설정 없이도 접속할 수 있습니다. 파트너가 AWS(아마존웹서비스)를 이용할 때 해당 응답 코드가 발생하면, 가맹점 서버 도메인에 REFERER를 추가해야 합니다. 카페24, 가비아 등의 서버 호스팅을 이용할 경우, 해당 호스팅사에 페이플 URL(테스트 및 운영)에 대한 방화벽 개방을 요청해야 할 필요가 있습니다. |
| AUTH0006 | 보안프로토콜(HTTPS) 접속이 필요합니다. | 페이플 서버에 접속하기 위해서는 보안 프로토콜(HTTPS)을 통한 접속이 필수적입니다. |
| AUTH0007 | Referer 도메인 확인이 필요합니다. | 결제창을 띄우려는 도메인과 파트너 인증 시 Referer 값으로 전송한 도메인이 일치해야 합니다. |
| AUTH0008 | 승인 요청 주소를 다시 확인해주세요. | 결제 인증 시 응답받은 PCD_PAY_COFURL을 확인해주세요. 다른 URL로 전송할 경우 해당 오류가 발생합니다. |
| AUTH0020 | 클라이언트 키(clientKey) 요청 오류 | 요청 서버와 파라미터로 전송된 clientKey 계정이 동일한지 확인해주세요. |
| AUTH0021 | 클라이언트 키(clientKey) 값에 매칭되는 계정이 존재하지 않습니다. | 존재하지 않는 clientKey 이거나 요청 서버와 일치하지 않는 계정의 clientKey 를 전송한 경우에 발생합니다. |
| AUTH0022 | 접속하시는 서버의 도메인 확인이 필요합니다. | 파트너 계정에 등록되지 않은 도메인에서 결제창을 호출할 경우 발생합니다. |
국내 카드 / [CPCA] 결제
결제 과정 중 CPCA 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| CPCA0001 | 인증시간(3분)이 초과되었습니다. 다시 시도해주세요. | 인증에 필요한 시간이 초과되었기 때문에 발생하며, 구매자의 재시도가 필요합니다. |
| CPCA0002 | 결제 진행 중 오류가 발생하였습니다. 다시 시도해주세요. | 구매자의 카드 등록이 완료되지 않았거나 이미 해지된 경우에 발생합니다. |
| CPCA0006 | 이용하시는 상점의 한도가 초과되었습니다. 상점 관리자에게 문의주세요. | 파트너(상점)의 건당 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| CPCA0007 | 이용하시는 상점의 한도가 초과되었습니다. 상점 관리자에게 문의주세요. | 파트너(상점)의 월 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| CPCA0010 | 카드승인 요청 실패!! | 카드사와의 승인 전문 전송 실패 또는 전문 오류로 인해 발생하는 응답입니다. 상세 내용 확인이 필요한 경우, dev@payple.kr 로 문의해 주세요. |
| CPCA0018 | 결제 진행 중 오류가 발생하였습니다. 다시 시도해주세요. | 카드사와의 승인 전문 전송 실패 또는 전문 오류로 인해 발생하는 응답입니다. 상세 내용 확인이 필요한 경우, dev@payple.kr 로 문의해 주세요. |
| CPCA0031 | 부가세 금액이 최대 허용 금액을 초과했습니다. 부가세를 바르게 입력하세요. | 복합과세 설정 시 부가세(PCD_PAY_TAXTOTAL)가 10% 초과하는 비율의 거래인 경우 발생합니다. |
| CPCA0032 | 주문번호(PCD_PAY_OID)는 최대 64자까지 입력할 수 있습니다. | 주문번호 길이가 64자를 초과한 경우 발생합니다. 64자리 이하로 입력해주세요. |
| CPCA0033 | 가맹점 회원번호(PCD_PAYER_NO)는 숫자만 입력할 수 있습니다. | 가맹점 회원번호가 숫자가 아닐 경우 발생합니다. 숫자만 입력해주세요. |
| CPCA0034 | 가맹점 회원번호(PCD_PAYER_NO)는 최대 18자리까지 입력할 수 있습니다. | 가맹점 회원번호 길이가 18자를 초과한 경우 발생합니다. 18자리 이하로 입력해주세요. |
국내 카드 / [PCCF] 승인 요청
승인 요청 과정 중 PCCF로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PCCFD001 | 응답코드 - 원천사로부터 응답된 메시지 | 잔액 부족, 거래 정지 등 카드 상태로 인해 결제가 거절되었거나, 승인 요청 시 거래 세션이 만료된 경우 발생합니다. |
| PCCF0001 | MEM INFO ERROR | 파트너 인증 토큰이 유효하지 않을 경우 발생합니다. 재인증 후 다시 시도해주세요. |
| PCCF0002 | PCD_PAYER_ID ERROR!! | 빌링키(PCD_PAYER_ID) 값이 존재하지 않거나, 요청 파라미터로 전송되지 않았거나, 전송된 값이 다를 경우 발생하는 응답입니다. |
| PCCF0003 | 결제자 정보가 일치하지 않습니다. | 존재하지 않은 빌링키를 요청하였을 때 발생합니다. |
| PCCF0004 | 카드 인증정보를 찾을 수 없습니다. | 결제수단이 카드가 아닌 빌링키로 요청하였을 때 발생합니다. |
| PCCF0006 | 결제 요청할 데이터를 찾을 수 없습니다. | 결제 승인 요청 대상 거래가 없을 경우 발생합니다. |
| PCCF0007 | 기 승인완료!! | 이미 결제 승인 요청 완료된 거래입니다. |
| PCCF0008 | 카드결제 대상이 아닙니다. | 결제 수단이 계좌인 거래에 대한 승인 요청 시 발생합니다. |
| PCCF0009 | PCD_PAY_REQKEY ERROR!! | 유효하지 않은 PCD_PAY_REQKEY 값을 입력할 경우 발생합니다. |
| PCCF0012 | 가맹점 건당 한도 초과 - 해당 사이트 관리자에게 문의하세요!! | 파트너(상점)의 건당 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| PCCF0013 | 가맹점 카드결제 월 한도 초과 - 해당 사이트 관리자에게 문의하세요!! | 파트너(상점)의 월 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| PCCF0014 | 정기결제 - 중복결제 | 승인 처리가 진행 중인 경우 발생합니다. |
| PCCF0015 | 단건결제 - 중복결제 | 승인 처리가 진행 중인 경우 발생합니다. |
| PCCF0018 | 카드결제 실패!! | 승인 처리가 실패된 경우 발생합니다. 잠시 후 다시 시도해주세요. |
| PCCF0027 | 카드결제 실패 - 잘못된 접근입니다.!! | 유효하지 않은 요청 URL Query가 포함되어 있는 경우 발생합니다. |
국내 카드 / [CDAU] 카드등록
정기(빌링), 비밀번호간편결제의 카드등록 과정 중 CDAU 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| CDAU0001 | 인증세션이 만료되었습니다. 다시 시도해주세요. | 브라우저 세션이 만료되어 파트너 인증을 수행할 수 없을 때 발생합니다. |
| CDAU0002 | 카드번호를 바르게 입력하세요. | 카드번호를 12자리 이상, 16자리 이하로 입력해주세요. |
| CDAU0007 | (상위 기관으로부터 수신된 응답메시지) | 본인식별번호(주민등록번호 또는 사업자번호)가 일치하지 않거나 카드 상태에 따라 등록이 거절될 때 응답됩니다. |
| CDAU1000 | 기 인증고객 입니다. | 이미 등록된 카드정보와 동일한 카드정보로 등록을 시도할 때 발생하는 메시지입니다. |
| CDAU1002 | 입력하신 카드정보가 5회 이상 일치하지 않아 해당 카드의 사용이 금일 자정까지 제한됩니다. 자정 이후에 재시도하시거나 다른 카드로 진행해주세요. | 입력했던 카드정보가 5회 이상이 일치하지 않을 때 응답됩니다. 5회 이상 실패하는 경우 해당 카드등록 요청이 거부되며, 자정 이후에 재시도하여야 합니다. |
| CDAU9000 | 카드정보를 올바르게 입력해주세요. | 이미 등록된 카드 정보와 요청된 카드 정보(유효기간, 비밀번호, 생년월일)가 일치하지 않을 때 발생하는 메시지입니다. 카드정보가 모두 일치하는 경우, 기존에 등록된 빌링키를 반환하며, 카드정보가 일치하지 않더라도 빌링키의 상태는 유지됩니다. |
국내 카드 / [PMCD] 빌링 결제창 호출
국내 카드 정기(빌링) 및 간편페이 정기(빌링) 결제창에서 PMCD 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PMCD0001 | 등록된 정보를 찾을 수 없습니다. | 빌링키(PCD_PAYER_ID)에 해당하는 결제자 정보를 찾을 수 없을 때 발생합니다. |
| PMCD0002 | 결제동의 미인증 카드입니다. | 국내 카드 빌링 결제자 정보의 결제 동의가 완료되지 않은 경우 발생합니다. |
| PMCD0003 | 결제가능 최저금액은 100원 입니다. | 결제금액(PCD_PAY_TOTAL)을 100원 미만으로 전송한 경우 발생합니다. |
| PMCD0004 | 결제상품명이 존재하지 않습니다. | 결제상품명(PCD_PAY_GOODS)이 비어 있는 경우 발생합니다. |
| PMCD0005 | 정기결제 년도(YYYY) 오류 | 월 중복 방지 결제 요청 시 정기결제 년도(PCD_PAY_YEAR)가 없거나 4자리가 아닌 경우 발생합니다. |
| PMCD0006 | 정기결제 월(MM) 오류 | 월 중복 방지 결제 요청 시 정기결제 월(PCD_PAY_MONTH)이 1~12 범위를 벗어난 경우 발생합니다. |
| PMCD0007 | 사용자 정의 파라미터(PCD_USER_DEFINE1,2)는 2048자 이하여야 합니다. | PCD_USER_DEFINE1 또는 PCD_USER_DEFINE2가 2048자를 초과한 경우 발생합니다. |
| PMCD0008 | REQUEST DATA ERROR!! | 인증 요청 당시 결제금액과 결제창에서 확인한 결제금액이 일치하지 않는 경우 발생합니다. |
| PMCD0009 | 복합과세 지정부가세는 9자 이하이여야 합니다. | 복합과세 부가세(PCD_PAY_TAXTOTAL)가 9자를 초과한 경우 발생합니다. |
| PMCD0010 | 간편페이 정기(빌링) 결제 사용 불가 가맹점입니다. | 네이버페이와 카카오페이 빌링 결제가 모두 비활성화되어 있거나, 요청한 간편페이 정기(빌링) 결제수단을 사용할 수 없는 경우 발생합니다. 특정 수단을 사용할 수 없는 경우에는 ‘[naverPay 또는 kakaoPay] 사용 불가능한 결제 방식 입니다.’ 메시지가 반환됩니다. |
| PMCD0011 | 간편빌링 결제자 정보(PCD_PAYER_ID)가 올바르지 않습니다. | 간편페이 정기(빌링) 결제 요청 시 PCD_PAYER_ID를 검증할 수 없거나 해당 결제자 정보를 찾을 수 없는 경우 발생합니다. |
| PMCD0012 | 간편빌링 결제: 등록된 빌링키가 없습니다. | 간편페이 정기(빌링) 결제자에게 등록된 활성 빌링키가 없는 경우 발생합니다. |
| PMCD0014 | 간편빌링은 카드등록(PCD_PAY_WORK=AUTH)을 지원하지 않습니다. 결제(PAY/CERT)와 함께 발급하세요. | 간편페이 빌링키는 단독 발급을 지원하지 않으므로 PCD_PAY_WORK를 AUTH로 요청한 경우 발생합니다. PAY 또는 CERT로 요청해주세요. |
| PMCD0015 | 간편페이 정기(빌링) 결제 방식은 비밀번호 간편결제를 지원하지 않습니다. | 간편페이 정기(빌링) 결제를 비밀번호 간편결제(PCD_SIMPLE_FLAG=Y, PCD_PAYER_AUTHTYPE=pwd)로 요청한 경우 발생합니다. 요청 조건에 따라 ‘간편빌링(naverPay/kakaoPay)은 비밀번호 간편결제(pwd)를 지원하지 않습니다.’ 메시지가 반환될 수 있습니다. |
국내 카드 / [SPCD] 빌링키로 결제
결제 과정 중 SPCD 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| SPCD0000 | 카드결제완료 | 정상 처리 |
| SPCD0001 | 결제용 KEY 값이 존재하지 않습니다. | 빌링키(PCD_PAYER_ID) 값이 존재하지 않거나, 요청 파라미터로 전송되지 않았거나, 전송된 값이 다를 경우 발생하는 응답입니다. |
| SPCD0002 | 결제가능 최저금액은 100원 입니다. | 카드최소 결제금액은 100원 입니다. PCD_PAY_TOTAL의 값을 100 이상으로 입력해주세요. |
| SPCD0003 | 결제상품명이 존재하지 않습니다. | 결제상품명(PCD_PAY_GOODS)의 값이 비어있을때 발생합니다. |
| SPCD0004 | 인증세션이 만료되었습니다. 다시 시도해주세요. | 브라우저 세션이 만료되어 파트너 인증을 수행할 수 없을 때 발생합니다. 재인증 후 다시 시도해주세요. |
| SPCD0005 | 결제자 휴대전화번호는 15자 이하이어야 합니다. | 결제자 휴대전화번호(PCD_PAYER_HP)의 값이 15자를 초과할 때 발생합니다. |
| SPCD0006 | 사용자 정의 파라미터(PCD_USER_DEFINE1,2)는 2048자 이하여야 합니다. | 사용자 정의 파라미터(PCD_USER_DEFINE1, PCD_USER_DEFINE2) 값이 2048자를 초과할 때 발생합니다. |
| SPCD0007 | 카드서비스 이용 불가 | 파트너(상점)의 카드정기결제 사용 승인 상태가 아닐 때 발생합니다. 페이플 고객센터(help@payple.kr)로 문의해주세요. |
| SPCD0009 | 이용하시는 상점의 한도가 초과되었습니다. 상점 관리자에게 문의주세요 | 파트너(상점)의 건당 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| SPCD0010 | 이용하시는 상점의 한도가 초과되었습니다. 상점 관리자에게 문의주세요. | 파트너(상점)의 월 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| SPCD0011 | 결제 진행 중 오류가 발생하였습니다. 다시 시도해주세요. | 빌링키(PCD_PAYER_ID) 값이 존재하지 않거나, 요청 파라미터로 전송되지 않았거나, 전송된 값이 다를 경우 발생하는 응답입니다. |
| SPCD0012 | 결제 진행 중 오류가 발생하였습니다. 상점에 문의해주세요. | 빌링키(PCD_PAYER_ID) 값이 존재하지 않거나, 요청 파라미터로 전송되지 않았거나, 전송된 값이 다를 경우 발생하는 응답입니다. 해지된 빌링키인 경우에도 발생할 수 있습니다. |
| SPCD0013 | 미인증 카드입니다. | 결제 동의 신청 처리결과가 완료되지 않은 카드입니다. |
| SPCD0014 | 이미 처리된 거래입니다. 다시 시도해주세요. | 주문번호 중복 시 발생하는 응답입니다. |
| SPCD0015 | 간편결제요청 등록 실패!! | 기타 사유에 의해 결제가 실패할 때 발생하는 메시지입니다. 상세 내용 확인이 필요한 경우, 페이플 테크니컬팀(dev@payple.kr) 로 문의해주세요. |
| SPCD0018 | 카드결제 실패!! | 기타 사유에 의해 결제가 실패할 때 발생하는 메시지입니다. 상세 내용 확인이 필요한 경우, 페이플 테크니컬팀(dev@payple.kr) 로 문의해주세요. |
| SPCD0020 | 간편결제요청 결과 업데이트 실패!! | 기타 사유에 의해 결제가 실패할 때 발생하는 메시지입니다. 상세 내용 확인이 필요한 경우, 페이플 테크니컬팀(dev@payple.kr) 로 문의해주세요. |
| SPCD0021 | 간편결제내역 등록 실패!! | 기타 사유에 의해 결제가 실패할 때 발생하는 메시지입니다. 상세 내용 확인이 필요한 경우, 페이플 테크니컬팀(dev@payple.kr) 로 문의해주세요. |
| SPCD0022 | 간편결제결과 업데이트 실패!! | 기타 사유에 의해 결제가 실패할 때 발생하는 메시지입니다. 상세 내용 확인이 필요한 경우, 페이플 테크니컬팀(dev@payple.kr) 로 문의해주세요. |
| SPCD0023 | 간편결제 결과 등록 실패!! | 기타 사유에 의해 결제가 실패할 때 발생하는 메시지입니다. 상세 내용 확인이 필요한 경우, 페이플 테크니컬팀(dev@payple.kr) 로 문의해주세요. |
| SPCD0027 | 카드결제 건당 한도({한도 금액}) 초과 | 건당 한도 초과로 인해 결제가 불가능하며, 한도 증액을 위해서는 고객센터(help@payple.kr)로 요청해야 합니다. |
| SPCD0031 | 복합과세 지정부가세는 9자 이하이여야 합니다. | 복합과세 부가세(PCD_PAY_TAXTOTAL)의 값이 9자를 초과할 때 발생합니다. |
| SPCD1000 | 단건결제요청 중복결제 신청 - 처리중 또는 결제완료된 결제건이 있습니다. | 동일 주문번호로 짧은 시간 내에 연속 요청 된 경우 발생합니다. |
| SPCD1001 | (상위 기관으로부터 수신된 응답메시지) | 카드잔액부족, 분실신고카드 등 카드 상태에 의해 결제가 실패되는 경우 발생합니다. |
| SPCD1002 | 카드등록 해지 실패!! | 거래 제한 카드, 유효기간 만료, 도난/분실/위변조 등의 사유로 인해 등록된 카드의 해지가 불가능한 경우에 발생합니다. |
| SPCD1003 | - 승인취소처리완료 | 결제 요청 값과 결과 값이 다르거나 기 결제완료 건이 존재한 경우 발생하는 메시지입니다. 다시 시도해주세요. |
| SPCD1004 | {원천사 응답 코드} - {원천사 응답 메시지} | 거래 제한 카드, 유효기간 만료, 도난/분실/위변조 등의 사유로 인해 카드 등록이 불가능한 경우에 발생합니다. |
| SPCD9991 | 가맹점 인증에 필요한 custKey 를 확인해주세요. | 파트너(상점)로부터 페이플로 전송된 custKey 가 페이플에서 발급한 custKey 와 일치하지 않거나 공백일 경우 발생합니다. 테스트와 운영 환경에서 사용되는 custKey 가 서로 다름을 확인해주세요. 테스트 custKey 는 여기에서 확인할 수 있으며, 운영 custKey 는 최초 오픈 안내 이메일에 첨부하여 발송됩니다. |
| SPCD9998 | 간편결제(카드) 실패 : 잘못된 접근입니다.!! | 잘못된 요청 URL/PCD_SIMPLE_FLAG 파라미터 누락 혹은 잘못된 값인 경우 발생하는 메시지입니다. |
| SPCD9999 | 결제 진행 중 오류가 발생하였습니다. 다시 시도해주세요. | 결제 진행 중 오류가 발생한 경우 발생하는 메시지입니다. 다시 시도해주세요. |
| SPCDRQ01 | 카드결제요청 이 다중전송되었습니다. | 결제 진행 중 오류가 발생한 경우 발생하는 메시지입니다. 다시 시도해주세요. |
| SPCDF001 | 결제 진행 중 오류가 발생하였습니다. 다시 시도해주세요. | 해당 카드가 이상거래패턴으로 확인되었기에 거래가 제한된 경우 발생하는 메시지입니다. 자세한 내용은 결제사인 페이플 고객센터(1522-5013)로 문의주시기 바랍니다. |
| SPCDCK01 | PCD_PAY_TYPE ERROR | PCD_PAY_TYPE 값이 카드가 아닌 경우 발생하는 메시지입니다. 결제 요청 URL 또는 PCD_PAY_TYPE 값을 확인해주세요. |
| SPCDCK02 | 가맹점 회원번호(PCD_PAYER_NO)는 숫자만 입력할 수 있습니다. | 가맹점 회원번호가 숫자가 아닐 경우 발생합니다. 숫자만 입력해주세요. |
| SPCDCK03 | 가맹점 회원번호(PCD_PAYER_NO)는 최대 18자리까지 입력할 수 있습니다. | 가맹점 회원번호 길이가 18자를 초과한 경우 발생합니다. 18자리 이하로 입력해주세요. |
국내 카드 / [PAYM] 값 검증
결제 과정 중 PAYM 으로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PAYM0010 | 해당 {입력값 검증 실패 요청 파라미터}에 허용되지 않은 문자만 포함되어 결제에 실패했습니다. | 입력값이 Emoji 또는 허용되지 않은 특수문자(& ' " \ < > | \n \r\n , +)로만 구성된 경우 발생합니다. 입력값 검증 실패 요청 파라미터는 다음과 같습니다. - 상품명 : PCD_PAY_GOODS - 구매자명 : PCD_PAYER_NAME |
| PAYM0011 | 해당 {입력값 검증 실패 요청 파라미터}의 글자 형식이 올바르지 않습니다. 일반 문자 형식으로 다시 요청해주세요. | 입력값에 문자열이 분해된 형식(NFD)으로 요청된 경우 발생합니다. 요청 전 문자열을 일반 문자 형태(NFC)로 변환 후 재요청이 필요합니다. 입력값 검증 실패 요청 파라미터는 다음과 같습니다. - 상품명 : PCD_PAY_GOODS - 구매자명 : PCD_PAYER_NAME |
| PAYM0012 | 결제 금액은 음수로 요청할 수 없습니다. | 결제 금액이 음수로 요청된 경우 발생합니다. |
국내 카드 / [PAYC] 취소
취소 과정 중 PAYC 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PAYC0001 | MEM INFO ERROR - 인증실패 | 파트너 인증 토큰이 유효하지 않을 경우 발생합니다. 재인증 후 다시 시도해주세요. |
| PAYC0002 | PCD_REFUND_KEY ERROR - 환불시스템 인증키 불일치 | 계정에 등록된 환불키와 요청 환불키(PCD_REFUND_KEY)가 일치하지 않을 때 발생합니다. |
| PAYC0003 | 필수 데이터 누락 - 주문번호 | 주문번호(PCD_PAY_OID) 값이 비어있을 때 발생합니다. |
| PAYC0004 | 필수 데이터 누락 - 결제일자 | 결제일자(PCD_PAY_DATE) 값이 비어있을 때 발생합니다. |
| PAYC0005 | 필수 데이터 누락 - 정기결제 년도 | (월 중복 방지 결제) 정기결제 년도(PCD_PAY_YEAR) 값이 비어있을 때 발생합니다. |
| PAYC0006 | 필수 데이터 누락 - 정기결제 월 | (월 중복 방지 결제) 정기결제 월(PCD_PAY_MONTH) 값이 비어있을 때 발생합니다. |
| PAYC0007 | 결제정보를 찾을 수 없습니다. | 취소하려는 원거래 건을 조회할 수 없는 경우에 발생합니다. |
| PAYC0007 | 이미 취소 된 거래건 입니다. | 취소하려는 원거래 건이 이미 취소가 완료된 경우 발생합니다. |
| PAYC0011 | 환불가능금액 초과 (환불가능금액 : / 환불요청금액 : ) | 원거래 건의 취소 가능 금액을 초과하여 취소를 요청할 때 발생합니다. |
| PAYC0012 | {원천사 응답 코드} - {원천사 응답 메시지} | 원천사의 결제 취소 실패 응답 시 발생합니다. 원천사의 응답 코드와 메세지가 노출됩니다. |
| PAYC0022 | 환불요청 금액 초과 | 1일 환불 한도 초과로 인해 환불이 불가능하며, 한도 증액을 위해서는 고객센터(help@payple.kr)로 요청해야 합니다. |
| PAYC0026 | 필수 데이터 누락 - 결제취소 요청금액 | 취소요청금액(PCD_REFUND_TOTAL) 값이 비어있을 때 발생합니다. |
국내 카드 / [PCHK] 결과조회
결과조회 과정 중 PCHK 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PCHK0001 | MEM INFO ERROR | 파트너 인증 토큰이 유효하지 않을 경우 발생합니다. 재인증 후 다시 시도해주세요. |
| PCHK0002 | 결제정보를 찾을 수 없습니다. | 단건 또는 다건(PAY_DATE 모드) 결과조회에서 결과가 없는 경우 발생합니다. 다건 EVENT_DATE 모드는 빈 배열로 정상 응답하여 발생하지 않습니다. |
| PCHK0003 | PCD_CST_ID는 필수 파라미터입니다. | 요청 파라미터 PCD_CST_ID가 누락된 경우 발생합니다. |
| PCHK0004 | PCD_CUST_KEY는 필수 파라미터입니다. | 요청 파라미터 PCD_CUST_KEY가 누락된 경우 발생합니다. |
| PCHK0005 | PCD_AUTH_KEY는 필수 파라미터입니다. | 요청 파라미터 PCD_AUTH_KEY가 누락된 경우 발생합니다. |
| PCHK0006 | PCD_PAYCHK_FLAG는 필수 파라미터입니다. | 단건 결과조회 요청에서 PCD_PAYCHK_FLAG가 누락되었거나 Y가 아닌 경우 발생합니다. |
| PCHK0007 | PCD_PAY_TYPE은 필수 파라미터입니다. | 요청 파라미터 PCD_PAY_TYPE이 누락된 경우 발생합니다. |
| PCHK0008 | PCD_PAY_OID는 필수 파라미터입니다. | 단건 결과조회 요청에서 PCD_PAY_OID가 누락된 경우 발생합니다. |
| PCHK0009 | PCD_PAY_DATE는 필수 파라미터입니다. | 단건 결과조회 요청에서 PCD_PAY_DATE가 누락된 경우 발생합니다. |
| PCHK0010 | PCD_PAYCHK_LIST_FLAG는 필수 파라미터이며, Y여야 합니다. | 다건 결과조회 요청에서 PCD_PAYCHK_LIST_FLAG가 누락되었거나 Y가 아닌 경우 발생합니다. |
| PCHK0011 | PCD_START_DATE는 필수 파라미터입니다. | 다건 결과조회 요청에서 PCD_START_DATE가 누락된 경우 발생합니다. |
| PCHK0012 | PCD_END_DATE는 필수 파라미터입니다. | 다건 결과조회 요청에서 PCD_END_DATE가 누락된 경우 발생합니다. |
| PCHK0013 | PCD_PAY_TYPE은 card 혹은 transfer 여야 합니다. | PCD_PAY_TYPE에 card 또는 transfer 외 값을 전송한 경우 발생합니다. |
| PCHK0014 | 날짜 형식은 YYYYMMDD 이어야 합니다. | 다건 결과조회 요청에서 PCD_START_DATE 또는 PCD_END_DATE 형식이 YYYYMMDD가 아닌 경우 발생합니다. |
| PCHK0015 | 시작일이 종료일보다 클 수 없습니다. | 다건 결과조회 요청에서 PCD_END_DATE가 PCD_START_DATE보다 이전인 경우 발생합니다. |
| PCHK0016 | 조회 기간은 최대 1년을 초과할 수 없습니다. | 다건 결과조회 요청에서 조회 기간이 1년을 초과한 경우 발생합니다. |
| PCHK0017 | 조회 건수는 1 이상이어야 합니다. | 다건 결과조회 요청에서 PCD_LIMIT를 1 미만으로 전송한 경우 발생합니다. |
| PCHK0021 | 조회 건수는 5000 이하여야 합니다. | PCD_DATE_TYPE=PAY_DATE이면서 PCD_LIMIT를 5000 초과로 전송한 경우 발생합니다. |
| PCHK0022 | PCD_DATE_TYPE은 PAY_DATE 혹은 EVENT_DATE 여야 합니다. | 다건 결과조회 요청에서 PCD_DATE_TYPE 값이 PAY_DATE 또는 EVENT_DATE 외의 다른 문자열로 전송된 경우 발생합니다. |
| PCHK0023 | EVENT_DATE 모드 조회 건수는 1000 이하여야 합니다. | PCD_DATE_TYPE=EVENT_DATE이면서 PCD_LIMIT를 1000 초과로 전송한 경우 발생합니다. |
| PCHK9991 | 가맹점 인증 키 불일치 | 파트너 인증 토큰이 파트너 정보와 일치하지 않는 경우 발생합니다. |
| PCHK9994 | 요청하신 페이지는 2분에 20건을 초과한 요청은 거부됩니다. | 결제내역 다건 조회 요청이 2분 20건 제한을 초과한 경우 발생합니다. |
| PCHK9995 | 요청하신 페이지는 초당 1건을 초과한 요청은 거부됩니다. | 결제내역 다건 조회 요청이 초당 1건 제한을 초과한 경우 발생합니다. |
| PCHK9996 | 요청하신 페이지는 10분에 1,000건을 초과한 요청은 거부됩니다. | 결제내역 단건 조회 요청이 10분 1,000건 제한을 초과한 경우 발생합니다. |
| PCHK9997 | 요청하신 페이지는 초당 2건을 초과한 요청은 거부됩니다. | 결제내역 단건 조회 요청이 초당 2건 제한을 초과한 경우 발생합니다. |
국내 카드 / [PUER] 빌링키 조회, 해지
빌링키 조회, 해지 과정 중 PUER 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PUER0001 | MEM INFO ERROR | 파트너 인증 토큰이 유효하지 않을 경우 발생합니다. 재인증 후 다시 시도해주세요. |
| PUER0002 | PCD_PAYER_ID ERROR!! | PCD_PAYER_ID 값이 비어있는 경우 발생합니다. |
| PUER0003 | 결제자 정보가 일치하지 않습니다. | 존재하지 않은 빌링키를 요청하였을 때 발생합니다. |
| PUER0004 | 등록된 정보를 찾을 수 없습니다. | 해지되었거나 존재하지 않은 빌링키를 요청하였을 때 발생합니다. |
| PUER1002 | (상위 기관으로부터 수신된 응답메시지) | 기타 사유에 의해 계좌이체 해지 요청이 실패한 경우 발생합니다. |
| PUER1009 | 카드 해지 실패!! | 기타 사유에 의해 계좌이체 해지 요청이 실패한 경우 발생합니다. |
국내 계좌 / [INDEX] 결제창 호출
결제창 호출 과정 중 INDEX 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| INDEX0001 | MEM ERROR - 인증시간 만료 | 아래와 같은 경우 발생합니다. 1. 인덱스 화면에 REST API 를 호출 2. 요청 파라미터가 제대로 설정이 되지 않았거나 누락 3. 결제 요청 화면과 결제창을 띄우는 웹뷰가 서로 다른 브라우저인 경우 4. 크롬80 이슈 → Samesite=none 설정을 서버 또는 파일에 설정 필요 5. 구매자 브라우저의 캐시가 오래된 인증세션을 저장했다가 호출 → 시크릿모드 또는 캐시를 지우고 시도 |
국내 계좌 / [AUTH] 파트너 인증
파트너 인증 과정 중 AUTH 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| AUTH0001 | 가맹점 인증에 필요한 cst_id 를 확인해주세요. | 파트너(상점)로부터 페이플로 전송된 cst_id 가 페이플에서 발급한 cst_id 와 일치하지 않거나 공백일 경우 발생합니다. 테스트와 운영 환경에서 사용되는 cst_id 가 서로 다름을 확인해주세요. 테스트 cst_id 는 여기에서 확인할 수 있으며, 운영 cst_id 는 최초 오픈 안내 이메일에 첨부하여 발송됩니다. |
| AUTH0002 | 가맹점 인증에 필요한 custKey 를 확인해주세요. | 파트너(상점)로부터 페이플로 전송된 custKey 가 페이플에서 발급한 custKey 와 일치하지 않거나 공백일 경우 발생합니다. 테스트와 운영 환경에서 사용되는 custKey 가 서로 다름을 확인해주세요. 테스트 custKey 는 여기에서 확인할 수 있으며, 운영 custKey 는 최초 오픈 안내 이메일에 첨부하여 발송됩니다. |
| AUTH0003 | 가맹점 계정이 존재하지 않습니다. | cst_id 가 일치하는 파트너 정보를 찾지 못하는 경우에 발생합니다. |
| AUTH0004 | 접속하시는 서버의 도메인 확인이 필요합니다. | 페이플에 등록된 파트너의 도메인과 IP 만이 페이플 서버에 접속할 수 있습니다. 페이플에 등록된 파트너 도메인(your-domain.com)의 서브도메인(sub.your-domain.com)은 별도의 설정 없이도 접속할 수 있습니다. 파트너가 AWS(아마존웹서비스)를 이용할 때 해당 응답 코드가 발생하면, 가맹점 서버 도메인에 REFERER를 추가해야 합니다. 카페24, 가비아 등의 서버 호스팅을 이용할 경우, 해당 호스팅사에 페이플 URL(테스트 및 운영)에 대한 방화벽 개방을 요청해야 할 필요가 있습니다. |
| AUTH0006 | 보안프로토콜(HTTPS) 접속이 필요합니다. | 페이플 서버에 접속하기 위해서는 보안 프로토콜(HTTPS)을 통한 접속이 필수적입니다. |
| AUTH0007 | Referer 도메인 확인이 필요합니다. | 결제창을 띄우려는 도메인과 파트너 인증 시 Referer 값으로 전송한 도메인이 일치해야 합니다. |
| AUTH0020 | 클라이언트 키(clientKey) 요청 오류 | 요청 서버와 파라미터로 전송된 clientKey 계정이 동일한지 확인해주세요. |
| AUTH0021 | 클라이언트 키(clientKey) 값에 매칭되는 계정이 존재하지 않습니다. | 존재하지 않는 clientKey 이거나 요청 서버와 일치하지 않는 계정의 clientKey 를 전송한 경우에 발생합니다. |
| AUTH0022 | 접속하시는 서버의 도메인 확인이 필요합니다. | 파트너 계정에 등록되지 않은 도메인에서 결제창을 호출할 경우 발생합니다. |
국내 계좌 / [PCOF] 승인 요청
승인 요청 과정 중 PCOF 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PCOF0001 | MEM INFO ERROR | 파트너 인증 토큰이 유효하지 않을 경우 발생합니다. 재인증 후 다시 시도해주세요. |
| PCOF0002 | 등록된 계좌정보를 찾을 수 없습니다. | 빌링키(PCD_PAYER_ID) 값이 존재하지 않거나, 요청 파라미터로 전송되지 않았거나, 전송된 값이 다를 경우 발생하는 응답입니다. |
| PCOF0003 | 가맹점 건당 한도 초과 - 해당 사이트 관리자에게 문의하세요!! | 파트너(상점)의 건당 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| PCOF0004 | 이용하시는 상점의 한도가 초과되었습니다. 상점 관리자에게 문의주세요. | 파트너(상점)의 월 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| PCOF0005 | 결제동의 미인증 계좌입니다. | 결제수단 인증이 정상적으로 완료되지 않은 빌링키입니다. 해지 후 다시 시도해주세요. |
| PCOF0006 | 결제 요청할 데이터를 찾을 수 없습니다. | 승인 요청 대상 거래가 없을 경우 발생합니다. |
| PCOF0007 | 기 승인완료!! | 이미 승인 요청 완료된 거래입니다. |
| PCOF0008 | PCD_PAY_REQKEY ERROR!! | 유효하지 않은 PCD_PAY_REQKEY 값을 입력할 경우 발생합니다. |
| PCOF0010 | 정기결제 - 중복결제 | 승인 처리가 진행 중인 경우 발생합니다. |
| PCOF0011 | 단건결제 - 중복결제 | 승인 처리가 진행 중인 경우 발생합니다. |
| PCOF0018 | 상세 실패메시지 | 기타 사유에 의해 계좌이체에 실패한 경우 발생합니다. |
| PCOF0025 | 출금이체 실패 - 잘못된 접근입니다.!! | 유효하지 않은 요청 URL Query가 포함되어 있는 경우 발생합니다. |
국내 계좌 / [ARSA] 본인확인, 출금동의
본인확인, 출금동의 과정 중 ARSA 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| ARSA0001 | 인증시간(3분)이 초과되었습니다. 다시 시도해주세요. | 구매자의 본인 확인 및 출금 동의 유효 시간(3분) 초과로 인해 발생하는 응답입니다. |
| ARSA0002 | 평생계좌번호가 아닌 실계좌번호를 입력해주세요. | 휴대폰번호 형식의 계좌번호를 입력할때 응답되는 메시지입니다. 일반적인 형식의 계좌번호로 재시도 해주세요. |
| ARSA0003 | 이용하시는 상점의 건당 한도가 초과되었습니다. 상점 관리자에게 문의주세요. | 파트너(상점)의 건당 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| ARSA0004 | 이용하시는 상점의 한도가 초과되었습니다. 상점 관리자에게 문의주세요. | 파트너(상점)의 월 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| ARSA0006 | 본인 정보를 바르게 입력해주세요. | 이동통신사 본인 인증에 실패할 경우 발생합니다. 입력한 성명, 생년월일(사업자번호)과 휴대폰 번호의 명의가 일치하는지 확인이 필요합니다. |
| ARSA0007 | 상세응답코드 - 상세응답메시지 | 기타 사유에 의해 이동통신사 본인 인증에 실패할 경우 발생합니다. |
| ARSA1000 | 기 인증고객입니다. | 이미 등록된 계좌정보와 동일한 계좌정보로 등록을 시도할 때 발생하는 메시지입니다. |
| ARSA1001 | 인증시간(3분)이 초과되었습니다. 다시 시도해주세요. | 법인계좌 확인을 위한 1원 인증에 필요한 시간(3분)이 초과되어 발생하는 응답입니다. |
국내 계좌 / [CPAY] 결제
결제 과정 중 CPAY 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| CPAY0001 | 인증세션이 만료되었습니다. 다시 시도해주세요. | 브라우저 세션이 만료되어 파트너 인증을 수행할 수 없을 때 발생합니다. 재인증 후 다시 시도해주세요. |
| CPAY0002 | 결제 진행 중 오류가 발생하였습니다. 다시 시도해주세요. | 구매자의 계좌 등록이 완료되지 않았거나 이미 해지된 경우에 발생합니다. |
| CPAY0003 | 결제 진행 중 오류가 발생하였습니다. 다시 시도해주세요. | 결제 진행 중 오류가 발생될 때 발생하는 오류입니다. 상세 내용 확인이 필요한 경우, 페이플 테크니컬팀(dev@payple.kr) 로 문의해 주세요. |
| CPAY0005 | 이용하시는 상점의 한도가 초과되었습니다. 상점 관리자에게 문의주세요. | 파트너(상점)의 건당 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| CPAY0006 | 이용하시는 상점의 한도가 초과되었습니다. 상점 관리자에게 문의주세요. | 파트너(상점)의 월 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| CPAY0018 | 결제 진행 중 오류가 발생하였습니다. 다시 시도해주세요. | 은행과의 전문 전송 실패 또는 전문 오류로 인해 발생하는 응답입니다. 상세 내용 확인이 필요한 경우, 페이플 테크니컬팀(dev@payple.kr) 로 문의해 주세요. |
| CPAY0031 | 부가세 금액이 최대 허용 금액을 초과했습니다. 부가세를 바르게 입력하세요. | 복합과세 설정 시 부가세(PCD_PAY_TAXTOTAL)가 10% 초과하는 비율의 거래인 경우 발생합니다. |
| CPAY0201 | 이미 존재하는 거래입니다. 다시 시도해주세요. | 주문번호가 중복될 경우 발생하는 응답입니다. |
| CPAY0032 | 주문번호(PCD_PAY_OID)는 최대 64자까지 입력할 수 있습니다. | 주문번호 길이가 64자를 초과한 경우 발생합니다. 64자리 이하로 입력해주세요. |
국내 계좌 / [AUTH] 계좌등록
정기(빌링), 비밀번호간편결제의 계좌등록 과정 중 AUTH 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| AUTH0001 | 인증세션이 만료되었습니다. 다시 시도해주세요. | 브라우저 세션이 만료되어 파트너 인증을 수행할 수 없을 때 발생합니다. |
| AUTH0002 | 평생계좌번호가 아닌 실계좌번호를 입력해주세요. | 휴대폰번호 형식의 계좌번호를 입력할때 응답되는 메시지입니다. 일반적인 형식의 계좌번호로 재시도 해주세요. |
| AUTH0006 | 은행 점검시간 (00:00~00:00) 입니다. 점검시간을 피해 다시 시도해주세요. | 은행점검시간에 따라 요청이 불가할때 발생합니다. 응답메시지에 표기되어있는 점검시간을 피하여 재요청이 필요합니다. |
| AUTH0007 | 사업자번호를 바르게 입력하세요.!! | 사업자번호가 10자가 아닌 경우 발생합니다. |
국내 계좌 / [SPAY] 빌링키로 결제
| 코드 | 메세지 | 설명 |
|---|---|---|
| SPAY0001 | 인증실패 - MEM INFO ERROR | 파트너 인증 토큰이 유효하지 않을 경우 발생합니다. 재인증 후 다시 시도해주세요. |
| SPAY0002 | 평생계좌번호가 아닌 실계좌번호를 입력해주세요. | 휴대폰번호 형식의 계좌번호를 입력할때 응답되는 메시지입니다. 일반적인 형식의 계좌번호로 재시도 해주세요. |
| SPAY0003 | 이용하시는 상점의 한도가 초과되었습니다. 상점 관리자에게 문의주세요. | 파트너(상점)의 건당 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| SPAY0004 | 이용하시는 상점의 한도가 초과되었습니다. 상점 관리자에게 문의주세요. | 파트너(상점)의 월 한도 초과로 인한 응답으로, 한도 조정을 위해서는 페이플 세일즈 담당자와 협의가 필요합니다. |
| SPAY0005 | 결제 진행 중 오류가 발생하였습니다. 다시 시도해주세요. | 빌링키(PCD_PAYER_ID)가 존재하지 않거나 빈 값으로 요청되었을때 응답됩니다. |
| SPAY0008 | 사용자 정의 파라미터(PCD_USER_DEFINE1,2)는 2048자 이하여야 합니다. | 사용자 정의 파라미터(PCD_USER_DEFINE1, PCD_USER_DEFINE2) 값이 2048자를 초과할 때 발생합니다. |
| SPAY0012 | 출금이체 실패!! | 기타 사유에 의해 결제가 실패할 때 발생하는 메시지입니다. 상세 내용 확인이 필요한 경우, 페이플 테크니컬팀(dev@payple.kr) 로 문의해 주세요. |
| SPAY0019 | 결제 진행 중 오류가 발생하였습니다. 다시 시도해주세요. | 결제 진행 중 오류가 발생할 경우 발생합니다. |
| SPAY0023 | 결제가능 최저금액은 200원 입니다. | 계좌이체 최소 결제금액은 200원 입니다. PCD_PAY_TOTAL의 값을 200 이상으로 입력해주세요. |
| SPAY0024 | 결제상품명이 존재하지 않습니다. | 결제상품명(PCD_PAY_GOODS)의 값이 비어있을때 발생합니다. |
| SPAY0027 | 결제자 휴대전화번호는 15자 이하이어야 합니다. | 결제자 휴대전화번호(PCD_PAYER_HP)의 값이 15자를 초과할 때 발생합니다. |
| SPAY0028 | 복합과세 지정부가세는 9자 이하이여야 합니다. | 복합과세 부가세(PCD_PAY_TAXTOTAL)의 값이 9자를 초과할 때 발생합니다. |
국내 계좌 / [PAYM] 값 검증
결제 과정 중 PAYM 으로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PAYM0010 | 해당 {입력값 검증 실패 요청 파라미터}에 허용되지 않은 문자만 포함되어 결제에 실패했습니다. | 입력값이 Emoji 또는 허용되지 않은 특수문자(& ' " \ < > | \n \r\n , +)로만 구성된 경우 발생합니다. 입력값 검증 실패 요청 파라미터는 다음과 같습니다. - 상품명 : PCD_PAY_GOODS - 구매자명 : PCD_PAYER_NAME |
| PAYM0011 | 해당 {입력값 검증 실패 요청 파라미터}의 글자 형식이 올바르지 않습니다. 일반 문자 형식으로 다시 요청해주세요. | 입력값에 문자열이 분해된 형식(NFD)으로 요청된 경우 발생합니다. 요청 전 문자열을 일반 문자 형태(NFC)로 변환 후 재요청이 필요합니다. 입력값 검증 실패 요청 파라미터는 다음과 같습니다. - 상품명 : PCD_PAY_GOODS - 구매자명 : PCD_PAYER_NAME |
| PAYM0012 | 결제 금액은 음수로 요청할 수 없습니다. | 결제 금액이 음수로 요청된 경우 발생합니다. |
국내 계좌 / [PAYC] 취소
취소 과정 중 PAYC 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PAYC0001 | 인증실패 - MEM INFO ERROR | 파트너 인증 토큰이 유효하지 않을 경우 발생합니다. 재인증 후 다시 시도해주세요. |
| PAYC0002 | 환불시스템 인증 키 불일치 - PCD_REFUND_KEY ERROR | 계정에 등록된 환불키와 요청 환불키(PCD_REFUND_KEY)가 일치하지 않을 떄 발생합니다. |
| PAYC0003 | 필수 데이터 누락 - 주문번호 | 주문번호(PCD_PAY_OID) 값이 비어있을때 발생합니다. |
| PAYC0004 | 필수 데이터 누락 - 결제일자 | 결제일자(PCD_PAY_DATE) 값이 비어있을때 발생합니다. |
| PAYC0005 | 필수 데이터 누락 - 정기결제 년도 | (월 중복 방지 결제) 정기결제 년도(PCD_PAY_YEAR) 값이 비어있을때 발생합니다. |
| PAYC0006 | 필수 데이터 누락 - 정기결제 월 | (월 중복 방지 결제) 정기결제 월(PCD_PAY_MONTH) 값이 비어있을때 발생합니다. |
| PAYC0007 | 결제정보를 찾을 수 없습니다. | 취소하려는 원거래 건을 조회할 수 없는 경우에 발생합니다. |
| PAYC0007 | 이미 취소 된 거래건 입니다. | 취소하려는 원거래 건이 이미 취소가 완료된 경우 발생합니다. |
| PAYC0008 | 계좌이체 환불시스템 사용권한이 없습니다. | 계좌이체 환불 기능 사용권한이 없을때 발생합니다. |
| PAYC0009 | 계좌이체 환불 잔여 한도 부족 | 환불가능한 금액을 초과하는 경우 발생합니다. |
| PAYC0010 | 은행 점검시간(00:00~00:00) 입니다. | 은행점검시간에 따라 취소요청이 불가할때 발생합니다. 응답메시지에 표기되어있는 점검시간을 피하여 재요청이 필요합니다. |
| PAYC0011 | 환불가능금액 초과 (환불가능금액: / 환불요청금액: ) | 원거래 건의 취소 가능 금액을 초과하여 취소를 요청할 때 발생합니다. |
| PAYC0022 | 환불요청 금액 초과 | 1일 환불 한도 초과로 인해 환불이 불가능하며, 한도 증액을 위해서는 고객센터(help@payple.kr)로 요청해야 합니다. |
| PAYC0026 | 필수 데이터 누락 - 결제취소 요청금액 | 취소요청금액(PCD_REFUND_TOTAL) 값이 비어있을때 발생합니다. |
국내 계좌 / [PCHK] 결과조회
결과조회 과정 중 PCHK 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PCHK0001 | MEM INFO ERROR | 파트너 인증 토큰이 유효하지 않을 경우 발생합니다. 재인증 후 다시 시도해주세요. |
| PCHK0002 | 결제정보를 찾을 수 없습니다. | 단건 또는 다건(PAY_DATE 모드) 결과조회에서 결과가 없는 경우 발생합니다. 다건 EVENT_DATE 모드는 빈 배열로 정상 응답하여 발생하지 않습니다. |
| PCHK0003 | PCD_CST_ID는 필수 파라미터입니다. | 요청 파라미터 PCD_CST_ID가 누락된 경우 발생합니다. |
| PCHK0004 | PCD_CUST_KEY는 필수 파라미터입니다. | 요청 파라미터 PCD_CUST_KEY가 누락된 경우 발생합니다. |
| PCHK0005 | PCD_AUTH_KEY는 필수 파라미터입니다. | 요청 파라미터 PCD_AUTH_KEY가 누락된 경우 발생합니다. |
| PCHK0006 | PCD_PAYCHK_FLAG는 필수 파라미터입니다. | 단건 결과조회 요청에서 PCD_PAYCHK_FLAG가 누락되었거나 Y가 아닌 경우 발생합니다. |
| PCHK0007 | PCD_PAY_TYPE은 필수 파라미터입니다. | 요청 파라미터 PCD_PAY_TYPE이 누락된 경우 발생합니다. |
| PCHK0008 | PCD_PAY_OID는 필수 파라미터입니다. | 단건 결과조회 요청에서 PCD_PAY_OID가 누락된 경우 발생합니다. |
| PCHK0009 | PCD_PAY_DATE는 필수 파라미터입니다. | 단건 결과조회 요청에서 PCD_PAY_DATE가 누락된 경우 발생합니다. |
| PCHK0010 | PCD_PAYCHK_LIST_FLAG는 필수 파라미터이며, Y여야 합니다. | 다건 결과조회 요청에서 PCD_PAYCHK_LIST_FLAG가 누락되었거나 Y가 아닌 경우 발생합니다. |
| PCHK0011 | PCD_START_DATE는 필수 파라미터입니다. | 다건 결과조회 요청에서 PCD_START_DATE가 누락된 경우 발생합니다. |
| PCHK0012 | PCD_END_DATE는 필수 파라미터입니다. | 다건 결과조회 요청에서 PCD_END_DATE가 누락된 경우 발생합니다. |
| PCHK0013 | PCD_PAY_TYPE은 card 혹은 transfer 여야 합니다. | PCD_PAY_TYPE에 card 또는 transfer 외 값을 전송한 경우 발생합니다. |
| PCHK0014 | 날짜 형식은 YYYYMMDD 이어야 합니다. | 다건 결과조회 요청에서 PCD_START_DATE 또는 PCD_END_DATE 형식이 YYYYMMDD가 아닌 경우 발생합니다. |
| PCHK0015 | 시작일이 종료일보다 클 수 없습니다. | 다건 결과조회 요청에서 PCD_END_DATE가 PCD_START_DATE보다 이전인 경우 발생합니다. |
| PCHK0016 | 조회 기간은 최대 1년을 초과할 수 없습니다. | 다건 결과조회 요청에서 조회 기간이 1년을 초과한 경우 발생합니다. |
| PCHK0017 | 조회 건수는 1 이상이어야 합니다. | 다건 결과조회 요청에서 PCD_LIMIT를 1 미만으로 전송한 경우 발생합니다. |
| PCHK0021 | 조회 건수는 5000 이하여야 합니다. | PCD_DATE_TYPE=PAY_DATE이면서 PCD_LIMIT를 5000 초과로 전송한 경우 발생합니다. |
| PCHK0022 | PCD_DATE_TYPE은 PAY_DATE 혹은 EVENT_DATE 여야 합니다. | 다건 결과조회 요청에서 PCD_DATE_TYPE 값이 PAY_DATE 또는 EVENT_DATE 외의 다른 문자열로 전송된 경우 발생합니다. |
| PCHK0023 | EVENT_DATE 모드 조회 건수는 1000 이하여야 합니다. | PCD_DATE_TYPE=EVENT_DATE이면서 PCD_LIMIT를 1000 초과로 전송한 경우 발생합니다. |
| PCHK9991 | 가맹점 인증 키 불일치 | 파트너 인증 토큰이 파트너 정보와 일치하지 않는 경우 발생합니다. |
| PCHK9994 | 요청하신 페이지는 2분에 20건을 초과한 요청은 거부됩니다. | 결제내역 다건 조회 요청이 2분 20건 제한을 초과한 경우 발생합니다. |
| PCHK9995 | 요청하신 페이지는 초당 1건을 초과한 요청은 거부됩니다. | 결제내역 다건 조회 요청이 초당 1건 제한을 초과한 경우 발생합니다. |
| PCHK9996 | 요청하신 페이지는 10분에 1,000건을 초과한 요청은 거부됩니다. | 결제내역 단건 조회 요청이 10분 1,000건 제한을 초과한 경우 발생합니다. |
| PCHK9997 | 요청하신 페이지는 초당 2건을 초과한 요청은 거부됩니다. | 결제내역 단건 조회 요청이 초당 2건 제한을 초과한 경우 발생합니다. |
국내 계좌 / [PUER] 빌링키 조회, 해지
빌링키 조회, 해지 과정 중 PUER 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PUER0001 | MEM INFO ERROR | 파트너 인증 토큰이 유효하지 않을 경우 발생합니다. 재인증 후 다시 시도해주세요. |
| PUER0002 | PCD_PAYER_ID ERROR!! | PCD_PAYER_ID 값이 비어있는 경우 발생합니다. |
| PUER0003 | 결제자 정보가 일치하지 않습니다. | 존재하지 않은 빌링키를 요청하였을때 발생합니다. |
| PUER0004 | 등록된 정보를 찾을 수 없습니다. | 해지되었거나 존재하지 않은 빌링키를 요청하였을때 발생합니다. |
| PUER0007 | (상위 기관으로부터 수신된 응답메시지) | 기타 사유에 의해 상위기관으로부터 계좌이체 해지 요청이 실패한 경우 발생합니다. 잠시 후 재시도해주세요. |
| PUER0008 | 계좌해지 실패!! | 기타 사유에 의해 계좌이체 해지 요청이 실패한 경우 발생합니다. |
| PUER0009 | (상위 기관으로부터 수신된 응답메시지) | 기타 사유에 의해 상위기관으로부터 계좌이체 해지 요청이 실패한 경우 발생합니다. 잠시 후 재시도해주세요. |
국내 계좌 / [BILL] 현금영수증 발행
현금영수증 발행 과정 중 BILL 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| BILL0001 | Wrong access attempt | 유효하지 않은 URL로 요청 시 발생합니다. 요청 URL을 다시 확인해주세요. |
| BILL0002 | 인증세션이 만료되었습니다. 다시 시도해주세요. | 세션이 만료되어 요청 업무를 수행할 수 없을 때 발생합니다. 파트너 인증을 다시 진행해주세요. |
| BILL0003 | 현금영수증 발행을 실패했습니다. | 국세청과의 통신 오류로 인해 현금영수증 발행에 실패한 경우에 발생합니다. |
국내 계좌 / [TSRG] 현금영수증 등록(발행)
현금영수증 등록(발행) 과정 중 TSRG 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| TSRG0000 | 현금영수증 발행완료 | 현금영수증 발행(재발행 포함)이 정상적으로 완료된 경우입니다. |
| TSRG0001 | 환불된 결제건은 현금영수증 발행이 불가능합니다. | 환불 처리된 결제 건에 대해 현금영수증 발행을 요청한 경우 발생합니다. |
| TSRG0007 | 현금영수증 발행 요청할 데이터를 찾을 수 없습니다. | 결제 정보를 조회할 수 없는 경우 발생합니다. 요청 파라미터를 확인해주세요. |
| TSRG1000 | 현금영수증 기 발행완료 | 이미 현금영수증이 발행된 결제 건에 대해 재요청한 경우입니다. |
| TSRG1001 | 현금영수증 재발행에 실패하였습니다. | 국세청과의 통신 오류 등으로 현금영수증 재발행에 실패한 경우 발생합니다. |
| TSRG1002 | 현금영수증 재발행 실패 | 현금영수증 재발행 후 데이터 업데이트에 실패한 경우 발생합니다. |
| TSRG1003 | 현금영수증 발행가능 금액을 초과하였습니다. | 요청한 발행 금액이 해당 결제 건의 발행가능 금액을 초과한 경우 발생합니다. |
| TSRG1004 | 현금영수증 부가세 발행가능 금액을 초과하였습니다. | 요청한 부가세 금액이 해당 결제 건의 부가세 발행가능 금액을 초과한 경우 발생합니다. |
| TSRG2001 | 현금영수증 발행에 실패하였습니다. | 국세청과의 통신 오류 등으로 현금영수증 발행에 실패한 경우 발생합니다. |
| TSRG9998 | 현금영수증 - 잘못된 접근입니다. | 유효하지 않은 방식으로 현금영수증 API에 접근한 경우 발생합니다. |
| TSRG9999 | 현금영수증 처리 실패 | 현금영수증 처리 중 알 수 없는 오류가 발생한 경우입니다. 잠시 후 재시도해주세요. |
국내 계좌 / [TSDL] 현금영수증 취소
현금영수증 취소 과정 중 TSDL 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| TSDL0000 | 현금영수증 취소 성공 | 현금영수증 취소가 정상적으로 완료된 경우입니다. |
| TSDL0001 | 현금영수증 조회에 실패했습니다. | 취소 대상 현금영수증 정보 조회에 실패한 경우 발생합니다. |
| TSDL0002 | 현금영수증 발행취소에 실패하였습니다. | 국세청과의 통신 오류 등으로 현금영수증 발행취소에 실패한 경우 발생합니다. |
| TSDL0003 | 현금영수증 발행취소 실패 | 현금영수증 발행취소 후 데이터 업데이트에 실패한 경우 발생합니다. |
| TSDL0004 | 현금영수증 발행취소 대상을 찾을 수 없습니다. | 취소할 현금영수증 발행 내역을 찾을 수 없는 경우 발생합니다. 요청 파라미터를 확인해주세요. |
| TSDL0005 | 승인거래 현금영수증만 취소 현금영수증을 발행할 수 있습니다. | 이미 취소된 현금영수증에 대해 재취소를 요청한 경우 발생합니다. 승인거래 건만 취소가 가능합니다. |
국내 계좌 / [TSPR] 현금영수증 전표 조회
현금영수증 전표 조회 과정 중 TSPR 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| TSPR0001 | 현금영수증 발행(문서) 정보를 찾을 수 없습니다. | 요청한 결제 건에 대한 현금영수증 발행(문서) 정보를 찾을 수 없는 경우 발생합니다. |
| TSPR0002 | 현금영수증 전표 URL 조회에 실패하였습니다. | 현금영수증 전표 조회 처리 중 오류가 발생하거나, 유효하지 않은 URL이 반환된 경우 발생합니다. |
링크결제 / [LINK] 링크 생성
링크 생성 과정 중 LINK 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| LINK0001 | 인증실패 - MEM INFO ERROR | 파트너 인증 토큰이 유효하지 않을 경우 발생합니다. 재인증 후 다시 시도해 주세요. |
| LINK0002 | 상품명을 입력하세요. | PCD_PAY_GOODS 값이 존재하지 않을 때 발생합니다. |
| LINK0003 | 결제요청금액을 입력하세요. | PCD_PAY_TOTAL 값이 존재하지 않을 때 발생합니다. |
| LINK0004 | 정기결제 구분 년월 을 입력하세요. | 월 중복방지 결제 파라미터 년(PCD_PAY_YEAR) 또는 월(PCD_PAY_MONTH)이 입력되지 않았을 때 발생합니다. |
| LINK0005 | 링크 생성 에러 1 | 링크결제 생성 중 에러가 발생될 때 응답합니다. |
| LINK0006 | 기 등록 링크입니다. | 상품명, 가격이 동일한 경우에 발생합니다. |
| LINK0007 | 링크 생성 에러 2 | 링크결제 생성 중 에러가 발생될 때 응답합니다. |
| LINK0008 | 카드 최소 결제금액은 100원, 계좌이체 최소 결제금액은 200원입니다. | 결제 요청금액이 결제수단별 최소금액보다 적을 경우 발생합니다. |
| LINK0009 | 2,000,000원 초과 거래는 은행 정책으로 계좌이체 이용이 불가능하기에 링크생성이 실패하였습니다. | 이용가능한 결제수단으로 계좌이체을 포함되고, 상품 금액이 2,000,000원을 초과할 때 발생합니다. |
| LINK0011 | 복합과세의 부가세 금액이 최대 부가세 금액보다 크게 설정되었습니다. 부가세를 바르게 입력하세요. | 복합과세의 부가세 금액이 상품 금액보다 클 경우 발생합니다. |
| LINK0010 | 추가 파라미터 특수문자는 =,&,-만 허용 가능합니다. | 추가 파라미터(PCD_LINK_PARAMETER) 값에 =, &, - 외에 특수문자가 포함될 때 발생합니다. |
| LINK0010 | 추가 파라미터는 255자 까지 가능합니다. | 추가 파라미터(PCD_LINK_PARAMETER) 값이 255자를 초과할 때 발생합니다. |
| LINK0010 | 판매자 공지는 200자 이내로 입력해 주세요. | 판매자 공지(PCD_LINK_NOTI_MSG) 값이 200자를 초과할 때 발생합니다. |
| LINK0012 | 사용권한이 없습니다. | 선택한 결제수단의 이용권한이 없을때 발생합니다. |
| LINK0013 | 설정한 링크결제 마감일시가 현재 시각보다 이전입니다. 현재 시각 이후로 설정해주세요. | 요청한 링크결제의 마감시간이 현재시간보다 이전일 때 발생합니다. |
| LINK0014 | 수량은 숫자만 입력 가능합니다. | PCD_GOODS_AMOUNT 값에 숫자가 아닌 값이 포함될 때 발생합니다. |
| LINK0015 | 수량은 최대 999개 까지만 가능합니다 | PCD_GOODS_AMOUNT 값이 999를 초과할 때 발생합니다. |
| LINK0016 | 유효하지 않은 PCD_PAY_METHOD 값입니다. | PCD_PAY_METHOD 값이 허용값이 아닐 때 발생합니다. 허용값: 'naverPay', 'kakaoPay', 'naverPay+kakaoPay', 'kakaoPay+naverPay' |
| LINK0017 | 링크결제 상품이 품절되었습니다. | 이미 품절된 링크를 결제할 때 발생합니다. |
| LINK0018 | 해당 {입력값 검증 실패 요청 파라미터}에 허용되지 않은 문자만 포함되어 링크결제 생성이 불가능합니다. | {입력값 검증 실패 요청 파라미터}에 이모지 등 사용할 수 없는 문자로만 이루어져 있을 때 발생합니다. 입력값 검증 실패 요청 파라미터는 다음과 같습니다. - 상품명 : PCD_PAY_GOODS - 상품 설명 : PCD_PAY_GOODS_EXPLAIN - 메모 : PCD_LINK_MEMO - 판매자 공지 : PCD_LINK_NOTI_MSG |
| LINK0024 | 링크결제 만료일시는 YYYYMMDD, YYYYMMDDHH, YYYYMMDDHHMMSS 형태여야 합니다. | PCD_LINK_EXPIREDATE 형태가 YYYYMMDD, YYYYMMDDHH, YYYYMMDDHHMMSS 가 아닌 경우에 발생합니다. 허용 예시값 : '20260425', '2026042509', '20260425090000' |
| LINK0025 | 링크결제 만료일시는 현재 시각으로부터 최소 5분 이후로 설정해주세요. | PCD_LINK_EXPIREDATE에 설정한 시간이 현재 시각으로부터 5분 이내인 경우 발생합니다. |
| LINK1002 | 링크결제 키가 전송되지 않았습니다. | PCD_LINK_KEY 를 빈 값으로 전송했을 경우 발생합니다. |
| LINK1003 | 존재하지 않는 링크 키 입니다. | PCD_LINK_KEY 를 전송했으나 일치하는 링크가 없을 경우 발생합니다. |
| LINK1006 | 링크결제 만료 실패!! | 링크결제의 만료 처리 실패 시 발생합니다. |
| LINK9998 | 이미 만료된 링크결제 입니다. | 이미 만료된 링크를 만료 처리하려 할 때 발생합니다. |
링크결제 / [PAYM] 값 검증
링크결제 생성 과정 중 PAYM 으로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PAYM0011 | 해당 {입력값 검증 실패 요청 파라미터}의 글자 형식이 올바르지 않습니다. 일반 문자 형식으로 다시 요청해주세요. | 입력값에 문자열이 분해된 형식(NFD)으로 요청된 경우 발생합니다. 요청 전 문자열을 일반 문자 형태(NFC)로 변환 후 재요청이 필요합니다. 입력값 검증 실패 요청 파라미터는 다음과 같습니다. - 상품명 : PCD_PAY_GOODS - 상품 설명 : PCD_PAY_GOODS_EXPLAIN - 메모 : PCD_LINK_MEMO - 판매자 공지 : PCD_LINK_NOTI_MSG |
| PAYM0012 | 결제 금액은 음수로 요청할 수 없습니다. | 결제 금액이 음수로 요청된 경우 발생합니다. |
정산지급대행
| 코드 | 메세지 | 설명 |
|---|---|---|
| T0100 | 잘못된 메소드 호출 | 데이터 전송방식 오류인 경우에 발생하며, POST 방식으로 전송이 필요합니다. |
| T0101 | JSON 포맷오류 | 요청 BODY가 JSON 포맷이 아닌 경우 발생합니다. |
| T0200 | BODY(POST) 데이터 오류 | 파트너 인증 토큰 발급 요청 시 BODY가 공백인 경우 발생합니다. |
| T0201 | BODY(JSON) 데이터 오류 | 파트너 인증 토큰 발급 요청 시 BODY가 공백인 경우 발생합니다. |
| T0211 | 인증요청 거부 - cst_id 값이 존재 하지 않습니다. | cst_id 를 전송하지 않거나 공백으로 보낼 경우 발생합니다. |
| T0212 | 인증요청 거부 - custKey 값이 존재 하지 않습니다. | custKey 를 전송하지 않거나 공백으로 보낼 경우 발생합니다. |
| T0213 | 인증요청 거부 - code 값이 존재 하지 않습니다. | code 를 전송하지 않거나 공백으로 보낼 경우 발생합니다. |
| T0214 | 인증요청 거부 - code 영문자+숫자 10자리 | code 형식을 잘못 전송한 경우에 발생합니다. |
| T0300 | 인증요청 거부 - 사용자 불일치 | 계정정보(cst_id)가 공백이거나 등록되어 있지 않은 경우 발생합니다. |
| T0310 | 인증요청 거부 - 등록된 WHITE IP 아닙니다. | 등록된 White IP가 아닌 경우에 발생합니다. |
| T0400 | 토큰 거부 | 발급받은 토큰이 아닌 경우에 발생합니다. |
| T0401 | 토큰 거부 - Access Token 유형 | 토큰 유형이 Bearer 가 아닌 경우에 발생합니다. |
| T0402 | 토큰 만료(초) | 발급받은 토큰의 만료 시간(60초)이 경과한 경우에 발생합니다. |
| T0404 | 토큰 사용자 불일치 | 계정 정보(cst_id)와 파트너 인증 요청 시 전송한 계정 정보가 일치하지 않을 경우 발생합니다. |
| T0405 | 등록된 파트너 정보가 아닙니다. | 존재하지 않는 cst_id 를 전송할 경우 발생합니다. |
| T0406 | 등록된 파트너의 custKey가 아닙니다. | 존재하지 않는 custKey 를 전송할 경우 발생합니다. |
| T0410 | Hub 정산 승인상태가 아닙니다. | 서비스가 승인되지 않은 경우에 발생합니다. |
| T0411 | Hub 정산 시작일이 아닙니다. | 서비스 정산 시작일 이전에 요청을 보내는 경우 발생합니다. |
| T0412 | Hub 지급이체 시작일이 아닙니다. | 서비스 지급이체 시작일 이전에 요청을 보내는 경우 발생합니다. |
| T0996 | Hub 서비스 점검 시간입니다.(점검일시: 2024-01-01 00:00:00 ~ 2024-01-01 00:00:00) | 서비스 점검 시간 동안 서비스 이용이 불가합니다. 점검이 종료된 후 시도해주세요. |
| T0997 | Hub 가능시간이 아닙니다.(가능시간 : 01시 ~ 23시) | 은행 점검 시간 동안 서비스 이용이 불가하며, 이에 따라 00시부터 01시까지는 Hub 토큰 발급도 불가합니다. |
| T0998 | 토큰 값이 존재 하지 않습니다. | Access Token 이 공백인 경우 발생합니다. |
| T0999 | 헤더 값이 존재 하지 않습니다. | API 요청시 헤더 정보를 보내지 않는 경우에 발생합니다. |
| T1999 | 오픈뱅킹 API 토큰발급 불가 | 금융기관 API 토큰 발급 중 오류가 발생할 경우에 나타납니다. |
| A0001 | 처리 중(이체결과조회 요망) | 금융기관에 이체 요청을 했으나, 이체 처리가 완료되지 않을 경우 발생합니다. 페이플에서는 매 30분마다 이체 처리 여부를 확인하며, 처리가 완료된 건에 대해서는 Webhook을 재전송합니다. |
| A0002 | 참가은행 에러 | 존재하지 않거나 처리할 수 없는 계좌일 경우, 상세한 사유를 포함하여 반환되는 메시지입니다. |
| A0003 | 내부 처리 에러 | 금융기관에 이체 요청을 했으나, 에러가 발생한 경우 응답됩니다. 페이플에서는 매 30분마다 이체 처리 여부를 확인하며, 처리가 완료된 건에 대해서는 Webhook을 재전송합니다. |
| A0007 | 처리시간 초과 에러 | 금융기관에 이체 요청을 했으나, 이체 처리시간이 초과했을 경우 발생합니다. 페이플에서는 매 30분마다 이체 처리 여부를 확인하며, 처리가 완료된 건에 대해서는 Webhook을 재전송합니다. |
| A0009 | API 세부업무 처리실패 | 아래의 사유로 인해 이체가 실패한 경우이며, 해당 billing_tran_id는 사용할 수 없습니다. 따라서 계좌 조회 단계를 다시 진행해야 합니다. 해당계좌 없음(412) 해약 계좌(415) 잡좌(416) 사고 신고계좌(419) 거래중지 계좌(420) 기타 처리불가(해당 지점 연락요망)(499) 예금주명 불일치(815) |
| A0099 | 장기 미실행 이체 대기 취소 | 요청상태 거래가 오래 남아있는 경우 사전 공지 후 운영 절차를 통해 취소될 수 있습니다. |
| A0999 | 기관 통신불가 | 금융기관과의 통신에 실패할 경우 발생합니다. 페이플에서는 매 30분마다 이체 처리 여부를 확인하며, 처리가 완료된 건에 대해서는 Webhook을 재전송합니다. |
| N0101 | 실명인증 거부 - bank_code_std 값 오류. | 지원하지 않는 지급이체기관 표준코드(bank_code_std)를 요청할 경우 발생합니다 |
| N0102 | 실명인증 거부 - account_num 값이 존재하지 않습니다. | account_num 값이 존재하지 않을 때 발생합니다. |
| N0103 | 실명인증 거부 - account_num 값은 숫자만 가능합니다. | account_num 값에 숫자 이외에 값이 포함될 경우 발생합니다. |
| N0111 | 실명인증 거부 - account_holder_info_type 값 오류. | “0”, “6” 외에 다른 값을 입력할 경우 발생합니다. |
| N0112 | 실명인증 거부 - account_holder_info 값 오류. | 유효하지 않은 생년월일 또는 사업자번호를 입력할 경우 발생합니다. |
| N0120 | 실명인증 거부 - 생년월일 오류입니다. | 유효하지 않은 생년월일을 입력할 경우 발생합니다. |
| N0130 | 실명인증 거부 - 사업자번호 오류입니다. | 유효하지 않은 사업자번호를 입력할 경우 발생합니다. |
| N0198 | 실명인증 거부 - 해당계좌 없음 | 실명인증 결과, 계좌가 존재하지 않을 경우 발생합니다. |
| N0199 | 실명인증 거부 | 기타 사유에 의해 실명인증이 거부될 경우 발생합니다. |
| N0499 | 실명인증 거부 - payple-hub 처리오류 | 실명인증 처리 중 에러가 발생할 경우 응답됩니다. |
| R0109 | 지급이체 요청 거부 - 입금이체 권한이 없습니다. | 이체 권한이 없는 계정으로 이체 대기를 요청할 때 발생합니다. |
| R0100 | 지급이체 요청 거부 - 하위고객아이디(sub_id) 64바이트 미만입니다. | sub_id가 64바이트를 초과할 때 발생합니다. |
| R0101 | 지급이체 요청 거부 - billing_tran_id 값이 존재 하지 않습니다. | billing_tran_id 값이 존재하지 않을 때 발생합니다. |
| R0102 | 지급이체 요청 거부 - billing_tran_id의 실명인증 정보가 존재 하지 않습니다. | billing_tran_id에 해당하는 실명정보가 존재하지 않을 때 발생합니다. |
| R0103 | 지급이체 요청 거부 - 사용 불가능한 billing_tran_id - (사유) | 특정 사유에 의해 billing_tran_id가 차단되었을 때 발생합니다. |
| R0110 | 지급이체 요청 거부 - tran_amt 값이 존재 하지 않습니다. | tran_amt 값이 존재하지 않을 때 발생합니다. |
| R0111 | 지급이체 요청 거부 - tran_amt 값은 숫자만 가능합니다. | tran_amt 값에 숫자 이외에 값이 포함될 경우 발생합니다. |
| R0112 | 지급이체 요청 거부 - tran_amt 이체한도( _원) 초과 | 지정된 이체한도보다 큰 금액을 요청할 경우 발생합니다. |
| R0113 | 지급이체 요청 거부 - 테스트시 이체금액은 1000(원) 고정 입니다. | 테스트 환경에서 tran_amt 값을 1000 이 아닌 값을 입력했을 때 발생합니다. |
| R0121 | 지급이체 요청 거부 - 입금계좌인자내역(print_content) 6자 이하입니다. | print_content 값을 6자 이상 초과할 때 발생합니다. |
| R0130 | 지급이체 요청 거부 - 지급이체금액이 정산금액을 초과했습니다. | 이체가능한 금액을 초과할 때 발생합니다. |
| R0135 | 지급이체 실행 거부 - webhook url 값이 설정되지 않았습니다. | 계정 정보에 이체결과를 수신할 webhook url이 등록되어 있지 않은 경우 발생합니다. |
| R0136 | 지급이체 실행 거부 - webhook url 값이 유효하지 않습니다. | 계정 정보에 등록된 webhook url이 유효하지 않은 경우 발생합니다. |
| R0137 | 지급이체 실행 거부 - test webhook url 값이 설정되지 않았습니다. | 테스트 계정(cst_id=”test”)에서 응답되는 값입니다. webhook_url 값이 비어있는 경우 발생합니다. |
| R0138 | 지급이체 실행 거부 - test webhook url 값은 255바이트 미만입니다. | 테스트 계정(cst_id=”test”)에서 응답되는 값입니다. webhook_url 값이 255바이트를 초과할 때 발생합니다. |
| R0141 | 지급이체 실행 거부 - group_key 값이 존재 하지 않습니다. | group_key 값이 존재하지 않을 때 발생합니다. |
| R0142 | 지급이체 실행 거부 - 해당 group_key의 입금이체 요청 정보가 존재 하지 않습니다. | 이체 대기 중인 group_key가 존재하지 않을 때 발생합니다. |
| R0143 | 지급이체 실행 거부 - billing_tran_id 값이 존재 하지 않습니다. | billing_tran_id 값이 존재하지 않을 때 발생합니다. |
| R0144 | 지급이체 실행 거부 - billing_tran_id 값의 입금이체 요청 정보가 존재 하지 않습니다.(*** | ALL) | 요청 group_key에 속한 이체 대기 건이 없는 경우 발생합니다. |
| R0145 | 지급이체 실행 거부 - 중복된 지급이체 실행 입니다. | 이미 실행 중인 건에 대해 요청할 때 발생합니다. |
| R0146 | 지급이체 취소 거부 - 실행 완료된 지급이체 건이 포함되어 있습니다. 건별 취소를 이용해주세요. | 취소 요청 시 실행 완료된 지급이체 건이 포함되어 있을 때 발생합니다. |
| R0147 | 지급이체 취소 거부 - 취소 가능한 지급이체 요청 건이 존재하지 않습니다. | 취소 요청 시 이미 실행 완료된 지급이체 건일 때 발생합니다. |
| R0150 | 지급이체 실행 거부 - execute_type 값이 존재하지 않습니다. | execute_type 값이 존재하지 않을 때 발생합니다. |
| R0151 | 지급이체 실행 거부 - execute_type 허용된 값이 아닙니다. (NOW | CANCEL) | “NOW”, “CANCEL” 외에 다른 값을 입력할 경우 발생합니다. |
| R0160 | 지급이체 실행 거부 - 실행 금액이 정산금액을 초과했습니다. | 지정된 이체한도보다 큰 금액이 실행할 경우 발생합니다. |
| R0499 | 지급이체 거부 - payple-hub 처리오류 | 페이플 정산지급대행 API 요청 중 에러가 발생할 때 응답됩니다. |
| D0101 | 지급이체 결과 거부 - 조회 대상 파라미터가 존재하지 않습니다. | 이체결과조회에 필요한 파라미터가 비어있을때 발생합니다. |
| D0102 | 지급이체 결과 거부 - 지급이체 정보가 존재하지 않습니다. | 이체 정보가 존재하지 않을 때 발생합니다. |
| D0111 | 지급이체 결과 거부 - bank_tran_date 값이 존재하지 않습니다. | bank_tran_date 값이 존재 하지 않을 때 발생합니다. |
| D0112 | 지급이체 결과 거부 - bank_tran_date의 값이 유효하지 않습니다. (YYYYMMDD) | bank_tran_date의 값이 유효하지 않을 때 발생합니다. |
| D0113 | 지급이체 결과 거부 - bank_tran_date의 지급이체 정보가 존재 하지 않습니다. | 입력한 bank_tran_date 에 이체정보가 존재하지 않을 때 발생합니다. |
| D0121 | 지급이체 요청 결과 거부 - group_key 값이 존재하지 않습니다. | group_key 값이 존재하지 않을 때 발생합니다. |
| D0122 | 지급이체 요청 결과 거부 - 해당 group_key의 지급이체 요청 정보가 존재하지 않습니다. | 해당 group_key 에 속해있는 이체 대기 건이 존재하지 않을 때 발생합니다. |
| D0131 | 지급이체 결과 거부 - group_key 값이 존재하지 않습니다. | group_key 값이 존재하지 않을 때 발생합니다. |
| D0132 | 지급이체 결과 거부 - 해당 group_key의 지급이체 정보가 존재 하지 않습니다. | 해당 group_key 에 속해있는 이체 건이 존재하지 않을 때 발생합니다. |
대사 / [PSTL] 국내 정산내역 조회
국내 정산내역 조회 중 PSTL 로 시작하는 응답 목록입니다.
| 코드 | 메세지 | 설명 |
|---|---|---|
| PSTL0000 | 정상 처리 | |
| PSTL0001 | 정산 데이터가 아직 준비되지 않았습니다. 당일 정산 데이터는 오전 07:00 이후에 재시도 해주세요. | 정산일이 당일인 데이터를 오전 07:00 이전에 조회할 경우 발생합니다. 미래의 정산일을 조회할 경우 발생합니다. |
| PSTL0002 | 조회 기간은 최대 31일까지 지정할 수 있습니다. | |
| PSTL0003 | 유효하지 않은 커서입니다. | 응답의 lastKey 값을 수정 없이 그대로 다음 요청에 전달해주세요. |
| PSTL0004 | 날짜 형식이 올바르지 않습니다. | yyyyMMdd 또는 yyyy-MM-dd 형식으로 전달해주세요. |
| PSTL0010 | PCD_CST_ID 는 필수 파라미터입니다. | |
| PSTL0011 | PCD_CUST_KEY 는 필수 파라미터입니다. | |
| PSTL0012 | PCD_AUTH_KEY 는 필수 파라미터입니다. | |
| PSTL0013 | PCD_SETTLEMENT_FLAG 는 필수 파라미터이며, Y 여야 합니다. | |
| PSTL0014 | PCD_START_DATE 는 필수 파라미터입니다. | |
| PSTL0015 | PCD_END_DATE 는 필수 파라미터입니다. | |
| PSTL0016 | 시작일이 종료일보다 클 수 없습니다. | |
| PSTL0017 | PCD_METHOD 는 CARD / TRANSFER / EASYPAY 중 하나여야 합니다. | |
| PSTL0018 | PCD_LIMIT 는 1 이상이어야 합니다. | |
| PSTL0019 | PCD_LIMIT 는 3000 이하여야 합니다. | |
| PSTL0020 | MEM INFO ERROR | 회원 정보 조회에 실패한 경우 발생합니다. |
| PSTL0021 | 정산내역 조회 통신에 실패했습니다. 잠시 후 다시 시도해주세요. | 문제가 지속되면 페이플 지니로 문의해주세요. |
| PSTL9991 | 가맹점 인증 키 불일치 | |
| PSTL9997 | 요청하신 페이지는 초당 1건을 초과한 요청은 거부됩니다. | |
| PSTL9996 | 요청하신 페이지는 2분에 20건을 초과한 요청은 거부됩니다. | |
| PSTL9999 | NO DATA | 예외 메시지 누락 시 기본값으로 사용됩니다. |
대사 / 국내 거래
| 코드 | 메세지 | 설명 |
|---|---|---|
| PCHK0000 | 거래내역 조회 성공 | PayChkActList.php 가 정상 응답할 때의 PCD_PAY_CODE 값입니다. 조회 결과는 PCD_DATA.PCD_CONTENT 에 담깁니다. |