T0100
⦁ 데이터 전송방식 오류입니다.
⦁ 데이터 전송방식은 POST 로 설정해주시기 바랍니다.
T0101
BODY가 JSON포맷이 아닌 경우 발생합니다. (POST key : value 허용)
T0200
토큰발급 요청시 BODY가 공백일 경우 발생합니다.
T0201
토큰발급 요청시 BODY가 공백일 경우 발생합니다.
T0211
인증요청 거부 - cst_id 값이 존재 하지 않습니다.
cst_id를 보내지 않거나 공백으로 보낼 경우 발생합니다.
T0212
인증요청 거부 - custKey 값이 존재 하지 않습니다.
custKey를 보내지 않거나 공백으로 보낼 경우 발생합니다.
T0213
인증요청 거부 - code 값이 존재 하지 않습니다.
code를 보내지 않거나 공백으로 보낼 경우 발생합니다.
T0214
인증요청 거부 - code 영문자+숫자 10자리
code형식을 잘못 보냈을 경우 발생합니다.
※ code는 반드시 영문자와 숫자만을 포함한 10자리로 보내셔야 합니다.
T0300
계정정보(cst_id)가 공백이거나 등록되어 있지 않은 경우 발생합니다.
T0310
인증요청 거부 - 등록된 WHITE IP 아닙니다.
⦁ 등록되어 있는 White IP가 아닐 경우 발생합니다.
⦁ White IP에 대한 정보는 가입 및 Key 정보 수령에서 확인해주세요. T0400
발급받은 토큰이 아닐 경우 발생합니다.
T0401
토큰 유형이 Bearer가 아닐 경우 발생합니다.
T0402
⦁ 발급받은 토큰의 만료시간이 지난 경우 발생합니다.
⦁ 토큰의 만료시간은 60초로, 파트너에서는 토큰의 주기적인 발급을 직접 구현하셔야 합니다.
T0404
토큰을 생성한 계정정보와 요청시 보낸 계정정보가 다를 경우 발생합니다.
T0405
⦁ 페이플 허브에 가입되어 있지 않은 cst_id를 보낼 경우 발생합니다.
⦁ 가입하셨다면 cst_id를 다시 확인하여 보내주세요.
T0406
보낸 cst_id와 매칭되는 custKey가 아닐 경우 발생합니다.
T0410
Hub 서비스의 승인이 되어있지 않은 경우 발생합니다.
T0411
Hub 서비스의 정산 시작일 이전에 요청을 보내는 경우 발생합니다.
T0412
Hub 서비스의 지급이체 시작일 이전에 요청을 보내는 경우 발생합니다.
T0996
Hub 서비스 점검 시간입니다. (점검일시: 2022-01-01 00:00:00 ~ 2022-01-01 00:00:00)
서비스 점검 시간 내에는 Hub 서비스 이용이 불가합니다.
점검이 종료된 후 API 요청을 시도해주세요.
T0997
Hub 가능시간이 아닙니다.(가능시간 : 01시 ~ 23시)
은행 점검시간에는 서비스 사용이 불가하여 00~01시에는 Hub 토큰발급도 불가합니다.
T0998
Access Token이 공백일 경우 발생합니다.
T0999
API 요청시 헤더 정보를 보내지 않을 경우 발생합니다.
T1999
금융기관 API 토큰 발급에 오류가 생긴 경우 발생합니다.
A0002
존재하지 않거나 처리할 수 없는 계좌인 경우 상세사유와 함께 리턴하는 메시지입니다.
A0007
⦁ 지급이체 지연
⦁ 지급이체 처리시간이 초과했을 경우 발생합니다.
A0009
⦁ 기타 사유에 의해 지급이체가 실패한 경우입니다.
⦁ 아래의 사유로 지급이체가 실패된 경우, 해당 billing_tran_id를 사용할 수 없으므로 실명인증 API가 다시 진행되어야 합니다.
- 상세사유(bank_rsp_code)
- 해당계좌 없음(412)
- 해약 계좌(415)
- 잡좌(416)
- 사고 신고계좌(419)
- 거래중지 계좌(420)
- 기타 처리불가(해당 지점 연락요망)(499)
- 예금주명 불일치(815)
A0999
기관과의 통신에 실패할 경우 발생합니다.
B0010
JSON BODY 길이가 기준 길이를 초과할 경우 발생합니다.
N0101
실명인증 거부 - bank_code_std 값 오류
금융기관 코드에 없는 지급이체기관 표준코드(bank_code_std)를 보낼 경우 발생합니다. N0102
실명인증 거부 - account_num 값 오류
N0103
실명인증 거부 - account_num 값은 숫자만 가능합니다.
N0111
실명인증 거부 - account_holder_info_type 값 오류
N0112
실명인증 거부 - account_holder_info 값 오류
N0499
실명인증 거부 - payple-hub 처리오류
R0109
지급이체 요청 거부 - 입금이체 권한이 없습니다.
R0100
지급이체 요청 거부 - 하위고객아이디(sub_id) 64바이트 미만입니다.
R0101
지급이체 요청 거부 - billing_tran_id 값이 존재 하지 않습니다.
R0102
지급이체 요청 거부 - billing_tran_id의 실명인증 정보가 존재 하지 않습니다.
R0103
지급이체 요청 거부 - 사용 불가능한 billing_tran_id - (사유)
⦁ 지급이체 실행 후, 특정 사유에 의해 빌링키가 유효하지 않는 경우 발생하는 메시지입니다.
⦁ 실명조회 API로 계좌 실명인증을 다시 진행해 주세요.
※ 특정 사유에 의해 차단되는 빌링키는 세무업무 처리실패(A0009)를 참고해주세요. R0110
지급이체 요청 거부 - tran_amt 값이 존재 하지 않습니다.
R0111
지급이체 요청 거부 - tran_amt 값은 숫자만 가능합니다.
R0112
지급이체 요청 거부 - tran_amt 이체한도( _원) 초과
R0113
지급이체 요청 거부 - 테스트시 이체금액은 1000(원) 고정 입니다.
R0121
지급이체 요청 거부 - 입금계좌인자내역(print_content) 6자 이하입니다.
R0130
지급이체 요청 거부 - 지급이체금액이 정산금액을 초과했습니다.
R0135
지급이체 실행 거부 - webhook url 값이 설정되지 않았습니다.
R0136
지급이체 실행 거부 - webhook url 값이 유효하지 않습니다.
R0137
지급이체 실행 거부 - test webhook url 값이 설정되지 않았습니다.
R0138
지급이체 실행 거부 - test webhook url 값은 255바이트 미만입니다.
R0141
지급이체 실행 거부 - group_key 값이 존재 하지 않습니다.
R0142
지급이체 실행 거부 - 해당 group_key의 입금이체 요청 정보가 존재 하지 않습니다.
R0143
지급이체 실행 거부 - billing_tran_id 값이 존재 하지 않습니다.
R0144
지급이체 실행 거부 - billing_tran_id 값의 입금이체 요청 정보가 존재 하지 않습니다.(*** | ALL)
R0145
지급이체 실행 거부 - 중복된 지급이체 실행 입니다.
R0150
지급이체 실행 거부 - execute_type 값이 존재하지 않습니다.
R0151
지급이체 실행 거부 - execute_type 허용된 값이 아닙니다.(NOW | CANCEL)
R0160
지급이체 실행 거부 - 실행 금액이 정산금액을 초과했습니다.
R0399
지급이체 거부 - payple-hub 사용거부
R0499
지급이체 거부 - payple-hub 처리오류
D0101
지급이체 결과 거부 - api_tran_id 값이 존재 하지 않습니다.
api_tran_id값이 공백이거나 보내지 않을 경우 발생합니다.
D0102
지급이체 결과 거부 - api_tran_id의 지급이체 정보가 존재 하지 않습니다.
api_tran_id가 없는 값일 경우 발생합니다.
S0001
시스템 업데이트 또는 점검 중인 경우 발생합니다.
표 우측 상단에서 응답코드 / 응답메시지를 검색해보세요!