{"_id":"@aodjo/gitfle-kakaopay","_rev":"3-97c93d0e0b508d33a39800c55b3f82c6","name":"@aodjo/gitfle-kakaopay","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@aodjo/gitfle-kakaopay","version":"1.0.0","keywords":["kakaopay","payment","korea","fintech"],"author":"","license":"MIT","_id":"@aodjo/gitfle-kakaopay@1.0.0","maintainers":[{"name":"aodjo","email":"me@junx.dev"}],"homepage":"https://github.com/gitfle/kakaopay#readme","bugs":{"url":"https://github.com/gitfle/kakaopay/issues"},"dist":{"shasum":"e08b1f2f90637372099f61ca4ee75a7ac6bddfa4","tarball":"https://registry.npmjs.org/@aodjo/gitfle-kakaopay/-/gitfle-kakaopay-1.0.0.tgz","fileCount":19,"integrity":"sha512-X/sgwdVWQ1eBqEVDz8dgdVz4KL+2ibMdBWHreP+ELs0TERZ8YXyhZBolNxxXIFLLWaGGABCR6CZiBNwpnp99cw==","signatures":[{"sig":"MEYCIQD7u5iJdUWOkGN9bLWYAsFKNnUNb3a1gxBVH3I1oZw8cQIhAOrRG0IPtsIXVhRcBHv8/Qt/dPLisBpMAGrIxcQPklKL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":67087},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"9b1a022e019e5d406b050bb5da6f9b3f4ff87b18","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist"},"_npmUser":{"name":"aodjo","email":"me@junx.dev"},"repository":{"url":"git+https://github.com/gitfle/kakaopay.git","type":"git"},"_npmVersion":"10.9.4","description":"KakaoPay payment API client for Node.js","directories":{},"_nodeVersion":"22.22.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^25.2.3"},"_npmOperationalInternal":{"tmp":"tmp/gitfle-kakaopay_1.0.0_1772903538261_0.7804041810073932","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aodjo/gitfle-kakaopay","version":"1.0.1","keywords":["kakaopay","payment","korea","fintech"],"author":"","license":"MIT","_id":"@aodjo/gitfle-kakaopay@1.0.1","maintainers":[{"name":"aodjo","email":"me@junx.dev"}],"homepage":"https://github.com/aodjo/gitfle-kakaopay#readme","bugs":{"url":"https://github.com/aodjo/gitfle-kakaopay/issues"},"dist":{"shasum":"36471a9b2e4ea0f169f52d7d3ccad13ac75b6fc5","tarball":"https://registry.npmjs.org/@aodjo/gitfle-kakaopay/-/gitfle-kakaopay-1.0.1.tgz","fileCount":19,"integrity":"sha512-bRKmY9TyZjUWjeKum/9lsaJnGb+96uR2kqm8yOUPMECjo3HvFt3INzufe6EEU23hXGW/Sqr5uPOmoafzz5Mv/Q==","signatures":[{"sig":"MEYCIQCDKYv4Vxo0p9V3vleNRYVLXs9Ix6OfLmNPOOr1BGXSowIhAJVi3KCNgh9CVrGar/OM7UH7tJoyglxe0SAzY53gIbVM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":67093},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"de5b4f771655f09dfdeca0136f22fded431bbf06","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist"},"_npmUser":{"name":"aodjo","email":"me@junx.dev"},"repository":{"url":"git+https://github.com/aodjo/gitfle-kakaopay.git","type":"git"},"_npmVersion":"10.9.4","description":"KakaoPay payment API client for Node.js","directories":{},"_nodeVersion":"22.22.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^25.2.3"},"_npmOperationalInternal":{"tmp":"tmp/gitfle-kakaopay_1.0.1_1772903749124_0.2000495529505686","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@aodjo/gitfle-kakaopay","version":"1.0.2","description":"KakaoPay payment API client for Node.js","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc","dev":"tsc --watch","clean":"rm -rf dist"},"keywords":["kakaopay","payment","korea","fintech"],"author":"","license":"MIT","repository":{"type":"git","url":"git+https://github.com/aodjo/gitfle-kakaopay.git"},"devDependencies":{"@types/node":"^25.2.3","typescript":"^5.0.0"},"_id":"@aodjo/gitfle-kakaopay@1.0.2","gitHead":"3ba7731d1705dcea08117c3060e5835c1f486be6","bugs":{"url":"https://github.com/aodjo/gitfle-kakaopay/issues"},"homepage":"https://github.com/aodjo/gitfle-kakaopay#readme","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-Q+2ji+EfonekXJdLNgyGFuj+LTUGVr2c4RFA6Dv9M4A0uxsTeBW7rQuSkLpctZs2vsL2S2sZN3Jw9LR0VX4cEQ==","shasum":"ef23ff2c49349c5913943d3a7b3cb3973d6aefae","tarball":"https://registry.npmjs.org/@aodjo/gitfle-kakaopay/-/gitfle-kakaopay-1.0.2.tgz","fileCount":19,"unpackedSize":67107,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCrChIXLnOwP4x2s8CjeRzM1+NSuCe9ZiHK5wGYr7CrIwIgQzTBpbz4NJ7prWBnpW8OSfMQf99bKGBIpDV3ZrS/fgI="}]},"_npmUser":{"name":"aodjo","email":"me@junx.dev"},"directories":{},"maintainers":[{"name":"aodjo","email":"me@junx.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gitfle-kakaopay_1.0.2_1772903870894_0.29956037925674606"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-07T17:12:18.155Z","modified":"2026-03-07T17:17:51.151Z","1.0.0":"2026-03-07T17:12:18.409Z","1.0.1":"2026-03-07T17:15:49.313Z","1.0.2":"2026-03-07T17:17:51.046Z"},"bugs":{"url":"https://github.com/aodjo/gitfle-kakaopay/issues"},"license":"MIT","homepage":"https://github.com/aodjo/gitfle-kakaopay#readme","keywords":["kakaopay","payment","korea","fintech"],"repository":{"type":"git","url":"git+https://github.com/aodjo/gitfle-kakaopay.git"},"description":"KakaoPay payment API client for Node.js","maintainers":[{"name":"aodjo","email":"me@junx.dev"}],"readme":"# Gitfle\r\n\r\n자신의 평소 코딩 습관을 진단 받아 보세요\r\n\r\n## 프로젝트 소개\r\n\r\n> 이 프로젝트는 [조코딩 x OpenAI x Primer AI 해커톤](https://hack.primer.kr/8)를 위해 제작되었습니다. <br/>\r\n> 이 레포지토리의 모든 저작물에 대한 저작권은 [Junsung Lee](https://junx.dev/)에 있습니다. (자세한 내용은 [LICENSE](/LICENSE)를 확인하세요) <br/>\r\n> 이 레포지토리는 [Junsung Lee](https://junx.dev/)에 의해 관리됩니다. <br/>\r\n> 이 레포지토리는 대회가 종료됨에 따라 26. 03. 08. 이후 Public Archive 처리 되었습니다. <br/>\r\n> 이 프로젝트에 관해 문의가 있으신가요? [me@junx.dev](mailto:me@junx.dev)를 통해 문의주세요.\r\n\r\n## Gitfle 소개\r\n\r\n- 본인의 Github으로 로그인을 하면, Gitfle 에서 본인의 레포지토리를 선택할 수 있어요.\r\n- 선택한 레포지토리를 AI Agent가 각각 탐색하면서 평가를 해요.\r\n- 각각의 Agent의 평가를 기반으로 최종 레포트와 학습 방향을 정리해 줘요.\r\n\r\n## 레포지토리 소개\r\n> 위 레포지토리는 `카카오페이 결제 API 클라이언트` 에 관해 다룹니다.\r\n> Gitfle 프로젝트의 레포지토리는 여러 레포지토리로 분리되어 있으며, 이 레포지토리는 그 중 하나에 속합니다. <br />\r\n> 자세한 내용은 아래 표를 확인하세요. (별(\\*)표는 현재 레포지토리를 의미합니다.)\r\n\r\n\r\n| Part | URL |\r\n| ----- | ----- |\r\n| client | [aodjo/gitfle-client](https://github.com/aodjo/gitfle-client) |\r\n| server | [aodjo/gitfle-server](https://github.com/aodjo/gitfle-server) |\r\n| payco | [aodjo/gitfle-payco](https://github.com/aodjo/gitfle-payco) |\r\n| naverpay | [aodjo/gitfle-naverpay](https://github.com/aodjo/gitfle-naverpay) |\r\n| \\*kakaopay | [aodjo/gitfle-kakaopay](https://github.com/aodjo/gitfle-kakaopay) |\r\n\r\n## 설치\r\n\r\n```bash\r\nnpm install @aodjo/gitfle-kakaopay\r\n```\r\n\r\n## 사용법\r\n\r\n### 초기화\r\n\r\n```typescript\r\nimport { KakaoPay } from '@aodjo/gitfle-kakaopay';\r\n\r\nconst kakaopay = new KakaoPay({\r\n  secretKey: process.env.KAKAOPAY_SECRET_KEY,\r\n  cid: 'TC0ONETIME',  // 테스트용 CID\r\n});\r\n```\r\n\r\n### 결제 준비\r\n\r\n```typescript\r\nconst ready = await kakaopay.ready({\r\n  partnerOrderId: 'order_123',\r\n  partnerUserId: 'user_456',\r\n  itemName: '코인 100개',\r\n  quantity: 1,\r\n  totalAmount: 8000,\r\n  taxFreeAmount: 0,\r\n  approvalUrl: 'http://example.com/payment/success',\r\n  cancelUrl: 'http://example.com/payment/cancel',\r\n  failUrl: 'http://example.com/payment/fail',\r\n});\r\n\r\n// PC: ready.nextRedirectPcUrl\r\n// Mobile: ready.nextRedirectMobileUrl\r\n// App: ready.nextRedirectAppUrl\r\n```\r\n\r\n### 결제 승인\r\n\r\n```typescript\r\nconst approve = await kakaopay.approve({\r\n  tid: ready.tid,\r\n  partnerOrderId: 'order_123',\r\n  partnerUserId: 'user_456',\r\n  pgToken: 'pg_token_from_callback',\r\n});\r\n\r\nconsole.log(approve.paymentMethodType);  // \"MONEY\" or \"CARD\"\r\nconsole.log(approve.amount.total);  // 8000\r\n```\r\n\r\n## 에러 처리\r\n\r\n```typescript\r\nimport { KakaoPayApiError, KakaoPayNetworkError } from 'gitfle-kakaopay';\r\n\r\ntry {\r\n  await kakaopay.ready({ ... });\r\n} catch (error) {\r\n  if (error instanceof KakaoPayApiError) {\r\n    console.log(error.errorCode);     // -731\r\n    console.log(error.errorMessage);  // \"invalid cid!\"\r\n    console.log(error.extras);        // 원천사 에러 정보\r\n  } else if (error instanceof KakaoPayNetworkError) {\r\n    console.log(error.message);\r\n  }\r\n}\r\n```\r\n\r\n## 테스트 정보\r\n\r\n- **CID**: `TC0ONETIME` (테스트용)\r\n- **Secret Key**: 카카오페이 개발자센터에서 발급받은 dev 키\r\n\r\n## API 문서\r\n\r\n- [카카오페이 개발자센터](https://developers.kakaopay.com/)\r\n- [단건 결제 API](https://developers.kakaopay.com/docs/payment/online/single-payment)\r\n\r\n\r\n\r\n## 라이선스\r\n\r\nMIT 라이선스입니다. 자세한 내용은 [LICENSE](/LICENSE)를 참고하세요.\r\n\r\n","readmeFilename":"README.md"}