NAV Navbar
javascript JSON

Introduction

Spreadit과 P2P 금융 얼라이언스사의 연동을 위한 API 개발 가이드

ex)

개발인터페이스 URL 실제인터페이스 URL
{AllianceAddress} {AllianceAddress}
https://spreadit.co.kr/mrif/zper/ https://spreadit.co.kr/mrif/zper/

회원

회원가입여부조회

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "MMBR0001");
        comAjax.addParam("CI", email);
        comAjax.addParam("SSN_NO", bizNo);
        comAjax.addParam("CRPRTN_NO", crprtnNo);
        comAjax.addParam("BIZ_NO", paswdVal);
        comAjax.setCallback("fn_MMBR0001Callback");
        comAjax.ajax();
{
 "MMBR_NM":"테스터",
 "MMBR_YN":"Y",
 "MMBR_ID":"1000000290",
 "EMAIL":"tester@hashgrab.co.kr"
}

MMBR0001 : 얼라이언스의 투자자 가입여부 확인을 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true MMBR0001
CI true CI
SSN_NO true 주민등록번호
CRPRTN_NO true 법인번호
BIZ_NO true 사업자등록번호

Response Query Parameters

Parameter Default Description
MMBR_YN true 가입여부
MMBR_NM true 회원명
MMBR_ID true 회원ID
EMAIL true 이메일

회원가입

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "MMBR0002");
        comAjax.addParam("MMBR_NM", "테스터");
        comAjax.addParam("PSWD", "testeR%211234");
        comAjax.addParam("EMAIL", "tester@hashgrab.co.kr");
        comAjax.addParam("MMBR_TYPE_CD", "1");
        comAjax.addParam("MP_NO", "010********");
        comAjax.addParam("SSN_NO", "8301251******");
        comAjax.addParam("CRPRTN_NO", "110**********");
        comAjax.addParam("BIZ_NO", "834********");
        comAjax.addParam("CI", "Yo7***********");
        comAjax.addParam("WTHDRW_ACCNT_NM", "테스터");
        comAjax.addParam("WTHDRW_ACCNT_BNK_CD", "004");
        comAjax.addParam("WTHDRW_ACCNT_NO", "534514******");
        comAjax.setCallback("fn_MMBR0002Callback");
        comAjax.ajax();
{
 "VRTL_ACCNT_NM":"주미드테스터",
 "VRTL_ACCNT_BNK_CD":"010",
 "VRTL_ACCNT_NO":"123456789",
 "MMBR_ID":"1000000290"
}

MMBR0002 - 얼라이언스에 투자 회원으로 가입 요청을 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true MMBR0002
MMBR_NM true 회원명
PSWD true 비밀번호
EMAIL true 이메일
MMBR_TYPE_CD true 회원유형코드
MP_NO true 휴대전화번호
SSN_NO true 주민등록번호
CRPRTN_NO true 법인번호
BIZ_NO true 사업자등록번호
CI true CI
WTHDRW_ACCNT_NM true 출금계좌명
WTHDRW_ACCNT_BNK_CD true 출금계좌은행코드
WTHDRW_ACCNT_NO true 출금계좌번호

Response Query Parameters

Parameter Default Description
MMBR_ID true 회원ID
VRTL_ACCNT_NM true 가상계좌명
VRTL_ACCNT_BNK_CD true 가상계좌은행코드
VRTL_ACCNT_NO true 가상계좌번호

출금계좌변경

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "MMBR0003");
        comAjax.addParam("WTHDRW_ACCNT_NM", "테스터");
        comAjax.addParam("WTHDRW_ACCNT_NO", "534514443552");
        comAjax.addParam("PSWD", "testeR!1234");
        comAjax.addParam("WTHDRW_ACCNT_BNK_CD", "001");
    comAjax.addParam("MMBR_ID", "100000290");
        comAjax.setCallback("fn_MMBR0003Callback");
        comAjax.ajax();
{
}

MMBR0003 : 얼라이언스에 등록되어 있는 본인 명의의 출금계좌 변경 요청을 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true MMBR0002
MMBR_ID true 회원ID
WTHDRW_ACCNT_NM true 출금계좌명
WTHDRW_ACCNT_BNK_CD true 출금계좌은행코드
WTHDRW_ACCNT_NO true 출금계좌번호

투자자인증

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "MMBR0001");
        comAjax.addParam("MMBR_ID", "100000290");
        comAjax.addParam("MMBR_TYPE_CD", "1");
        comAjax.addParam("MP_NO", "0105444****");
        comAjax.addParam("SSN_NO", "8301251******");
    comAjax.addParam("CRPRTN_NO", "11011******");
        comAjax.addParam("BIZ_NO", "83455******");
        comAjax.addParam("CI", "Yo7c6NA6F5AZIMEKLYp***********");         
        comAjax.addParam("WTHDRW_ACCNT_NM", "테스터");        
        comAjax.addParam("WTHDRW_ACCNT_BNK_CD", "004");        
        comAjax.addParam("WTHDRW_ACCNT_NO", "534514******");           
        comAjax.setCallback("fn_MMBR0002Callback");
        comAjax.ajax();
{
  "VRTL_ACCNT_NO":"534514443552",
  "VRTL_ACCNT_BNK_CD":"004",
  "VRTL_ACCNT_NM":"주미드테스터"
}

MMBR0004 : 기 회원이지만 투자자 미인증(가상계좌, 출금계좌 미등록) 상태일 때 처리를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true MMBR0004
MMBR_ID true 회원ID
MMBR_TYPE_CD true 회원유형코드
MP_NO true 휴대전화번호
SSN_NO true 주민등록번호
CRPRTN_NO true 법인번호
BIZ_NO true 사업자등록번호
CI true CI
WTHDRW_ACCNT_NM true 출금계좌명
WTHDRW_ACCNT_BNK_CD true 출금계좌은행코드
WTHDRW_ACCNT_NO true 출금계좌번호

Response Query Parameters

Parameter Default Description
VRTL_ACCNT_NM true 가상계좌명
VRTL_ACCNT_BNK_CD true 가상계좌은행코드
VRTL_ACCNT_NO true 가상계좌번호

상품

상품목록조회

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "LOAN0001");
        comAjax.addParam("FRST_UPD_DHM", "201901181609");        
        comAjax.setCallback("fn_LOAN0001Callback");
        comAjax.ajax();
{
 "LOAN_LIST":[
  {
   "RPY_TYPE_CD":"1",
   "STTS_CD":"8",
   "LOAN_IMG_URL":"https:\/\/www.midrate.co.kr\/images\/invest\/invest_item_loanpurpose10.png",
   "LOAN_DTL_URL":"https:\/\/www.midrate.co.kr\/invest\/detail\/131",
   "LOAN_TYPE_CD":"10",
   "DLY_RATE":27.5,
   "INVST_CMMTN_RATE":0.0,
   "FRST_UPD_DHM":"201901231810",
   "INVST_AMT_UNIT":10000,
   "LOAN_ID":131,
   "APPLY_END_DHM":"",
   "GRD_NM":"06",
   "LOAN_NM":"사업자 사업자금",
   "INVST_END_DHM":"201802122359",
   "RND_CNT":4,
   "LOAN_RATE":6.23,
   "SFTY_TOOL_NM":"",
   "INVST_STRT_DHM":"201901231900",
   "LOAN_AMT":10000000,
   "INVST_AMT":0
  },
  {
   "RPY_TYPE_CD":"2",
   "STTS_CD":"6",
   "LOAN_IMG_URL":"https:\/\/www.midrate.co.kr\/images\/invest\/invest_item_loanpurpose99.png",
   "LOAN_DTL_URL":"https:\/\/www.midrate.co.kr\/invest\/detail\/135",
   "LOAN_TYPE_CD":"8",
   "DLY_RATE":20.0,
   "INVST_CMMTN_RATE":1.2000000476837158,
   "FRST_UPD_DHM":"201901231820",
   "INVST_AMT_UNIT":10000,
   "LOAN_ID":135,
   "APPLY_END_DHM":"201901231834",
   "GRD_NM":"20",
   "LOAN_NM":"개인신용 기타",
   "INVST_END_DHM":"201902062359",
   "RND_CNT":5,
   "LOAN_RATE":15.64,
   "SFTY_TOOL_NM":"",
   "INVST_STRT_DHM":"201901231900",
   "LOAN_AMT":5000000,
   "INVST_AMT":5000000
  },
  {
   "RPY_TYPE_CD":"1",
   "STTS_CD":"6",
   "LOAN_IMG_URL":"https:\/\/www.midrate.co.kr\/images\/investV2\/banner_fb_indvdlBiz.png",
   "LOAN_DTL_URL":"https:\/\/www.midrate.co.kr\/invest\/detail\/136",
   "LOAN_TYPE_CD":"10",
   "DLY_RATE":20.0,
   "INVST_CMMTN_RATE":1.2000000476837158,
   "FRST_UPD_DHM":"201901241743",
   "INVST_AMT_UNIT":10000,
   "LOAN_ID":136,
   "APPLY_END_DHM":"201901241747",
   "GRD_NM":"05",
   "LOAN_NM":"브롱스 도촌점",
   "INVST_END_DHM":"201902072359",
   "RND_CNT":3,
   "LOAN_RATE":12.0,
   "SFTY_TOOL_NM":"",
   "INVST_STRT_DHM":"201901241800",
   "LOAN_AMT":3000000,
   "INVST_AMT":3000000
  },
  {
   "RPY_TYPE_CD":"1",
   "STTS_CD":"7",
   "LOAN_IMG_URL":"https:\/\/www.midrate.co.kr\/images\/invest\/invest_item_loanpurpose01.png",
   "LOAN_DTL_URL":"https:\/\/www.midrate.co.kr\/invest\/detail\/137",
   "LOAN_TYPE_CD":"4",
   "DLY_RATE":20.0,
   "INVST_CMMTN_RATE":1.2000000476837158,
   "FRST_UPD_DHM":"201901251457",
   "INVST_AMT_UNIT":10000,
   "LOAN_ID":137,
   "APPLY_END_DHM":"201901251550",
   "GRD_NM":"02",
   "LOAN_NM":"백사장님의 대출",
   "INVST_END_DHM":"201902082359",
   "RND_CNT":2,
   "LOAN_RATE":14.0,
   "SFTY_TOOL_NM":"",
   "INVST_STRT_DHM":"201901251500",
   "LOAN_AMT":3000000,
   "INVST_AMT":3000000
  },
  {
   "RPY_TYPE_CD":"1",
   "STTS_CD":"2",
   "LOAN_IMG_URL":"https:\/\/www.midrate.co.kr\/images\/invest\/invest_item_loanpurpose10.png",
   "LOAN_DTL_URL":"https:\/\/www.midrate.co.kr\/invest\/detail\/138",
   "LOAN_TYPE_CD":"6",
   "DLY_RATE":20.0,
   "INVST_CMMTN_RATE":0.0,
   "FRST_UPD_DHM":"201902151029",
   "INVST_AMT_UNIT":10000,
   "LOAN_ID":138,
   "APPLY_END_DHM":"",
   "GRD_NM":"04",
   "LOAN_NM":"뉴질랜드소고기",
   "INVST_END_DHM":"201903012359",
   "RND_CNT":5,
   "LOAN_RATE":11.0,
   "SFTY_TOOL_NM":"",
   "INVST_STRT_DHM":"201902150000",
   "LOAN_AMT":1000000,
   "INVST_AMT":0
  },
  {
   "RPY_TYPE_CD":"1",
   "STTS_CD":"3",
   "LOAN_IMG_URL":"https:\/\/www.midrate.co.kr\/images\/investV2\/banner_fb_meat.png",
   "LOAN_DTL_URL":"https:\/\/www.midrate.co.kr\/invest\/detail\/139",
   "LOAN_TYPE_CD":"6",
   "DLY_RATE":20.0,
   "INVST_CMMTN_RATE":0.0,
   "FRST_UPD_DHM":"201902191643",
   "INVST_AMT_UNIT":10000,
   "LOAN_ID":139,
   "APPLY_END_DHM":"",
   "GRD_NM":"02",
   "LOAN_NM":"호주소고기",
   "INVST_END_DHM":"201903012359",
   "RND_CNT":3,
   "LOAN_RATE":10.0,
   "SFTY_TOOL_NM":"",
   "INVST_STRT_DHM":"201902150000",
   "LOAN_AMT":500000,
   "INVST_AMT":490000
  }
 ]
}

LOAN0001 : 조건에 따른 상품목록 조회를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true LOAN0001
FRST_UPD_DHM true 시작수정일시분

Response Query Parameters

LOAN_LIST

Parameter Default Description
LOAN_ID true 상품ID
LOAN_NM true 상품명
LOAN_TYPE_CD true 상품유형코드
LOAN_RATE true 상품이율
DLY_RATE true 연체이율
INVST_CMMTN_RATE true 투자수수료율
INVST_AMT_UNIT true 투자금액단위
RPY_TYPE_CD true 상환유형코드
RND_CNT true 회차 수
LOAN_AMT true 상품금액
INVST_AMT true 투자금액
INVST_STRT_DHM true 투자시작일시분
INVST_END_DHM true 투자종료일시분
APPLY_END_DHM true 모집종료일시분
STTS_CD true 상태코드
LOAN_IMG_URL true 상품이미지URL
LOAN_DTL_URL true 상품상세URL
GRD_NM true 등급명
SFTY_TOOL_NM true 안전장치명
FRST_UPD_DHM true 시작수정일시분

상환정보조회

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "LOAN0002");
        comAjax.addParam("FRST_UPD_DHM", "201903181609");
        comAjax.setCallback("fn_LOAN0002Callback");
        comAjax.ajax();
{
  "RPY_LIST":[
    {
     "DLY_YN":"N",
     "DAY_CNT":"28",
     "RL_RPY_AMT":0,
     "RPY_YN":"N",
     "RND":5,
     "EXPCT_RPY_PRNCPL_AMT":500000,
     "RL_RPY_INTRST_AMT":0,
     "RL_DLY_INTRST_AMT":0,
     "LOAN_ID":139,
     "DLY_DAY_CNT":0,
     "RL_RPY_DATE":"",
     "EXPCT_RPY_DATE":"20190716",
     "EXPCT_RPY_AMT":503973,
     "FRST_UPD_DHM":"201902271524",
     "RL_RPY_PRNCPL_AMT":0,
     "EXPCT_RPY_INTRST_AMT":3973
    },
    {
     "DLY_YN":"N",
     "DAY_CNT":"33",
     "RL_RPY_AMT":0,
     "RPY_YN":"N",
     "RND":4,
     "EXPCT_RPY_PRNCPL_AMT":0,
     "RL_RPY_INTRST_AMT":0,
     "RL_DLY_INTRST_AMT":0,
     "LOAN_ID":139,
     "DLY_DAY_CNT":0,
     "RL_RPY_DATE":"",
     "EXPCT_RPY_DATE":"20190617",
     "EXPCT_RPY_AMT":4384,
     "FRST_UPD_DHM":"201902271524",
     "RL_RPY_PRNCPL_AMT":0,
     "EXPCT_RPY_INTRST_AMT":4384
    },
    {
     "DLY_YN":"N",
     "DAY_CNT":"30",
     "RL_RPY_AMT":0,
     "RPY_YN":"N",
     "RND":3,
     "EXPCT_RPY_PRNCPL_AMT":0,
     "RL_RPY_INTRST_AMT":0,
     "RL_DLY_INTRST_AMT":0,
     "LOAN_ID":139,
     "DLY_DAY_CNT":0,
     "RL_RPY_DATE":"",
     "EXPCT_RPY_DATE":"20190516",
     "EXPCT_RPY_AMT":4110,
     "FRST_UPD_DHM":"201902271524",
     "RL_RPY_PRNCPL_AMT":0,
     "EXPCT_RPY_INTRST_AMT":4110
    },
    {
     "DLY_YN":"N",
     "DAY_CNT":"31",
     "RL_RPY_AMT":0,
     "RPY_YN":"N",
     "RND":2,
     "EXPCT_RPY_PRNCPL_AMT":0,
     "RL_RPY_INTRST_AMT":0,
     "RL_DLY_INTRST_AMT":0,
     "LOAN_ID":139,
     "DLY_DAY_CNT":0,
     "RL_RPY_DATE":"",
     "EXPCT_RPY_DATE":"20190416",
     "EXPCT_RPY_AMT":3973,
     "FRST_UPD_DHM":"201902271524",
     "RL_RPY_PRNCPL_AMT":0,
     "EXPCT_RPY_INTRST_AMT":3973
    },
    {
     "DLY_YN":"Y",
     "DAY_CNT":"28",
     "RL_RPY_AMT":0,
     "RPY_YN":"N",
     "RND":1,
     "EXPCT_RPY_PRNCPL_AMT":0,
     "RL_RPY_INTRST_AMT":0,
     "RL_DLY_INTRST_AMT":0,
     "LOAN_ID":139,
     "DLY_DAY_CNT":4,
     "RL_RPY_DATE":"",
     "EXPCT_RPY_DATE":"20190318",
     "EXPCT_RPY_AMT":4110,
     "FRST_UPD_DHM":"201902271524",
     "RL_RPY_PRNCPL_AMT":0,
     "EXPCT_RPY_INTRST_AMT":4110
    }
  ]
}

LOAN0002 : 상품의 상환 정보 조회 요청을 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true LOAN0002
FRST_UPD_DHM true 시작수정일시분

Response Query Parameters

RPY_LIST

Parameter Default Description
LOAN_ID true 상품ID
RND true 회차
DAY_CNT true 일수
EXPCT_RPY_DATE true 예상상환일
EXPCT_RPY_PRNCPL_AMT true 예상상환원금
EXPCT_RPY_INTRST_AMT true 예상상환이자
EXPCT_RPY_AMT true 예상상환금
DLY_YN true 연체여부
DLY_DAY_CNT true 연체일수
RPY_YN true 상환여부
RL_RPY_DATE true 실 상환일
RL_RPY_PRNCPL_AMT true 실 상환원금
RL_RPY_INTRST_AMT true 실 상환이자
RL_DLY_INTRST_AMT true 실 연체이자
RL_RPY_AMT true 실 상환금
FRST_UPD_DHM true 시작수정일시분

투자가능여부

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "LOAN0003");
        comAjax.addParam("LOAN_ID", "134" );
        comAjax.setCallback("fn_LOAN0003Callback");
        comAjax.ajax();
{
  "INVST_AVLBL_YN":"Y",
   "INVST_AVLBL_AMT":790000,
   "LOAN_ID":134
}

LOAN0003 : 투자가능한 상품인지를 건별 조회를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true LOAN0003
LOAN_ID true 상품ID

Response Query Parameters

Parameter Default Description
INVST_AVLBL_YN true 투자가능여부
INVST_AVLBL_AMT false 투자가능금액

예치금

가상계좌조회

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "DPST0001");
        comAjax.addParam("MMBR_ID", "100000290" );
        comAjax.setCallback("fn_DPST0001Callback");
        comAjax.ajax();
{
  "VRTL_ACCNT_NM":"주미드테스터",
  "VRTL_ACCNT_BNK_CD":"010",
  "VRTL_ACCNT_NO":"123456789"
}

DPST0001 : 얼라이언스에서 발급된 가상계좌 조회를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true DPST0001
MMBR_ID true 회원ID

Response Query Parameters

Parameter Default Description
VRTL_ACCNT_NM true 가상계좌명
VRTL_ACCNT_BNK_CD true 가상계좌은행코드
VRTL_ACCNT_NO true 가상계좌번호

예치금조회

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "DPST0002");
        comAjax.addParam("MMBR_ID", "100000290");
        comAjax.setCallback("fn_DPST0002Callback");
        comAjax.ajax();
{
  "DPST_AMT" : 0
}

DPST0002 : 얼라이언스의 투자자 예치금 잔액 조회를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true DPST0002
MMBR_ID true 100000290

Response Query Parameters

Parameter Default Description
DPST_AMT true 예치금

예치금 목록조회

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "DPST0003");
        comAjax.addParam("MMBR_ID", "tester1");
        comAjax.setCallback("fn_DPST0003Callback");
        comAjax.ajax();

    "{
     ""MMBR_ID_LIST"":[
      {
       ""MMBR_ID"":""100000291""
      },
      {
       ""MMBR_ID"":""100000291""
      }
     ]
    }"

{
 "DPST_AMT_LIST":[
  {
   "DPST_AMT":995754410,
   "MMBR_ID":"1000000083"
  },
  {
   "DPST_AMT":1000000000,
   "MMBR_ID":"1000000272"
  }
 ]
}

DPST0003 : 얼라이언스의 투자자 예치금 잔액목록 조회를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true MMBR0002
MMBR_ID true 회원ID

Response Query Parameters

Parameter Default Description
MMBR_ID true 회원ID
DPST_AMT true 예치금

예치금출금

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("MMBR_ID", "100000290");
        comAjax.addParam("WDTHRW_AMT", "40000");
        comAjax.setCallback("fn_DPST0004Callback");
        comAjax.ajax();
{
}

DPST0004 : 얼라이언스의 예치금 가상계좌에서 실계좌로 출금을 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true DPST0004
MMBR_ID true 회원ID
WDTHRW_AMT true 출금액

예치금이력조회

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "DPST0005");
        comAjax.addParam("MMBR_ID", "100000290");
        comAjax.addParam("MIN_TRNSFR_DATE", "20190301");
        comAjax.addParam("MAX_TRNSFR_DATE", "20190327");
        comAjax.setCallback("fn_DPST0005Callback");
        comAjax.ajax();
{
  "MMBR_ID":"1000000001",
  "MAX_TRNSFR_DATE":"20190327",
  "MIN_TRNSFR_DATE":"20190301"
}

DPST0005 : 얼라이언스의 예치금 이체이력 목록 조회를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true DPST0005
MMBR_ID true 회원ID
MIN_TRNSFR_DATE true 최소이체일자
MAX_TRNSFR_DATE true 최대이체일자

Response Query Parameters

TRNSFR_LIST

Parameter Default Description
TRNSFR_DATE true 이체일
TRNSFR_CD true 이체코드
TRNSFR_AMT true 이체금액

투자

투자가능금액조회

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "INVS0001");
        comAjax.addParam("MMBR_ID", "100000290");
        comAjax.addParam("LOAN_ID", "134");
        comAjax.setCallback("fn_INVS0001Callback");
        comAjax.ajax();

    {
      "INVST_LIST":[
        {
          "LOAN_ID":"122"
        },
        {
          "LOAN_ID":"135"
        }
      ],
      "MMBR_ID":"1000000083"
    }
{
 "INVST_LIST":[
  {
   "RSLT_CD":"F501",
   "INVST_AVLBL_AMT":0,
   "LOAN_ID":"122"
  },
  {
   "RSLT_CD":"F501",
   "INVST_AVLBL_AMT":0,
   "LOAN_ID":"135"
  }
 ]
}

INVS0001 : 얼라이언스에 투자자&상품별 투자가능금액 조회를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

INVST_LIST

Parameter Default Description
API_ID true INVS0001
MMBR_ID true 100000290
LOAN_ID true 134

Response Query Parameters

INVST_LIST

Parameter Default Description
LOAN_ID true 상품ID
RSLT_CD true 결과코드
INVST_AVLBL_AMT true 투자가능금액

투자요청

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "INVS0002");
        comAjax.addParam("LOAN_ID", "134");
        comAjax.addParam("MMBR_ID", "100000290");
        comAjax.addParam("INVST_AMT", "100000");
        comAjax.setCallback("fn_INVS0002Callback");
        comAjax.ajax();

    {
      "INVST_LIST":[
        {
          "MMBR_ID":"1000000290",
          "INVST_AMT":"10000"
        },
        {
          "MMBR_ID":"1000000291",
          "INVST_AMT":"20000"
        }
      ],

      "LOAN_ID":"134"
    }

{
 "INVST_LIST":[
  {
   "RSLT_CD":"F503",
   "MMBR_ID":"1000000290"
  },
  {
   "RSLT_CD":"F207",
   "MMBR_ID":"1000000291"
  }
 ]
}

INVS0002 : 얼라이언스에 투자 요청을 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

INVST_LIST

Parameter Default Description
API_ID true INVS0002
LOAN_ID true 상품ID
MMBR_ID true 회원ID
INVST_AMT true 투자금액

Response Query Parameters

INVST_LIST

Parameter Default Description
LOAN_ID true 상품ID
RSLT_CD true 결과코드
INVST_AVLBL_AMT true 투자가능금액

투자취소

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "INVS0003");
        comAjax.addParam("MMBR_ID", "100000290");
        comAjax.addParam("LOAN_ID", "134");
        comAjax.setCallback("fn_INVS0003Callback");
        comAjax.ajax();
{
}

INVS0003 : 얼라이언스에 투자 취소를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true INVS0003
MMBR_ID true 회원ID
LOAN_ID true 상품ID

투자목록조회

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "INVS0004");
        comAjax.addParam("MMBR_ID", "100000290");
        comAjax.addParam("LOAN_ID", "134");
        comAjax.addParam("FRST_UPD_DHM", "201903181609");
        comAjax.setCallback("fn_INVS0004Callback");
        comAjax.ajax();
{
 "INVST_LIST":[
  {
   "INVST_AMT":10000,
   "FRST_UPD_DHM":"201901231820",
   "LOAN_ID":135
  }
 ]
}

INVS0004 : 얼라이언스에 투자한 상품 목록 조회를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true INVS0004
MMBR_ID true 회원ID
LOAN_ID true 상품ID
FRST_UPD_DHM true 시작수정일시분

Response Query Parameters

INVST_LIST

Parameter Default Description
LOAN_ID true 상품ID
INVST_AMT true 투자금액
FRST_UPD_DHM true 시작수정일시분

투자상환목록조회

var comAjax = new ComAjax("form");
        comAjax.setUrl("<c:url value='/bo/sendIntrfc' />");
        comAjax.addParam("USER_ID", "admin");
        comAjax.addParam("API_ID", "INVS0005");
        comAjax.addParam("MMBR_ID", "1000000083");
        comAjax.addParam("FRST_UPD_DHM", "201802181609");
        comAjax.addParam("LOAN_ID", "115");
        comAjax.setCallback("fn_INVS0005Callback");
        comAjax.ajax();

    {
      "MMBR_ID":"1000000083",
      "FRST_UPD_DHM":"201802181609",
      "LOAN_ID":"115"
    }
{
 "INVST_RPY_LIST":[
  {
   "RL_RPY_AMT":11,
   "RND":"부분상환",
   "FRST_UPD_DHM":"201901171511",
   "RL_RPY_INTRST_AMT":1,
   "RL_DLY_INTRST_AMT":0,
   "RL_TAX_AMT":0,
   "LOAN_NO":115,
   "EXPCT_PRNCPL_DSTRBTN_AMT":10,
   "EXPCT_INTRST_DSTRBTN_AMT":1,
   "EXPCT_TAX_AMT":0,
   "EXPCT_RPY_AMT":11,
   "EXPCT_CMMTN_AMT":0,
   "RL_RPY_PRNCPL_AMT":10,
   "RL_CMMTN_AMT":0
  },
  {
   "RL_RPY_AMT":2815,
   "RND":"1",
   "FRST_UPD_DHM":"201901171514",
   "RL_RPY_INTRST_AMT":250,
   "RL_DLY_INTRST_AMT":324,
   "RL_TAX_AMT":150,
   "LOAN_ID":115,
   "EXPCT_PRNCPL_DSTRBTN_AMT":2391,
   "EXPCT_INTRST_DSTRBTN_AMT":250,
   "EXPCT_TAX_AMT":60,
   "EXPCT_RPY_AMT":2581,
   "EXPCT_CMMTN_AMT":0,
   "RL_RPY_PRNCPL_AMT":2391,
   "RL_CMMTN_AMT":0
  }
 ]
}

INVS0005 : 얼라이언스에 투자한 고객/상품별 상환정보 조회를 위한 API 입니다.

HTTP Request

GET https://{AllianceAddress}/bo/sendIntrfc

Request Query Parameters

Parameter Default Description
API_ID true INVS0005
MMBR_ID true 회원ID
LOAN_ID true 상품ID
FRST_UPD_DHM true 시작수정일시분

Response Query Parameters

INVST_RPY_LIST

Parameter Default Description
LOAN_ID true 상품ID
RND true 회차
EXPCT_RPY_PRNCPL_AMT true 예상상환원금
EXPCT_RPY_INTRST_AMT true 예상상환이자
EXPCT_TAX_AMT true 예상세금
EXPCT_CMMTN_AMT true 예상수수료
EXPCT_RPY_AMT true 예상상환금
RL_RPY_PRNCPL_AMT false 실 상환이자
RL_DLY_INTRST_AMT false 실 연체이자
RL_TAX_AMT false 실 세금
RL_CMMTN_AMT false 실 수수료
RL_RPY_AMT false 실 상환금
FRST_UPD_DHM true 시작수정일시분

Errors

The Spreadit API uses the following error codes:

Error Code Meaning About
S101 정상 처리
F101 미등록 API ID
F102 인증키 불일치 사전 발급된 인증키와 매칭되지 않습니다.
F103 응답 JSON 오류 응답 JSON가 정규화되지 않았을 때 오류입니다.
F105 커넥션 오류 얼라이언스 URL로 https 커넥션이 맺어지지 않을 때 오류입니다.
F104 응답 오류 정상적인 응답을 받지 못했을 때 오류입니다.
F201 이메일 중복 이미 가입된 이메일입니다.
F202 휴대전화번호 중복 이미 가입된 휴대전화번호입니다.
F203 주민등록번호 중복 이미 가입된 주민등록번호입니다.
F203 사업자등록번호 중복 이미 가입된 사업자등록번호입니다.
F204 CI 중복 이미 가입된 CI입니다. ※ 이 경우 기존 가입된 정보를 반환합니다.
F205 출금계좌정보 중복 이미 가입된 출금계좌정보입니다.
F206 가상계좌 발급 오류 가상계좌 발급시 오류가 발생했습니다.
F207 본인 확인 오류 존재하지 않는 고객입니다.
F208 본인계좌 인증 오류변경 요청된 출금계좌정보가 고객과 불일치할 때 발생하는 오류입니다.
F209 본인계좌 인증 불가능 계좌 본인인증이 불가능한 상태입니다.
F301 품ID 오류 존재하지 않는 상품ID입니다.
F401 가상계좌 미발급 예치금 가상계좌가 생성되지 않은 상태입니다.
F402 출금요청액 오류 출금요청액이 0이하입니다.
F403 출금요청시 예치금 부족 출금요청액이 예치금보다 많습니다.
F404 출금요청시 가상계좌잔액부족 출금요청액이 고객 가상계좌 잔액보다 많습니다.
F405 가상계좌 잔액 조회 오류 가상계좌 잔액 조회시 오류가 발생했습니다.
F406 가상계좌 출금 처리 오류 가상계좌 출금 처리시 오류가 발생했습니다.
F407 출금요청 정지 상태 출금요청이 정지된 상태입니다.
F408 출금요청 횟수 초과 출금요청 횟수가 초과되었습니다.
F501 상품정보 오류 상품정보가 존재하지 않습니다.
F502 투자 불가 투자요청이 불가능한 상품입니다.
F503 투자요청시 예치금 부족 투자요청액이 예치금보다 많습니다.
F504 주민등록번호 미등록 주민등록번호 또는 사업자번호가 등록되지 않았습니다.
F505 휴대전화번호 미등록 휴대전화번호가 등록되지 않았습니다.
F506 투자 가능금액 초과 투자 신청금액이 가능금액을 초과합니다.
F507 투자요청 오류 투자 요청시 오류가 발생했습니다.
F508 투자취소 오류 투자 취소시 오류가 발생했습니다.