개발가이드

  • 개발가이드

법인카드 승인내역 조회

법인카드의 거래 승인내역을 조회합니다.

정보

Method
URL
POST
https://apick.app/rest/search_card_pay
카드 사용내역은 최소 10분 간격으로 업데이트 됩니다. 카드 사용내역은 최신순으로 정렬됩니다. 검색일은 최대 1년을 초과할 수 없습니다. 검색 시작일 또는 종료일을 입력하지 않을 경우 자동으로 최근 3개월로 설정됩니다.

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
page
Integer
X
검색 페이지 번호
(미입력시 1로 설정)
card_id
Integer
X
카드 고유번호
(미입력시 모든 카드 일괄 검색)
start_date
String
X
검색 시작일
(ex, 2024-01-01)
미입력시 자동으로 지난 3개월 적용
end_date
String
X
검색 종료일
(ex, 2024-02-01)
미입력시 자동으로 지난 3개월 적용

응답

Body
이름
타입
설명
data
Object
조회 데이터
error
String
에러 문구
result
Integer
1: 성공
0: 실패
results
Array
법인카드 승인내역 목록
{}
Object
법인카드 승인내역
card_id
Integer
카드 고유번호
카드사
String
카드사
카드번호
String
카드번호
명칭
String
명칭
소속
String
소속
소속코드
String
소속코드
가맹점명
String
가맹점명
가맹점업종
String
가맹점업종
과세유형
String
과세유형
가맹점상태
String
가맹점상태
가맹점번호
String
가맹점번호
가맹점사업자번호
String
가맹점사업자번호
가맹점전환번호
String
가맹점전환번호
대표자성명
String
대표자성명
가맹점주소
String
가맹점주소
결제방법
String
결제방법
할부
String
할부
승인금액
Double
승인금액
부가세
Double
부가세
결제단위
String
결제단위
승인구분
String
승인구분
승인번호
String
승인번호
승인상태
String
승인상태
승인방식
String
승인방식
승인일시
String
승인일시
업데이트일시
String
업데이트일시
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/search_card_pay" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "page=1" \
-F "card_id=1234" \
-F "start_date=2023-01-01" \
-F "end_date=2024-01-01"
응답 예시

{
    "data": {
        "results": [
            {
                "카드사": "하나카드",
                "카드번호": "9440819001512345",
                "card_id": 4,
                "명칭": "공용",
                "소속": "주식회사 코드라인",
                "소속코드": "",
                "가맹점명": "매머드익스프레스에이스가산타워점",
                "가맹점업종": "커피전문점",
                "과세유형": "",
                "가맹점상태": "",
                "가맹점번호": "00123455922",
                "가맹점사업자번호": "893-18-011234",
                "가맹점전환번호": "070124520000",
                "대표자성명": "김연효",
                "가맹점주소": "(08505) 서울 금천구 디지털로 121, 1층 103호 (가산동,에이스가산타워)",
                "결제방법": "일시불",
                "할부": "-",
                "승인금액": 2700,
                "부가세": 245,
                "결제단위": "원",
                "승인구분": "국내",
                "승인번호": "33203123",
                "승인상태": "정상",
                "승인방식": "체크계좌승인",
                "승인일시": "2024-04-25 10:20:57",
                "업데이트일시": "2024-04-25 10:27:46"
            },
            {
                "카드사": "국민카드",
                "카드번호": "4265869312345847",
                "card_id": 1,
                "명칭": "공용",
                "소속": "주식회사 코드라인",
                "소속코드": "00000",
                "가맹점명": "우아한형제들",
                "가맹점업종": "전자상거래오픈마켓(4121)",
                "과세유형": "일반과세자",
                "가맹점상태": "정상",
                "가맹점번호": "112391398",
                "가맹점사업자번호": "120-87-12345",
                "가맹점전환번호": "0216123457",
                "대표자성명": "이*환",
                "가맹점주소": "서울 송파구 방이동 (방이동,장은빌딩)",
                "결제방법": "일시불",
                "할부": "-",
                "승인금액": 45800,
                "부가세": 4164,
                "결제단위": "원",
                "승인구분": "국내",
                "승인번호": "30041231",
                "승인상태": "정상",
                "승인방식": "해당무",
                "승인일시": "2024-04-24 21:36:04",
                "업데이트일시": "2024-04-24 21:44:07"
            },
            ...
        ],
        "count": 140,
        "result": 1,
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 40,
        "ms": 12,
        "pl_id": 10389507
    }
}
현재 페이지 북마크