NodeJS용 아임포트 REST API Client 입니다.
최신 버전은 v0.9.12입니다.
아래 명령어를 통해 iamport-rest-client-nodejs를 귀하의 nodeJS 프로젝트에 추가합니다.
$ npm install iamport-rest-client-nodejs
아래는 iamport-rest-client-nodejs를 활용해 은행 정보 조회 API를 호출하는 예제 코드입니다.
// 1. 아임포트 REST API 호출에 필요한 모듈을 불러옵니다.
import { Iamport, Request, Enum } from 'iamport-rest-client-nodejs';
const { Banks } = Request;
const { BankCodeEnum } = Enum;
// 2. 아임포트 객체를 생성합니다. 귀하의 API 정보는 아임포트 관리자페이지 > 시스템설정 > 내정보를 참고해주세요.
const iamport = new Iamport({
apiKey: '귀하의_REST_API_KEY를_입력해주세요',
apiSecret: '귀하의_REST_API_SECRET_KEY를_입력해주세요',
});
// EX1. 모든 은행 정보를 조회합니다.
const getBanks = Banks.getBanks();
getBanks.request(iamport)
.then(response => console.log('response: ', response.data))
.catch(error => console.log('error: ', error.response.data));
// EX2. 특정 은행 정보를 조회합니다.
const getBank = Banks.getBank({
code: BankCodeEnum.SC,
});
await getBank.request(iamport)
.then(response => console.log('response: ', response.data))
.catch(error => console.log('error: ', error.response.data));프로젝트를 클론 받은 후 필요한 모듈을 설치합니다. yan example 명령어를 통해 테스트할 타깃, REST API 키 그리고 REST API SECRET 키를 입력합니다.
$ git clone https://github.com/SoleeChoi/iamport-rest-client-nodejs.git
$ cd ./iamport-rest-client-nodejs
$ npm install
$ yarn example [테스트 타깃] [apiKey] [apiSecret]
테스트 타깃의 종류는 아래와 같습니다.
| 타깃 | 내용 |
|---|---|
| authenticate | 사용자 인증 테스트 |
| payments | 일반결제 테스트 |
| prepare | 결제 예정 금액 등록 및 조회 테스트 |
| escrows | 에스크로 결제 테스트 |
| vbanks | 가상계좌 테스트 |
| subscribe | 정기결제 테스트 |
| customers | 빌링키 테스트 |
| payco | 페이코 테스트 |
| kakao | 카카오페이 테스트 |
| naverco | 네이버페이 주문형 테스트 |
| naverpay | 네이버페이 결제형 테스트 |
| receipts | 현금영수증 테스트 |
| external | 현금결제 영수증 테스트 |
| certifications | 휴대폰 본인인증 테스트 |
| cards | 금융결제원 카드사 코드 테스트 |
| banks | 금융결제원 은행 코드 테스트 |
| enum | ENUM 테스트 |
REST API 키와 REST API SECRET 키는 아임포트 관리자페이지 > 시스템 설정 > 내정보에서 확인하실 수 있습니다. 자세한 정보는 가맹점 정보 확인하기를 참고해주세요.
미입력시 아임포트 테스트용 REST API 키와 REST API SECRET 키로 테스트가 진행됩니다.
테스트 예시는 아래와 같습니다.
$ npm install
$ yarn example payments imp_apikey ekKoeW8RyKuT0zgaZsUtXXTLQ4AhPFW3ZGseDA6bkA5lamv9OqDMnxyeB9wqOsuO9W3Mx9YSJ4dTqJ3f