원하는 목차 항목을 누르면 해당 내용으로 이동합니다.
1.1. 이용사 등록
이 문서는 신규 이용사 등록을 위한 프로세스를 설명합니다.
•
HTTP header information
URL | 요청 도메인 + /usecompany/regist |
Method | POST |
Content-Type | Application/json; charset=UTF-8 |
•
Request
No | 항목 | 항목명 | 필수 | TYPE | 설명 |
1 | uscoNm | 이용사명 | Y | String | |
2 | bzprNo | 사업자번호 | Y | String | |
3 | rpsrNm | 대표자명 | Y | String | |
4 | rpstTlno | 대표전화번호 | Y | String | |
5 | rpsrEml | 대표이메일 | Y | String | |
6 | rpsrMbtlNo | 대표휴대전화번호 | Y | String | |
7 | zip | 우편번호 | Y | String | |
8 | adr | 주소 | Y | String | |
9 | dtlAdr | 상세주소 | Y | String | |
10 | bztpCd | 업종코드 | Y | String | |
11 | bscnNm | 업태명 | Y | String | |
12 | grmnKdcd | 보증금종류코드 | N | String | 0 : 보증보험, 1 : 현금예치 |
13 | grnOrcd | 보증기관코드 | N | String | |
14 | grnAmt | 보증금액 | N | bigint | |
15 | grnFromDt | 보증시작일자 | N | String | |
16 | grnToDt | 보증종료일자 | N | String | |
17 | emlSndrAdr | 이메일발송주소 | N | String | 고객안내메일발송 시 별도의 이메일 주소를 사용할 경우 입력 |
18 | rsvgRate | 적립율 | Y | double | 적립율 정수 2자리, 소수점3자리 형태로 입력
Ex) 0.5%일 경우 00.500 |
{
"uscoSno": "이용사일련번호",
"uscoNm": "이용사명",
"uscoStcd": "이용사상태코드",
"bzprNo": "사업자번호",
"rpsrNm": "대표자명",
"rpstTlno": "대표전화번호",
"rpsrEml": "대표이메일",
"rpsrMbtlNo": "대표휴대전화번호",
"zip": "우편번호",
"adr": "주소",
"dtlAdr": "상세주소",
"bztpCd": "업종코드",
"bscnNm": "업태명",
"grmnKdcd": "보증금종류코드",
"grnOrcd": "보증기관코드",
"grnAmt": "보증금액",
"grnFromDt": "보증시작일자",
"grnToDt": "보증종료일자",
"emlSndrAdr": "이메일발송주소",
"rsvgRate": "적립율"
}
JSON
복사
•
Response
No | 항목 | 항목명 | 필수 | TYPE | 설명 |
1 | sucsFalr | Y | String | 성공 실패 여부 | |
2 | rsltCd | Y | String | 응답 코드
‘HCO000’이 아닌 경우는 모두 오류입니다. | |
3 | rsltMesg | Y | String | 응답 메시지 | |
4 | rsltObj | N | JSON | API별 응답 데이터 | |
4-1 | uscoSno | 이용사일련번호 | Y | bigint | |
4-2 | uscoTkn | 이용사토큰 | Y | String | 이용사 정보 수정 또는 가맹점 관리 시 필요 |
4-3 | pubKey | 이용사암호화공개키 | Y | String | 가맹점정보암호화 시 필요 |
{
"sucsFalr": "",
"rsltCd": "",
"rsltMesg": "",
"rsltObj": {
"uscoSno": "이용사일련번호",
"uscoTkn": "이용사토큰",
"pubKey": "이용사암호화공개키"
}
}
JSON
복사
1.2. 이용사 수정
이용사사 정보 변경 희망 시, 서비스 변경할 정보만 입력하면 됩니다.
•
HTTP header information
URL | 요청 도메인 + /usecompany/modify |
Method | POST |
Content-Type | Application/json; charset=UTF-8 |
Authorization | Bearer + 스페이스 1byte + 이용사토큰 |
•
Request
No | 항목 | 항목명 | 필수 | TYPE | 설명 |
1 | uscoSno | 이용사일련번호 | Y | bigint | |
2 | uscoNm | 이용사명 | N | String | |
3 | uscoStcd | 이용사상태코드 | N | String | 00:등록, 10:중지, 99:해지 |
4 | bzprNo | 사업자번호 | N | String | |
5 | rpsrNm | 대표자명 | N | String | |
6 | rpstTlno | 대표전화번호 | N | String | |
7 | rpsrEml | 대표이메일 | N | String | |
8 | rpsrMbtlNo | 대표휴대전화번호 | N | String | |
9 | zip | 우편번호 | N | String | |
10 | adr | 주소 | N | String | |
11 | dtlAdr | 상세주소 | N | String | |
12 | bztpCd | 업종코드 | N | String | |
13 | bscnNm | 업태명 | N | String | |
14 | grmnKdcd | 보증금종류코드 | N | String | 0 : 보증보험, 1 : 현금예치 |
15 | grnOrcd | 보증기관코드 | N | String | |
16 | grnAmt | 보증금액 | N | bigint | |
17 | grnFromDt | 보증시작일자 | N | String | |
18 | grnToDt | 보증종료일자 | N | String | |
19 | emlSndrAdr | 이메일발송주소 | N | String | 고객안내메일발송 시 별도의 이메일 주소를 사용할 경우 입력 |
20 | rsvgRate | 적립율 | N | double |
{
"uscoSno": "이용사일련번호",
"uscoNm": "이용사명",
"uscoStcd": "이용사상태코드",
"bzprNo": "사업자번호",
"rpsrNm": "대표자명",
"rpstTlno": "대표전화번호",
"rpsrEml": "대표이메일",
"rpsrMbtlNo": "대표휴대전화번호",
"zip": "우편번호",
"adr": "주소",
"dtlAdr": "상세주소",
"bztpCd": "업종코드",
"bscnNm": "업태명",
"grmnKdcd": "보증금종류코드",
"grnOrcd": "보증기관코드",
"grnAmt": "보증금액",
"grnFromDt": "보증시작일자",
"grnToDt": "보증종료일자",
"emlSndrAdr": "이메일발송주소",
"rsvgRate": "적립율"
}
JSON
복사
•
Response
No | 항목 | 항목명 | 유형 | 필수 | 설명 |
1 | sucsFalr | String | Y | 성공 실패 여부 | |
2 | rsltCd | String | Y | 응답 코드
‘HCO000’이 아닌 경우는 모두 오류입니다. | |
3 | rsltMesg | String | Y | 응답 메시지 | |
4 | rsltObj | JSON | N | API별 응답 데이터 | |
4-1 | uscoSno | 이용사일련번호 | bigint | Y | |
4-2 | uscoNm | 이용사명 | String | N | |
4-3 | uscoStcd | 이용사상태코드 | String | N | 00:등록, 10:중지, 99:해지 |
4-4 | bzprNo | 사업자번호 | String | N | |
4-5 | rpsrNm | 대표자명 | String | N | |
4-6 | rpstTlno | 대표전화번호 | String | N | |
4-7 | rpsrEml | 대표이메일 | String | N | |
4-8 | rpsrMbtlNo | 대표휴대전화번호 | String | N | |
4-9 | zip | 우편번호 | String | N | |
4-10 | adr | 주소 | String | N | |
4-11 | dtlAdr | 상세주소 | String | N | |
4-12 | bztpCd | 업종코드 | String | N | |
4-13 | bscnNm | 업태명 | String | N | |
4-14 | grmnKdcd | 보증금종류코드 | String | N | 0 : 보증보험, 1 : 현금예치 |
4-15 | grnOrcd | 보증기관코드 | String | N | |
4-16 | grnAmt | 보증금액 | bigint | N | |
4-17 | grnFromDt | 보증시작일자 | String | N | |
4-18 | grnToDt | 보증종료일자 | String | N | |
4-19 | emlSndrAdr | 이메일발송주소 | String | N | 고객안내메일발송 시 별도의 이메일 주소를 사용할 경우 입력 |
4-20 | rsvgRate | 적립율 | double | N |
{
"sucsFalr": "성공 실패 여부",
"rsltCd": "응답 코드",
"rsltMesg": "응답 메시지",
"rsltObj": {
"uscoSno": "이용사일련번호",
"uscoNm": "이용사명",
"uscoStcd": "이용사상태코드",
"bzprNo": "사업자번호",
"rpsrNm": "대표자명",
"rpstTlno": "대표전화번호",
"rpsrEml": "대표이메일",
"rpsrMbtlNo": "대표휴대전화번호",
"zip": "우편번호",
"adr": "주소",
"dtlAdr": "상세주소",
"bztpCd": "업종코드",
"bscnNm": "업태명",
"grmnKdcd": "보증금종류코드",
"grnOrcd": "보증기관코드",
"grnAmt": "보증금액",
"grnFromDt": "보증시작일자",
"grnToDt": "보증종료일자",
"emlSndrAdr": "이메일발송주소",
"rsvgRate": "적립율"
}
}
JSON
복사