{"id":48174,"library":"iamporter","title":"Iamporter","description":"Node.js REST API client for I'mport (아임포트), a Korean payment gateway integration service. Current stable version 1.4.2 with slow maintenance cadence. Provides Promise-based access to payment APIs including billing key management, subscription payments, and token auto-refresh. Uses custom IamporterError class for error handling. Written in ES6, supports Node >=4.","status":"maintenance","version":"1.4.2","language":"javascript","source_language":"en","source_url":"https://github.com/posquit0/node-iamporter","tags":["javascript","iamport","i'mport","importer","rest","api","client","creditcard","pay"],"install":[{"cmd":"npm install iamporter","lang":"bash","label":"npm"},{"cmd":"yarn add iamporter","lang":"bash","label":"yarn"},{"cmd":"pnpm add iamporter","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"HTTP client for REST API calls","package":"request","optional":false}],"imports":[{"note":"CommonJS only; no default export exists.","wrong":"import Iamporter from 'iamporter';","symbol":"Iamporter","correct":"const { Iamporter } = require('iamporter');"},{"note":"Destructure from the package; it's a named export.","wrong":"const IamporterError = require('iamporter');","symbol":"IamporterError","correct":"const { IamporterError } = require('iamporter');"},{"note":"Constructor expects an object, not positional arguments.","wrong":"const iamporter = new Iamporter('...', '...');","symbol":"new Iamporter()","correct":"const iamporter = new Iamporter({ apiKey: '...', secret: '...' });"}],"quickstart":{"code":"const { Iamporter } = require('iamporter');\n\nconst iamporter = new Iamporter({\n  apiKey: process.env.IAMPORT_API_KEY ?? '',\n  secret: process.env.IAMPORT_SECRET ?? ''\n});\n\n// Create a billing key (subscription)\niamporter.createSubscription({\n  customer_uid: 'test_customer',\n  card_number: '1234-1234-1234-1234',\n  expiry: '2029-12',\n  birth: '900101',\n  pwd_2digit: '12'\n}).then(result => {\n  console.log('Billing key created:', result.data);\n}).catch(err => {\n  if (err instanceof IamporterError) {\n    console.error('Iamporter error:', err.message);\n  }\n});\n\n// Pay with billing key\niamporter.paySubscription({\n  customer_uid: 'test_customer',\n  merchant_uid: 'order_123',\n  amount: 15000\n}).then(result => {\n  console.log('Payment success:', result.data);\n}).catch(err => console.error(err));","lang":"javascript","description":"Shows how to instantiate Iamporter, create a billing key, and make a subscription payment."},"warnings":[{"fix":"Monitor for updates; no migration path provided yet.","message":"The 'request' library is deprecated; Iamporter v1.4.2 uses it internally.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Use new Iamporter({ apiKey: '...', secret: '...' })","message":"Constructor expects object with apiKey and secret; passing strings directly will fail.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"No action needed; request is a dependency.","message":"Iamporter requires a globally installed request module? No, it's bundled.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"","message":"Iamporter uses callbacks internally? No, Promise-based.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.4.2':19 '4':55 'access':28 'api':4,31,62 'auto':41 'auto-refresh':40 'base':27 'bill':33 'cadenc':23 'class':46 'client':5,63 'creditcard':64 'current':16 'custom':44 'error':48 'es6':52 'gateway':13 'handl':49 'iamport':1,57 'iamportererror':45 'import':60 'includ':32 'integr':14 'javascript':56 'key':34 'korean':11 'mainten':22 'manag':35 'mport':8,59 'node':54 'node.js':2 'pay':65 'payment':12,30,37 'promis':26 'promise-bas':25 'provid':24 'refresh':42 'rest':3,61 'servic':15 'slow':21 'stabl':17 'subscript':36 'support':53 'token':39 'use':43 'version':18 'written':50 '아임포트':9","created_at":"2026-06-07T16:55:17.150708+00:00","updated_at":"2026-06-07T16:55:17.150708+00:00","problems":[{"fix":"Use const { Iamporter } = require('iamporter');","cause":"Incorrect import (default import instead of destructured named export).","error":"TypeError: Iamporter is not a constructor"},{"fix":"Check internet connectivity and verify the I'mport service status.","cause":"Network issue or incorrect API endpoint.","error":"Error: getaddrinfo ENOTFOUND api.iamport.kr"},{"fix":"Verify your IAMPORT_API_KEY and IAMPORT_SECRET environment variables.","cause":"Invalid API key or secret.","error":"IamporterError: {code: -1, message: '인증실패'}"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/posquit0/node-iamporter#readme","github":"https://github.com/posquit0/node-iamporter","docs":null,"changelog":null,"pypi":null,"npm":"iamporter","openapi_spec":null,"status_page":null,"smithery":null,"categories":["payments"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}