오픈API

카드 이용내역 조회 v1.0.0

카드 이용내역 조회 v1.0.0

API개요

API개요(API 명, API 설명, URL, HTTP Method, OAuth 2.0, 제3자 정보제공 동의) 표
API 명 카드 이용내역 조회
API 설명 카드 이용내역 조회
URL /ibk/biz/bizOapiAthzHstInq
HTTP Method POST
OAuth 2.0 Y
제3자 정보제공 동의 비대상
이용금액 별도협의

Request Header

항목명 필드명 데이터타입 길이 Scale 필수여부 설명
오픈API사용자일련번호oapiusersrnNumber100

클라이언트ID

X-IBK-Client-Id

String

32

0

클라이언트Sceret

X-IBK-Client-Secret

String

320

Authorization

Authorization

String

40000

Request Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1오픈API카드대체번호oapiCardAltrNoString200
1조회시작년월일insgYmdString80
1조회종료년월일inqFnshYmdString80
1승인목록NEXTKEY승인년월일athsListNextkeyAthzYmdString80
1승인목록NEXTKEY승인시각athsListNextkeyAthzHmsString60
1승인목록NEXTKEY카드번호athsListNextkeyCdnString160
1승인목록NEXTKEY승인번호athsListNextkeyApnString200
1페이지 요청건수pageInqNbiNumber50

Request Sample

{
  "wonPprdUseTlsmAmt" : 0.0,
  "frcyPprdUseTlsmAmt" : 0.0,
  "wonLspSumAmt" : 0.0,
  "frcyLspSumAmt" : 0.0,
  "wonInslAmt" : 0.0,
  "wonCsrvAmt" : 0.0,
  "frcyCsrvAmt" : 0.0,
  "wonOvrsCawtAmt" : 0.0,
  "frcyOvrsCawtAmt" : 0.0,
  "athsListNextkeyAthzYmd" : "sample_athsListNextkeyAthzYmd",
  "athsListNextkeyAthzHms" : "sample_athsListNextkeyAthzHms",
  "athsListNextkeyCdn" : "sample_athsListNextkeyCdn",
  "athsListNextkeyApn" : "sample_athsListNextkeyApn",
  "pageInqNbi" : 0.0,
  "athsListRowcount" : 0.0,
  "athsList" : [ {
    "cdn" : "sample_cdn",
    "oapiCardAltrNo" : "sample_oapiCardAltrNo",
    "athzYmd" : "sample_athzYmd",
    "athzHms" : "sample_athzHms",
    "cnclYmd" : "sample_cnclYmd",
    "afstNm" : "sample_afstNm",
    "pdcdDcd" : "sample_pdcdDcd",
    "athzAmt" : 0.0,
    "inslTrm" : 0.0,
    "apn" : "sample_apn",
    "cnclAmt" : 0.0,
    "alncCdNm" : "sample_alncCdNm",
    "bngYmd" : "sample_bngYmd",
    "stsdYmd" : "sample_stsdYmd",
    "amslDscnAmt" : 0.0,
    "tpbcd" : "sample_tpbcd",
    "tpbcdNm" : "sample_tpbcdNm",
    "trnCrcd" : "sample_trnCrcd",
    "atplAthzAmt" : 0.0
  } ]
}

Response Header

Response Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1원화기간별사용총합계금액wonPprdUseTlsmAmtNumber193
1외화기간별사용총합계금액frcyPprdUseTlsmAmtNumber193
1원화일시불합계금액wonLspSumAmtNumber193
1외화일시불합계금액frcyLspSumAmtNumber193
1원화할부금액wonInslAmtNumber193
1원화현금서비스금액wonCsrvAmtNumber193
1외화현금서비스금액frcyCsrvAmtNumber193
1원화해외현금인출금액wonOvrsCawtAmtNumber193
1외화해외현금인출금액frcyOvrsCawtAmtNumber193
1승인목록NEXTKEY승인년월일athsListNextkeyAthzYmdString80
1승인목록NEXTKEY승인시각athsListNextkeyAthzHmsString60
1승인목록NEXTKEY카드번호athsListNextkeyCdnString160
1승인목록NEXTKEY승인번호athsListNextkeyApnString200
1페이지요청건수pageInqNbiNumber50
1승인목록배열athsListRowcountNumber50
1승인목록athsList

Array

00
2카드번호cdnString160
2오픈API카드대체번호oapiCardAltrNoString200
2승인년월일athzYmdString80
2승인시각athzHmsString60
2취소년월일cnclYmdString80
2가맹점명afstNmString500
2상품코드구분코드pdcdDcdString30
2승인금액athzAmtNumber193
2할부기간inslTrmNumber50
2승인번호apnString200
2취소금액cnclAmtNumber193
2제휴코드명alncCdNmString500
2매입년월일bngYmdString80
2결제예정년월일stsdYmdString80
2매출할인금액amslDscnAmtNumber150
2업종코드tpbcdString50
2업종코드명tpbcdNmString300
2거래통화코드trnCrcdString30
2현지승인금액atplAthzAmtNumber193

Response Sample

{
  "wonPprdUseTlsmAmt" : 0.0,
  "frcyPprdUseTlsmAmt" : 0.0,
  "wonLspSumAmt" : 0.0,
  "frcyLspSumAmt" : 0.0,
  "wonInslAmt" : 0.0,
  "wonCsrvAmt" : 0.0,
  "frcyCsrvAmt" : 0.0,
  "wonOvrsCawtAmt" : 0.0,
  "frcyOvrsCawtAmt" : 0.0,
  "athsListNextkeyAthzYmd" : "sample_athsListNextkeyAthzYmd",
  "athsListNextkeyAthzHms" : "sample_athsListNextkeyAthzHms",
  "athsListNextkeyCdn" : "sample_athsListNextkeyCdn",
  "athsListNextkeyApn" : "sample_athsListNextkeyApn",
  "pageInqNbi" : 0.0,
  "athsListRowcount" : 0.0,
  "athsList" : [ {
    "cdn" : "sample_cdn",
    "oapiCardAltrNo" : "sample_oapiCardAltrNo",
    "athzYmd" : "sample_athzYmd",
    "athzHms" : "sample_athzHms",
    "cnclYmd" : "sample_cnclYmd",
    "afstNm" : "sample_afstNm",
    "pdcdDcd" : "sample_pdcdDcd",
    "athzAmt" : 0.0,
    "inslTrm" : 0.0,
    "apn" : "sample_apn",
    "cnclAmt" : 0.0,
    "alncCdNm" : "sample_alncCdNm",
    "bngYmd" : "sample_bngYmd",
    "stsdYmd" : "sample_stsdYmd",
    "amslDscnAmt" : 0.0,
    "tpbcd" : "sample_tpbcd",
    "tpbcdNm" : "sample_tpbcdNm",
    "trnCrcd" : "sample_trnCrcd",
    "atplAthzAmt" : 0.0
  } ]
}

성공/실패 Case