시작하기
단말기로부터 발생한 매출 데이터와 가맹점 시스템과 연계할 수 있는 부가 서비스들을 API 형태로 제공합니다.
API는 유상과 무상 서비스로 나뉩니다.
- 유상: 당일 거래 포함한 아래 모든 서비스 제공
(단, 호출시간으로부터 최대5분 전거래까지 제공 - 카드사 응답 대기 최대 지연시간) - 무상: 최대 전일자의 마감된
마감정보일별 제공
지원 서비스
- 거래내역
- 거래 상세정보
- 마감정보
- 특정 일자의 마감된 거래들의 집계정보
- 상태정보
- 단말기의 상태정보 (1시간 마다 단말기에서 발송하는 상태정보 제공)
사전 준비 사항
유비씨엔 API를 사용하기 위해서는 먼저, 가맹점 고유번호인 company와 암호화 된 token을 발급받아야 합니다. 해당 정보는 유비씨엔 관리자에게 문의하여 발급받을 수 있습니다.
Request Schema
| Content-Type | company | token |
|---|---|---|
| application/json | 1 | KJK4X3RRpiTr/AjSBI0CeoD/dxT/4qi75NCWSnv1XmfS6ZPXjHOrn1DyOjj3Ig== |
API 호출 방법
API 호출 방법은 다음과 같습니다.
const API = axios.create({ baseURL: `http://api.ubcn.co.kr/api`, headers: { "Access-Control-Allow-Origin": "*", "company": "{company}", "token": "{token}", },});
//get, post 모두 지원합니다.const res = await API.get("{service}");console.log(res.data);
// 프로세스가 제대로 완료되지 않은 경우 에러 코드가 존재합니다.if (res.code != null) { return alert(res.decription);}