개발가이드

  • 개발가이드

법인카드 등록

신규 법인카드를 등록합니다.

정보

Method
URL
POST
https://apick.app/rest/add_card
신규 법인카드는 [마이페이지] -> [법인카드 관리] 탭에서 등록 가능합니다. 등록된 법인카드는 카드사를 통해 주기적(최소 10분)으로 스크래핑 하며 API 호출을 통해 사용 내역을 확인할 수 있습니다. 법인카드 정보는 암호화하여 저장하며 API 호출을 위한 스크래핑 용도 외에는 절대 사용되지 않습니다. 법인카드 삭제시 모든 정보가 완전히 삭제되며 복구 불가능합니다.(재등록 가능) 신규 법인카드 등록시 지난 1년간 카드 사용내역을 동기화 합니다. 신규 법인카드 등록시 최초 1회 업데이트에 한하여 최대 2~3일까지 소요될 수 있습니다.

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
company
String
O
[지원 카드사 선택]
국민카드
삼성카드
신한카드
우리카드
하나카드
롯데카드
현대카드
농협카드
비씨카드
card_num
String
O
카드번호 16자("-" 제거)
id
String
O
카드사 로그인용 ID
pw
String
O
카드사 로그인용 비밀번호

응답

Body
이름
타입
설명
data
Object
조회 데이터
error
String
에러 문구
result
Integer
1: 성공
0: 실패
card_id
Integer
카드 고유번호(관리용)
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/add_card" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "company={카드사}" \
-F "card_num=1111222233334444" \
-F "id={카드사 로그인용 ID}" \
-F "pw={카드사 로그인용 비밀번호}"
응답 예시

{
    "data": {
        "card_id": 15,
        "result": 1,
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 1000,
        "ms": 9,
        "pl_id": 434
    }
}
현재 페이지 북마크