Meter 집계 — Meter 구성에 따라 이벤트가 집계됩니다(Count, Sum, Max, Last).
백그라운드 worker 처리 — 매분 worker가 마지막 checkpoint 이후의 새 이벤트를 가져옵니다.
Credit 차감 — 집계된 사용량이 meter_units_per_credit rate를 사용하여 credit으로 변환되고 FIFO 순서(가장 먼저 만료되는 grant부터 사용)에 따라 차감됩니다.
초과 사용량 추적 — balance가 0이 되면 이후 사용량은 overage로 기록되며 구성된 동작(reset 시 면제, 다음 invoice에서 청구 또는 deficit으로 이월)에 따라 처리됩니다. balance가 소진되어도 Dodo Payments는 사용량을 차단하지 않습니다. 잔액이 0일 때 액세스를 중지하려면 애플리케이션에서 balance를 확인하세요.
Credit 차감은 비동기적으로 실행됩니다(약 1분마다). 이벤트 수집과 balance 차감 사이에 짧은 지연이 발생할 수 있습니다. 애플리케이션이 이 지연을 처리하도록 설계하고, 개별 요청의 액세스 제어를 위해 실시간 balance 확인에 의존하지 마세요.
다중 미터, 단일 크레딧 풀
동일한 product의 여러 Meter를 동일한 credit entitlement에 연결할 수 있습니다. 모든 Meter가 하나의 공유 balance에서 차감됩니다.예시: 두 개의 Meter가 있는 AI platform:
text.generation — 토큰 1,000개당 credit 1개
image.generation — 이미지당 credit 10개
둘 다 동일한 “AI Credits” 풀에서 차감되며 고객은 포털에서 하나의 통합된 잔액을 확인합니다.
미터별로 다른 meter_units_per_credit 요율을 사용하여 상대적인 비용을 표현하세요. 비용이 높은 작업(이미지 생성)은 비용이 낮은 작업(텍스트 완성)보다 크레딧당 미터 단위가 적습니다.
List Customer Ledger
고객의 전체 크레딧 차감 내역 보기.
Get Customer Balance
API를 통해 고객의 현재 크레딧 잔액 확인.
문제 해결
Events not appearing
이벤트 이름이 정확히 일치하는지 확인하세요(대소문자 구분)
Meter filter가 이벤트를 제외하고 있지 않은지 확인하세요
고객 ID가 계정에 존재하는지 확인하세요
테스트를 위해 일시적으로 filter를 비활성화하세요
Aggregation not working
Over Property가 metadata key와 정확히 일치하는지 확인하세요
문자열이 아닌 숫자를 사용하세요: tokens: 150, tokens: "150"가 아님
모든 이벤트에 필수 property를 포함하세요
Filters not working
대소문자가 정확히 일치하는지 확인하세요
데이터 type에 맞는 올바른 operator를 사용하세요
이벤트에 filter 대상 property가 포함되어 있는지 확인하세요
Wrong usage totals
실제로 수신된 이벤트 수를 확인하려면 Events 탭을 확인하세요
aggregation type을 확인하세요(Count와 Sum)
Sum 및 Max에 사용되는 값이 숫자인지 확인하세요
다음 단계
Send Events
애플리케이션에서 미터로 사용 이벤트 전송을 시작하세요.
View Blueprints
일반적인 사용 사례에 대해 기성 미터 구성을 사용하세요.
마지막 수정일 2026년 9월 26일
이 페이지가 도움이 되었나요?
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Dodo Payments Documentation","description":"Documentation for Dodo Payments — the all-in-one payments, billing, and merchant of record platform for SaaS, AI, and digital products.","colors":{"primary":"#779812","light":"#C6FE1E","dark":"#166534"},"logo":{"light":"https://mintcdn.com/dodopayments/nM_mJfYkri-OpC5M/logo/light.svg?fit=max\u0026auto=format\u0026n=nM_mJfYkri-OpC5M\u0026q=85\u0026s=23f7a052f7ecb9d6570b7c95ee359a97","dark":"https://mintcdn.com/dodopayments/nM_mJfYkri-OpC5M/logo/dark.svg?fit=max\u0026auto=format\u0026n=nM_mJfYkri-OpC5M\u0026q=85\u0026s=cd6c20238a54526436f21c43fee51b26"},"favicon":"https://mintcdn.com/dodopayments/doYQc9oUE-WNz0cs/favicon.svg?fit=max\u0026auto=format\u0026n=doYQc9oUE-WNz0cs\u0026q=85\u0026s=271c6cc8ce7d6bf4d7f2b9cca029e004","background":{"color":{"light":"#FFFFFF","dark":"#0D0D0D"}},"navbar":{"links":[{"icon":"link","href":"https://docs.dodopayments.com/llms-full.txt","label":"llms-full.txt"},{"icon":"discord","href":"https://discord.gg/bYqAp4ayYh","label":"Community"},{"icon":"house","href":"https://app.dodopayments.com/","label":"Dashboard"}]},"footer":{"socials":{"x":"https://x.com/dodopayments","linkedin":"https://linkedin.com/company/dodopayments","website":"https://dodopayments.com","discord":"https://discord.gg/bYqAp4ayYh","github":"https://github.com/dodopayments","instagram":"https://www.instagram.com/dodo.payments","facebook":"https://www.facebook.com/profile.php?id=61565515607280"}},"seo":{"metatags":{"og:site_name":"Dodo Payments Documentation","twitter:card":"summary_large_image"},"indexing":"navigable"},"fonts":{"heading":{"family":"ApfelGrotezk","weight":400,"source":"fonts/ApfelGrotezk-Regular.woff2","format":"woff2"},"body":{"family":"Inter","weight":400,"source":"fonts/Inter-Variable.woff2","format":"woff2"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":"introduction"},{"language":"es","href":"es/introduction"},{"language":"ar","href":"ar/introduction"},{"language":"fr","href":"fr/introduction"},{"language":"de","href":"de/introduction"},{"language":"id","href":"id/introduction"},{"language":"ja","href":"ja/introduction"},{"language":"ko","href":"ko/introduction"},{"language":"pt-BR","href":"pt-BR/introduction"},{"language":"vi","href":"vi/introduction"},{"language":"cn","href":"cn/introduction"},{"language":"hi","href":"hi/introduction"},{"language":"it","href":"it/introduction"},{"language":"sv","href":"sv/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dodopayments","hasAudioNarration":false,"actualSubdomain":"dodopayments","customDomains":["docs.dodopayments.com"],"gitSource":{"type":"github","owner":"dodopayments","repo":"dodo-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af61516aad23a11c9aa58ca","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"en","tag":"API Reference","count":181},{"language":"en","tag":"Docs","count":178},{"language":"ar","tag":"Docs","count":153},{"language":"cn","tag":"Docs","count":153},{"language":"de","tag":"Docs","count":153},{"language":"es","tag":"Docs","count":153},{"language":"fr","tag":"Docs","count":153},{"language":"hi","tag":"Docs","count":153},{"language":"id","tag":"Docs","count":153},{"language":"it","tag":"Docs","count":153},{"language":"ja","tag":"Docs","count":153},{"language":"ko","tag":"Docs","count":153},{"language":"pt-BR","tag":"Docs","count":153},{"language":"sv","tag":"Docs","count":153},{"language":"vi","tag":"Docs","count":153},{"language":"ar","tag":"API Reference","count":151},{"language":"cn","tag":"API Reference","count":151},{"language":"de","tag":"API Reference","count":151},{"language":"es","tag":"API Reference","count":151},{"language":"fr","tag":"API Reference","count":151},{"language":"hi","tag":"API Reference","count":151},{"language":"id","tag":"API Reference","count":151},{"language":"it","tag":"API Reference","count":151},{"language":"ja","tag":"API Reference","count":151},{"language":"ko","tag":"API Reference","count":151},{"language":"pt-BR","tag":"API Reference","count":151},{"language":"sv","tag":"API Reference","count":151},{"language":"vi","tag":"API Reference","count":151},{"language":"en","tag":"Features","count":87},{"language":"ar","tag":"Features","count":81},{"language":"cn","tag":"Features","count":81},{"language":"de","tag":"Features","count":81},{"language":"es","tag":"Features","count":81},{"language":"fr","tag":"Features","count":81},{"language":"hi","tag":"Features","count":81},{"language":"id","tag":"Features","count":81},{"language":"it","tag":"Features","count":81},{"language":"ja","tag":"Features","count":81},{"language":"ko","tag":"Features","count":81},{"language":"pt-BR","tag":"Features","count":81},{"language":"sv","tag":"Features","count":81},{"language":"vi","tag":"Features","count":81},{"language":"en","tag":"Integrate","count":75},{"language":"en","tag":"Changelog","count":66},{"language":"ar","tag":"Changelog","count":65},{"language":"cn","tag":"Changelog","count":65},{"language":"de","tag":"Changelog","count":65},{"language":"es","tag":"Changelog","count":65},{"language":"fr","tag":"Changelog","count":65},{"language":"hi","tag":"Changelog","count":65},{"language":"id","tag":"Changelog","count":65},{"language":"it","tag":"Changelog","count":65},{"language":"ja","tag":"Changelog","count":65},{"language":"ko","tag":"Changelog","count":65},{"language":"pt-BR","tag":"Changelog","count":65},{"language":"sv","tag":"Changelog","count":65},{"language":"vi","tag":"Changelog","count":65},{"language":"ar","tag":"Integrate","count":59},{"language":"cn","tag":"Integrate","count":59},{"language":"de","tag":"Integrate","count":59},{"language":"es","tag":"Integrate","count":59},{"language":"fr","tag":"Integrate","count":59},{"language":"hi","tag":"Integrate","count":59},{"language":"id","tag":"Integrate","count":59},{"language":"it","tag":"Integrate","count":59},{"language":"ja","tag":"Integrate","count":59},{"language":"ko","tag":"Integrate","count":59},{"language":"pt-BR","tag":"Integrate","count":59},{"language":"sv","tag":"Integrate","count":59},{"language":"vi","tag":"Integrate","count":59},{"language":"en","tag":"External Integrations","count":33},{"language":"ar","tag":"External Integrations","count":30},{"language":"cn","tag":"External Integrations","count":30},{"language":"de","tag":"External Integrations","count":30},{"language":"es","tag":"External Integrations","count":30},{"language":"fr","tag":"External Integrations","count":30},{"language":"hi","tag":"External Integrations","count":30},{"language":"id","tag":"External Integrations","count":30},{"language":"it","tag":"External Integrations","count":30},{"language":"ja","tag":"External Integrations","count":30},{"language":"ko","tag":"External Integrations","count":30},{"language":"pt-BR","tag":"External Integrations","count":30},{"language":"sv","tag":"External Integrations","count":30},{"language":"vi","tag":"External Integrations","count":30},{"language":"en","tag":"Webhooks","count":24},{"language":"ar","tag":"Webhooks","count":23},{"language":"cn","tag":"Webhooks","count":23},{"language":"de","tag":"Webhooks","count":23},{"language":"es","tag":"Webhooks","count":23},{"language":"fr","tag":"Webhooks","count":23},{"language":"hi","tag":"Webhooks","count":23},{"language":"id","tag":"Webhooks","count":23},{"language":"it","tag":"Webhooks","count":23},{"language":"ja","tag":"Webhooks","count":23},{"language":"ko","tag":"Webhooks","count":23},{"language":"pt-BR","tag":"Webhooks","count":23},{"language":"sv","tag":"Webhooks","count":23},{"language":"vi","tag":"Webhooks","count":23},{"language":"en","tag":"Guides","count":22},{"language":"ar","tag":"Guides","count":22},{"language":"cn","tag":"Guides","count":22},{"language":"de","tag":"Guides","count":22},{"language":"es","tag":"Guides","count":22},{"language":"fr","tag":"Guides","count":22},{"language":"hi","tag":"Guides","count":22},{"language":"id","tag":"Guides","count":22},{"language":"it","tag":"Guides","count":22},{"language":"ja","tag":"Guides","count":22},{"language":"ko","tag":"Guides","count":22},{"language":"pt-BR","tag":"Guides","count":22},{"language":"sv","tag":"Guides","count":22},{"language":"vi","tag":"Guides","count":22},{"language":"en","tag":"Entitlements","count":20},{"language":"ar","tag":"Entitlements","count":20},{"language":"cn","tag":"Entitlements","count":20},{"language":"de","tag":"Entitlements","count":20},{"language":"es","tag":"Entitlements","count":20},{"language":"fr","tag":"Entitlements","count":20},{"language":"hi","tag":"Entitlements","count":20},{"language":"id","tag":"Entitlements","count":20},{"language":"it","tag":"Entitlements","count":20},{"language":"ja","tag":"Entitlements","count":20},{"language":"ko","tag":"Entitlements","count":20},{"language":"pt-BR","tag":"Entitlements","count":20},{"language":"sv","tag":"Entitlements","count":20},{"language":"vi","tag":"Entitlements","count":20},{"language":"en","tag":"Invoices","count":17},{"language":"ar","tag":"Customers","count":16},{"language":"cn","tag":"Customers","count":16},{"language":"de","tag":"Customers","count":16},{"language":"es","tag":"Customers","count":16},{"language":"fr","tag":"Customers","count":16},{"language":"hi","tag":"Customers","count":16},{"language":"id","tag":"Customers","count":16},{"language":"it","tag":"Customers","count":16},{"language":"ja","tag":"Customers","count":16},{"language":"ko","tag":"Customers","count":16},{"language":"pt-BR","tag":"Customers","count":16},{"language":"sv","tag":"Customers","count":16},{"language":"vi","tag":"Customers","count":16}]},"assistantConfig":{"deflection":{"enabled":false,"email":"support@dodopayments.com","showHelpButton":true}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"#content-area{max-width:60rem}h1,h2,h3,h4,h5,h6{letter-spacing:0.05em!important}.welcome-page .card-group{margin:3rem auto 8rem;max-width:70rem;padding-left:1.25rem;padding-right:1.25rem}.welcome-page .card-group .card{padding:1rem}.welcome-hero{display:flex;flex-direction:column;align-items:center;justify-content:center;min-height:20vh;text-align:center;margin-top:3rem;margin-bottom:2.5rem}.welcome-hero h1{font-size:2.5rem;font-weight:700;margin-bottom:1rem;line-height:1.2;color:#fff}.welcome-hero p{font-size:1.25rem;max-width:600px;margin:0 auto}.welcome-hero h1{color:rgb(41 42 37 / 1)}.dark .welcome-hero h1{color:rgb(255 255 255 / 1)}.welcome-hero p{color:rgb(83 85 79 / 1)}.dark .welcome-hero p{color:rgb(162 164 158 / 1)}"}],"page":{"pagePath":"ko/features/usage-based-billing/meters","slug":"/ko/features/usage-based-billing/meters","pageMetadata":{"sidebarTitle":"미터","title":"미터","description":"원시 사용 이벤트를 집계 및 필터링을 통해 청구 가능한 수량으로 변환합니다.","icon":"sliders","keywords":["Dodo Payments","사용량 측정기","측정","소비 추적","aggregation"],"href":"/ko/features/usage-based-billing/meters"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"원시 사용 이벤트를 집계 및 필터링을 통해 청구 가능한 수량으로 변환합니다.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,Frame,Heading,Info,Mermaid,OptimizedImage,ParamField,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Meter는 원시 이벤트를 청구 가능한 수량으로 변환합니다. 이벤트를 필터링하고 집계 함수(Count, Sum, Max, Last)를 적용하여 고객별 사용량을 계산합니다.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-2.png?fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=f9d85a463fba231437151db3d4a2052a`,alt:`이벤트 이름, 집계 유형 및 필터링 옵션을 보여주는 미터 생성 인터페이스`,style:{maxHeight:`500px`,width:`auto`},\"data-og-width\":`2324`,width:`2324`,\"data-og-height\":`1600`,height:`1600`,\"data-path\":`images/usage-based/UBB-2.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-2.png?w=280\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=18fdbbf75ab4df7ede6c45f6e248b783 280w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-2.png?w=560\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=e404194a942a1276de7148f9b8eff36d 560w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-2.png?w=840\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=1bec71463cb2e00acd0841b9968f2b7e 840w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-2.png?w=1100\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=746ef8eb5f8bb76a355122d8253e9cba 1100w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-2.png?w=1650\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=8f10a20590e5c9056b9c7f285b827217 1650w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-2.png?w=2500\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=a503c04b328416b03f7e20dc6c4c0a28 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`api-리소스`,children:`API 리소스`}),`\n`,_jsx(AccordionGroup,{children:_jsx(Accordion,{title:`View Meter API References`,id:`view-meter-api-references`,children:_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Create Meter`,icon:`plus`,href:`/api-reference/meters/create-meter`,children:_jsx(_components.p,{children:`API를 통해 미터를 프로그램 방식으로 생성합니다.`})}),_jsx(Card,{title:`List Meters`,icon:`list`,href:`/api-reference/meters/get-meters`,children:_jsx(_components.p,{children:`계정의 모든 미터를 가져옵니다.`})}),_jsx(Card,{title:`Get Meter`,icon:`eye`,href:`/api-reference/meters/retrieve-meter`,children:_jsx(_components.p,{children:`ID로 특정 미터의 세부 정보를 가져옵니다.`})}),_jsx(Card,{title:`Archive Meter`,icon:`arrow-rotate-right`,href:`/api-reference/meters/archive-meter`,children:_jsx(_components.p,{children:`사용량 추적을 중지하려면 미터를 보관 처리합니다.`})}),_jsx(Card,{title:`Unarchive Meter`,icon:`arrow-rotate-left`,href:`/api-reference/meters/unarchive-meter`,children:_jsx(_components.p,{children:`보관 처리된 미터를 복원하여 추적을 재개합니다.`})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`미터-생성`,children:`미터 생성`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Basic Information`,children:[_jsx(ParamField,{path:`Meter Name`,type:`string`,required:true,id:`param-meter-name`,children:_jsx(_components.p,{children:`Meter를 설명하는 이름입니다(예: “API Requests”, “Token Usage”).`})}),_jsx(ParamField,{path:`Event Name`,type:`string`,required:true,id:`param-event-name`,children:_jsxs(_components.p,{children:[`일치시킬 정확한 이벤트 이름입니다(대소문자 구분). 예: `,_jsx(_components.code,{children:`api.call`}),`, `,_jsx(_components.code,{children:`image.generated`}),`.`]})})]}),_jsxs(Step,{title:`Aggregation`,children:[_jsxs(ParamField,{path:`Aggregation Type`,type:`string`,required:true,id:`param-aggregation-type`,children:[_jsx(_components.p,{children:`이벤트가 집계되는 방법을 선택하세요:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Count`}),`: 이벤트의 총 개수(API 호출, 업로드)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Sum`}),`: 숫자 값의 합계(토큰, 바이트)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Max`}),`: 해당 기간의 최댓값(최대 사용자 수)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Last`}),`: 가장 최근 값`]}),`\n`]})]}),_jsx(ParamField,{path:`Over Property`,type:`string`,id:`param-over-property`,children:_jsxs(_components.p,{children:[`집계할 metadata key입니다(Sum, Max, Last에 필요). 예: `,_jsx(_components.code,{children:`tokens`}),`, `,_jsx(_components.code,{children:`bytes`}),`, `,_jsx(_components.code,{children:`duration_ms`}),`.`]})}),_jsx(ParamField,{path:`Measurement Unit`,type:`string`,required:true,id:`param-measurement-unit`,children:_jsxs(_components.p,{children:[`인보이스와 리포트에 표시할 단위 레이블입니다. 예: `,_jsx(_components.code,{children:`calls`}),`, `,_jsx(_components.code,{children:`tokens`}),`, `,_jsx(_components.code,{children:`GB`}),`, `,_jsx(_components.code,{children:`hours`}),`.`]})})]}),_jsxs(Step,{title:`Filtering (Optional)`,children:[_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-3.png?fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=ce231b0559d31723bc12c22cd9ff9d64`,alt:`AND/OR 논리 및 비교 연산자를 사용하는 이벤트 필터링 인터페이스`,style:{maxHeight:`500px`,width:`auto`},\"data-og-width\":`1558`,width:`1558`,\"data-og-height\":`942`,height:`942`,\"data-path\":`images/usage-based/UBB-3.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-3.png?w=280\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=2cd814d88c0043f59bd0809f62a70932 280w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-3.png?w=560\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=6346cf2daf9635f53f9280701b1fefc2 560w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-3.png?w=840\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=d5b459ab63581aa80b9ddcd6a2d9be25 840w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-3.png?w=1100\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=95c547968201d65d65981b0dc6271c0a 1100w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-3.png?w=1650\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=52e270bd88d839ea0c148fcfadbbf7dd 1650w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-3.png?w=2500\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=f737d26f50ab2a4cc45cc03927936d4e 2500w`})}),_jsx(_components.p,{children:`어떤 이벤트가 계산될지를 필터링하기 위한 조건을 추가합니다:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`AND 논리`}),`: 모든 조건이 일치해야 함`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`OR 논리`}),`: 어떤 조건이든 일치할 수 있음`]}),`\n`]}),_jsx(_components.p,{children:`사용 가능한 비교 연산자: 같음, 같지 않음, 초과, 이상, 미만, 이하, 포함, 포함하지 않음.`}),_jsx(_components.p,{children:`필터링을 활성화하고 로직을 선택한 다음 property key, 비교 연산자, 값으로 조건을 추가합니다.`})]}),_jsx(Step,{title:`Create`,children:_jsxs(_components.p,{children:[`설정을 검토하고 `,_jsx(_components.strong,{children:`Create Meter`}),`를 클릭합니다.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`분석-보기`,children:`분석 보기`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-1.png?fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=7fb86a266b5aa84f281b680601bd998e`,alt:`사용량 개요, 이벤트 및 고객 데이터를 보여주는 Meter 분석 대시보드`,style:{maxHeight:`500px`,width:`auto`},\"data-og-width\":`1536`,width:`1536`,\"data-og-height\":`1252`,height:`1252`,\"data-path\":`images/usage-based/UBB-1.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-1.png?w=280\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=23a2bbb81a88052bec92772f03254690 280w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-1.png?w=560\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=b9ebba13d62c1e5e0470097382319a8c 560w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-1.png?w=840\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=2cb2348f913ebdc8175d07c533553d74 840w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-1.png?w=1100\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=84b14f137b8f737d8e269cb9c2213915 1100w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-1.png?w=1650\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=9059aafa1890c7a834a0acbd2a115567 1650w, https://mintcdn.com/dodopayments/w9oVTi6CzZMAOQA3/images/usage-based/UBB-1.png?w=2500\u0026fit=max\u0026auto=format\u0026n=w9oVTi6CzZMAOQA3\u0026q=85\u0026s=7a1008d882d31dc4699b07353c4121f6 2500w`})}),`\n`,_jsx(_components.p,{children:`Meter 대시보드에는 다음이 표시됩니다:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Overview`}),`: 시간에 따른 총 사용량 및 사용량 추이`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Events`}),`: 수신된 개별 이벤트와 해당 metadata`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Customers`}),`: 고객별 사용량 합계 및 요금`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`통화-대신-크레딧으로-청구`,children:`통화 대신 크레딧으로 청구`}),`\n`,_jsx(_components.p,{children:`기본적으로 Meter는 고객에게 달러(또는 설정한 통화)로 단위당 요금을 청구합니다. 대신 고객의 credit balance에서 차감하도록 Meter를 구성할 수 있으며, 이 경우 사용량이 금전적 요금을 발생시키는 대신 credit을 소모합니다.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Credit 기반 차감에는 동일한 product에 연결된 `,_jsx(_components.a,{href:`/features/credit-based-billing`,children:`Credit Entitlement`}),`이 필요합니다. 먼저 credit entitlement를 생성한 다음 Meter에 연결하세요.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`크레딧-기반-차감을-사용해야-할-때`,children:`크레딧 기반 차감을 사용해야 할 때`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Scenario`}),_jsx(_components.th,{children:`Standard (currency)`}),_jsx(_components.th,{children:`Credit-based`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`단순한 단위당 요금($0.01/call)`}),_jsx(_components.td,{children:`✅ 적합`}),_jsx(_components.td,{children:`불필요한 오버헤드`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`선불 credit pack(10K 토큰을 구매하여 시간에 따라 사용)`}),_jsx(_components.td,{children:`❌ 표현할 수 없음`}),_jsx(_components.td,{children:`✅ 적합`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`subscription이 포함된 번들 사용량(Pro plan에 100K 호출 포함)`}),_jsx(_components.td,{children:`free threshold를 통해 가능`}),_jsx(_components.td,{children:`✅ 더 적합: credit이 이월되고 만료되며 portal에 표시됨`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`하나의 credit pool을 공유하는 다중 Meter product`}),_jsx(_components.td,{children:`❌ 각 Meter가 별도로 청구됨`}),_jsx(_components.td,{children:`✅ 모든 Meter가 하나의 balance에서 차감됨`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`크레딧을-차감하도록-미터-구성하기`,children:`크레딧을 차감하도록 미터 구성하기`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create a Credit Entitlement`,children:[_jsxs(_components.p,{children:[`먼저 `,_jsx(_components.strong,{children:`Products → Credits`}),`에서 credit entitlement를 생성합니다. 단위(예: “API Calls”, “Tokens”), precision 및 lifecycle 설정(expiry, rollover, overage)을 정의합니다.`]}),_jsxs(_components.p,{children:[`자세한 지침은 `,_jsx(_components.a,{href:`/features/credit-based-billing`,children:`Credit-Based Billing guide`}),`를 참조하세요.`]})]}),_jsx(Step,{title:`Create or Edit a Usage-Based Product`,children:_jsxs(_components.p,{children:[`사용 기반 제품으로 이동하여 `,_jsx(_components.strong,{children:`Meter`}),` 구성 섹션을 엽니다.`]})}),_jsx(Step,{title:`Add a Meter`,children:_jsxs(_components.p,{children:[`미터를 연결하려면 `,_jsx(_components.strong,{children:`+`}),` 버튼을 클릭하세요. 이벤트 이름, 집계 유형, 측정 단위를 평소처럼 구성합니다.`]})}),_jsxs(Step,{title:`Enable 'Bill Usage in Credits'`,children:[_jsxs(_components.p,{children:[`Meter 구성에서 `,_jsx(_components.strong,{children:`Bill usage in Credits`}),`를 전환하여 credit 설정을 표시합니다:`]}),_jsx(Frame,{caption:`Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-5.jpg?fit=max\u0026auto=format\u0026n=ibNfoFRyCIGyt3pO\u0026q=85\u0026s=b4ef2fe5079cbf3bb39eb3814f101cbd`,alt:`크레딧에 사용량 청구 토글이 활성화된 미터 구성`,style:{maxHeight:`500px`,width:`auto`},\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`2282`,height:`2282`,\"data-path\":`images/CBB/Desktop - Attach Credit - UBB-5.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-5.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=ibNfoFRyCIGyt3pO\u0026q=85\u0026s=0f765142d0ca9ab3916a4f01d4ca170e 280w, https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-5.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=ibNfoFRyCIGyt3pO\u0026q=85\u0026s=6bf59eadfa5cd6c865d0ac90e760854b 560w, https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-5.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=ibNfoFRyCIGyt3pO\u0026q=85\u0026s=a995ab0ab4952c8cfd90279c2d6bf472 840w, https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-5.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=ibNfoFRyCIGyt3pO\u0026q=85\u0026s=7971d02b844038a9978418b23c7b8071 1100w, https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-5.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=ibNfoFRyCIGyt3pO\u0026q=85\u0026s=c69a3883012f141c59228a0fb3a7655f 1650w, https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-5.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=ibNfoFRyCIGyt3pO\u0026q=85\u0026s=68e2d8094dbec7704060f0a28ea10a2f 2500w`})}),_jsx(ParamField,{path:`Credit Entitlement`,type:`string`,required:true,id:`param-credit-entitlement`,children:_jsx(_components.p,{children:`이 Meter가 차감할 credit entitlement를 선택합니다.`})}),_jsxs(ParamField,{path:`Meter units per credit`,type:`number`,required:true,id:`param-meter-units-per-credit`,children:[_jsx(_components.p,{children:`1 크레딧을 차감하기 위해 필요한 사용 단위 수입니다. 예를 들어:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`1`}),` = 각 미터 이벤트가 1 크레딧을 차감`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`100`}),` = 100개의 미터 이벤트가 1 크레딧을 차감`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`1000`}),` = 1,000개의 API 호출이 1 크레딧을 소비`]}),`\n`]})]})]}),_jsxs(Step,{title:`Free Threshold and Credits`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Free Threshold`}),`는 금액으로 청구되는 Meter에 적용되며, credit으로 청구되는 Meter에는 적용되지 않습니다. Meter가 credit으로 청구되면 모든 단위가 credit 차감에 포함됩니다.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`예시`}),`: meter-units-per-credit가 1인 경우, API 호출을 2,500회 수행한 고객에게서 2,500 credit이 차감됩니다.`]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`크레딧-차감-작동-방식`,children:`크레딧 차감 작동 방식`}),`\n`,_jsx(_components.p,{children:`구성되면 차감 파이프라인이 자동으로 실행됩니다:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`이벤트 수신`}),` — 애플리케이션이 `,_jsx(_components.a,{href:`/features/usage-based-billing/event-ingestion`,children:`Event Ingestion API`}),`를 통해 사용량 이벤트를 전송합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Meter 집계`}),` — Meter 구성에 따라 이벤트가 집계됩니다(Count, Sum, Max, Last).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`백그라운드 worker 처리`}),` — 매분 worker가 마지막 checkpoint 이후의 새 이벤트를 가져옵니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Credit 차감`}),` — 집계된 사용량이 `,_jsx(_components.code,{children:`meter_units_per_credit`}),` rate를 사용하여 credit으로 변환되고 FIFO 순서(가장 먼저 만료되는 grant부터 사용)에 따라 차감됩니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`초과 사용량 추적`}),` — balance가 0이 되면 이후 사용량은 overage로 기록되며 구성된 동작(reset 시 면제, 다음 invoice에서 청구 또는 deficit으로 이월)에 따라 처리됩니다. balance가 소진되어도 Dodo Payments는 사용량을 차단하지 않습니다. 잔액이 0일 때 액세스를 중지하려면 애플리케이션에서 balance를 확인하세요.`]}),`\n`]}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[Usage Event] --> B[Meter Aggregation]\n B --> C{Credits Available?}\n C -->|Yes| D[Deduct from Balance]\n C -->|No| E{Overage Enabled?}\n E -->|Yes| F[Track Overage]\n E -->|No| G[Your App Enforces Limits]\n D --> H[Update Ledger]\n F --> H`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Credit 차감은 비동기적으로 실행됩니다(약 1분마다). 이벤트 수집과 balance 차감 사이에 짧은 지연이 발생할 수 있습니다. 애플리케이션이 이 지연을 처리하도록 설계하고, 개별 요청의 액세스 제어를 위해 실시간 balance 확인에 의존하지 마세요.`})}),`\n`,_jsx(Heading,{level:`3`,id:`다중-미터-단일-크레딧-풀`,children:`다중 미터, 단일 크레딧 풀`}),`\n`,_jsx(_components.p,{children:`동일한 product의 여러 Meter를 동일한 credit entitlement에 연결할 수 있습니다. 모든 Meter가 하나의 공유 balance에서 차감됩니다.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`예시`}),`: 두 개의 Meter가 있는 AI platform:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`text.generation`}),` — 토큰 1,000개당 credit 1개`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`image.generation`}),` — 이미지당 credit 10개`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`둘 다 동일한 “AI Credits” 풀에서 차감되며 고객은 포털에서 하나의 통합된 잔액을 확인합니다.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`미터별로 다른 `,_jsx(_components.code,{children:`meter_units_per_credit`}),` 요율을 사용하여 상대적인 비용을 표현하세요. 비용이 높은 작업(이미지 생성)은 비용이 낮은 작업(텍스트 완성)보다 크레딧당 미터 단위가 적습니다.`]})}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`List Customer Ledger`,icon:`scroll`,href:`/api-reference/credit-entitlements/list-customer-ledger`,children:_jsx(_components.p,{children:`고객의 전체 크레딧 차감 내역 보기.`})}),_jsx(Card,{title:`Get Customer Balance`,icon:`wallet`,href:`/api-reference/credit-entitlements/get-customer-balance`,children:_jsx(_components.p,{children:`API를 통해 고객의 현재 크레딧 잔액 확인.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`문제-해결`,children:`문제 해결`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Events not appearing`,id:`events-not-appearing`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`이벤트 이름이 정확히 일치하는지 확인하세요(대소문자 구분)`}),`\n`,_jsx(_components.li,{children:`Meter filter가 이벤트를 제외하고 있지 않은지 확인하세요`}),`\n`,_jsx(_components.li,{children:`고객 ID가 계정에 존재하는지 확인하세요`}),`\n`,_jsx(_components.li,{children:`테스트를 위해 일시적으로 filter를 비활성화하세요`}),`\n`]})}),_jsx(Accordion,{title:`Aggregation not working`,id:`aggregation-not-working`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Over Property가 metadata key와 정확히 일치하는지 확인하세요`}),`\n`,_jsxs(_components.li,{children:[`문자열이 아닌 숫자를 사용하세요: `,_jsx(_components.code,{children:`tokens: 150`}),`, `,_jsx(_components.code,{children:`tokens: \"150\"`}),`가 아님`]}),`\n`,_jsx(_components.li,{children:`모든 이벤트에 필수 property를 포함하세요`}),`\n`]})}),_jsx(Accordion,{title:`Filters not working`,id:`filters-not-working`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`대소문자가 정확히 일치하는지 확인하세요`}),`\n`,_jsx(_components.li,{children:`데이터 type에 맞는 올바른 operator를 사용하세요`}),`\n`,_jsx(_components.li,{children:`이벤트에 filter 대상 property가 포함되어 있는지 확인하세요`}),`\n`]})}),_jsx(Accordion,{title:`Wrong usage totals`,id:`wrong-usage-totals`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`실제로 수신된 이벤트 수를 확인하려면 Events 탭을 확인하세요`}),`\n`,_jsx(_components.li,{children:`aggregation type을 확인하세요(Count와 Sum)`}),`\n`,_jsx(_components.li,{children:`Sum 및 Max에 사용되는 값이 숫자인지 확인하세요`}),`\n`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`다음-단계`,children:`다음 단계`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Send Events`,icon:`bolt`,href:`/features/usage-based-billing/event-ingestion`,children:_jsx(_components.p,{children:`애플리케이션에서 미터로 사용 이벤트 전송을 시작하세요.`})}),_jsx(Card,{title:`View Blueprints`,icon:`copy`,href:`/features/usage-based-billing/ingestion-blueprints`,children:_jsx(_components.p,{children:`일반적인 사용 사례에 대해 기성 미터 구성을 사용하세요.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"sidebarTitle":"미터","title":"미터","description":"원시 사용 이벤트를 집계 및 필터링을 통해 청구 가능한 수량으로 변환합니다.","icon":"sliders","keywords":["Dodo Payments","사용량 측정기","측정","소비 추적","aggregation"],"href":"/ko/features/usage-based-billing/meters"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"API 리소스","slug":"api-리소스","depth":2,"children":[]},{"title":"미터 생성","slug":"미터-생성","depth":2,"children":[]},{"title":"분석 보기","slug":"분석-보기","depth":2,"children":[]},{"title":"통화 대신 크레딧으로 청구","slug":"통화-대신-크레딧으로-청구","depth":2,"children":[{"title":"크레딧 기반 차감을 사용해야 할 때","slug":"크레딧-기반-차감을-사용해야-할-때","depth":3,"children":[]},{"title":"크레딧을 차감하도록 미터 구성하기","slug":"크레딧을-차감하도록-미터-구성하기","depth":3,"children":[]},{"title":"크레딧 차감 작동 방식","slug":"크레딧-차감-작동-방식","depth":3,"children":[]},{"title":"다중 미터, 단일 크레딧 풀","slug":"다중-미터-단일-크레딧-풀","depth":3,"children":[]}]},{"title":"문제 해결","slug":"문제-해결","depth":2,"children":[]},{"title":"다음 단계","slug":"다음-단계","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/dodopayments/0ee82a08f7b65bcb/seo.js","/_mintlify/custom/dodopayments/6f88c9bbee313616/assistant-loader.js"],"subdomain":"dodopayments","siteName":"Dodo Payments Documentation","title":"미터 - Dodo Payments Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/features/usage-based-billing/meters","matchLevel":1},"es":{"href":"/es/features/usage-based-billing/meters","matchLevel":1},"ar":{"href":"/ar/features/usage-based-billing/meters","matchLevel":1},"fr":{"href":"/fr/features/usage-based-billing/meters","matchLevel":1},"de":{"href":"/de/features/usage-based-billing/meters","matchLevel":1},"id":{"href":"/id/features/usage-based-billing/meters","matchLevel":1},"ja":{"href":"/ja/features/usage-based-billing/meters","matchLevel":1},"ko":{"href":"/ko/features/usage-based-billing/meters","matchLevel":0},"pt-BR":{"href":"/pt-BR/features/usage-based-billing/meters","matchLevel":1},"vi":{"href":"/vi/features/usage-based-billing/meters","matchLevel":1},"cn":{"href":"/cn/features/usage-based-billing/meters","matchLevel":1},"hi":{"href":"/hi/features/usage-based-billing/meters","matchLevel":1},"it":{"href":"/it/features/usage-based-billing/meters","matchLevel":1},"sv":{"href":"/sv/features/usage-based-billing/meters","matchLevel":1}}},"lastModified":"2026-09-26T16:06:28.919Z","gitLastModified":"2026-09-26T16:03:47.000Z","originalFileLocation":"ko/features/usage-based-billing/meters.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"원시 사용 이벤트를 집계 및 필터링을 통해 청구 가능한 수량으로 변환합니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dodo Payments Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"미터 - Dodo Payments Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"원시 사용 이벤트를 집계 및 필터링을 통해 청구 가능한 수량으로 변환합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dodo Payments Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dodopayments.mintlify.site/_mintlify/api/og/v2?division=Usage+Based+Billing\u0026amp;title=%EB%AF%B8%ED%84%B0\u0026amp;description=%EC%9B%90%EC%8B%9C+%EC%82%AC%EC%9A%A9+%EC%9D%B4%EB%B2%A4%ED%8A%B8%EB%A5%BC+%EC%A7%91%EA%B3%84+%EB%B0%8F+%ED%95%84%ED%84%B0%EB%A7%81%EC%9D%84+%ED%86%B5%ED%95%B4+%EC%B2%AD%EA%B5%AC+%EA%B0%80%EB%8A%A5%ED%95%9C+%EC%88%98%EB%9F%89%EC%9C%BC%EB%A1%9C+%EB%B3%80%ED%99%98%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=fcc3a546490e883f7462a320\u0026amp;signature=ae1d2a309bfba0033d371051507dbca10f5fd6e3dc6cc2b42b819524efcd65f7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"미터 - Dodo Payments Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"원시 사용 이벤트를 집계 및 필터링을 통해 청구 가능한 수량으로 변환합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dodopayments.mintlify.site/_mintlify/api/og/v2?division=Usage+Based+Billing\u0026amp;title=%EB%AF%B8%ED%84%B0\u0026amp;description=%EC%9B%90%EC%8B%9C+%EC%82%AC%EC%9A%A9+%EC%9D%B4%EB%B2%A4%ED%8A%B8%EB%A5%BC+%EC%A7%91%EA%B3%84+%EB%B0%8F+%ED%95%84%ED%84%B0%EB%A7%81%EC%9D%84+%ED%86%B5%ED%95%B4+%EC%B2%AD%EA%B5%AC+%EA%B0%80%EB%8A%A5%ED%95%9C+%EC%88%98%EB%9F%89%EC%9C%BC%EB%A1%9C+%EB%B3%80%ED%99%98%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=fcc3a546490e883f7462a320\u0026amp;signature=ae1d2a309bfba0033d371051507dbca10f5fd6e3dc6cc2b42b819524efcd65f7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/dodopayments/KuV_TozyHuGHOyyc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dodo Payments Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#779812\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/features/usage-based-billing/meters.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.dodopayments.com/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.dodopayments.com/es/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.dodopayments.com/ar/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.dodopayments.com/fr/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.dodopayments.com/de/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"id\" href=\"https://docs.dodopayments.com/id/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.dodopayments.com/ja/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.dodopayments.com/pt-BR/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"vi\" href=\"https://docs.dodopayments.com/vi/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.dodopayments.com/cn/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"hi\" href=\"https://docs.dodopayments.com/hi/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.dodopayments.com/it/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"sv\" href=\"https://docs.dodopayments.com/sv/features/usage-based-billing/meters\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.dodopayments.com/features/usage-based-billing/meters\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dodopayments.com/#organization\",\"name\":\"Dodo Payments Documentation\",\"url\":\"https://docs.dodopayments.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dodopayments/nM_mJfYkri-OpC5M/logo/light.svg?fit=max\u0026auto=format\u0026n=nM_mJfYkri-OpC5M\u0026q=85\u0026s=23f7a052f7ecb9d6570b7c95ee359a97\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dodopayments.com#website\",\"name\":\"Dodo Payments Documentation\",\"url\":\"https://docs.dodopayments.com\",\"publisher\":{\"@id\":\"https://docs.dodopayments.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters#webpage\",\"url\":\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters\",\"name\":\"미터\",\"description\":\"원시 사용 이벤트를 집계 및 필터링을 통해 청구 가능한 수량으로 변환합니다.\",\"dateModified\":\"2026-09-26T16:03:47.000Z\",\"isPartOf\":{\"@id\":\"https://docs.dodopayments.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Features\",\"item\":\"https://docs.dodopayments.com/ko/features/products\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Usage Based Billing\",\"item\":\"https://docs.dodopayments.com/ko/features/usage-based-billing/introduction\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"미터\",\"item\":\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters#article\",\"headline\":\"미터\",\"name\":\"미터\",\"description\":\"원시 사용 이벤트를 집계 및 필터링을 통해 청구 가능한 수량으로 변환합니다.\",\"url\":\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dodopayments.com/ko/features/usage-based-billing/meters#webpage\"},\"dateModified\":\"2026-09-26T16:03:47.000Z\",\"keywords\":\"Dodo Payments, 사용량 측정기, 측정, 소비 추적, aggregation\",\"publisher\":{\"@id\":\"https://docs.dodopayments.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dodopayments.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dodo Payments Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dodo Payments Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/features/usage-based-billing/meters.md","siteName":"Dodo Payments Documentation","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/features/usage-based-billing/meters"}]},{"language":"es","pages":[{"title":"es","href":"/es/features/usage-based-billing/meters"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/features/usage-based-billing/meters"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/features/usage-based-billing/meters"}]},{"language":"de","pages":[{"title":"de","href":"/de/features/usage-based-billing/meters"}]},{"language":"id","pages":[{"title":"id","href":"/id/features/usage-based-billing/meters"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/features/usage-based-billing/meters"}]},{"language":"ko","tabs":[{"tab":"Docs","icon":"book","groups":[{"group":"Getting Started","pages":[{"title":"Dodo Payments에 오신 것을 환영합니다","sidebarTitle":"소개","icon":"rocket","href":"/ko/introduction"},{"title":"AI 코딩 에이전트와 함께 구축하기","sidebarTitle":"AI 코딩 에이전트","icon":"robot","href":"/ko/developer-resources/build-with-ai-coding-agents"},{"title":"Dodo Payments로 마이그레이션하기","icon":"arrow-right-arrow-left","href":"/ko/migrate-to-dodo"},{"title":"계정 인증","icon":"id-card","href":"/ko/miscellaneous/verification-process"}]},{"group":"Features","pages":[{"sidebarTitle":"제품","title":"제품","icon":"box","href":"/ko/features/products"},{"sidebarTitle":"제품 컬렉션","title":"제품 컬렉션","icon":"layer-group","href":"/ko/features/product-collections"},{"sidebarTitle":"일회성 결제","title":"일회성 결제","icon":"credit-card","href":"/ko/features/one-time-payment-products"},{"group":"Subscriptions","icon":"infinity","pages":[{"sidebarTitle":"Subscriptions","title":"Subscriptions","icon":"repeat","href":"/ko/features/subscription"},{"sidebarTitle":"추가 기능","title":"구독을 위한 추가 기능","icon":"puzzle","href":"/ko/features/addons"},{"title":"주문형 구독","icon":"bolt","href":"/ko/developer-resources/ondemand-subscriptions"}]},{"group":"Usage Based Billing","icon":"arrow-trend-up","pages":[{"sidebarTitle":"소개","title":"사용량 기반 결제","description":"고객이 실제로 사용하는 것에 따라 요금을 부과하며 유연한 계량 및 자동 청구를 제공합니다.","icon":"box","href":"/ko/features/usage-based-billing/introduction"},{"sidebarTitle":"미터","title":"미터","icon":"sliders","href":"/ko/features/usage-based-billing/meters"},{"sidebarTitle":"이벤트 수집","title":"이벤트 수집","description":"고객 소비를 추적하고 청구를 활성화하기 위해 애플리케이션에서 사용 이벤트를 전송합니다.","icon":"bolt","href":"/ko/features/usage-based-billing/event-ingestion"},{"group":"Ingestion Blueprints","icon":"copy","pages":[{"sidebarTitle":"소개","title":"수집 청사진","icon":"box","href":"/ko/features/usage-based-billing/ingestion-blueprints"},{"title":"LLM Blueprint","icon":"brain-circuit","href":"/ko/developer-resources/ingestion-blueprints/llm"},{"title":"API Gateway Blueprint","icon":"cloud","href":"/ko/developer-resources/ingestion-blueprints/api-gateway"},{"title":"객체 저장소 청사진","icon":"box-archive","href":"/ko/developer-resources/ingestion-blueprints/object-storage"},{"title":"스트림 블루프린트","icon":"tower-broadcast","href":"/ko/developer-resources/ingestion-blueprints/stream"},{"title":"시간 범위 청사진","icon":"clock","href":"/ko/developer-resources/ingestion-blueprints/time-range"}]}]},{"sidebarTitle":"Credit-Based Billing","title":"Credit-Based Billing","icon":"coins","tag":"NEW","href":"/ko/features/credit-based-billing"},{"sidebarTitle":"좌석 기반 청구","title":"좌석 기반 청구","icon":"users","href":"/ko/features/seat-based-billing"},{"sidebarTitle":"하이브리드 결제","title":"하이브리드 결제 모델","icon":"layer-group","href":"/ko/features/hybrid-billing"},{"title":"업셀 \u0026 다운셀","icon":"arrow-up-right-dots","href":"/ko/features/upsells-and-downsells"},{"group":"Customers","icon":"user-group","pages":[{"title":"Customer Management","icon":"user-group","href":"/ko/features/customers"},{"sidebarTitle":"고객 포털","title":"고객 포털","icon":"id-card","href":"/ko/features/customer-portal"},{"title":"고객 지갑","icon":"wallet","tag":"NEW","href":"/ko/features/customer-wallet"},{"sidebarTitle":"발송된 이메일","title":"고객 이메일 로그","icon":"envelope","tag":"NEW","href":"/ko/features/email-logs"},{"sidebarTitle":"Customer Blocklist","title":"Customer Blocklist","icon":"user-slash","tag":"NEW","href":"/ko/features/customer-blocklist"}]},{"sidebarTitle":"할인","title":"할인","icon":"percent","href":"/ko/features/discount-codes"},{"group":"Recovery","icon":"rotate","tag":"NEW","pages":[{"sidebarTitle":"개요","title":"수익 회복","icon":"rotate","href":"/ko/features/recovery/overview"},{"sidebarTitle":"장바구니 복구","title":"장바구니 복구","icon":"cart-shopping","href":"/ko/features/recovery/abandoned-cart-recovery"},{"sidebarTitle":"구독 추심","title":"구독 추심","icon":"repeat","href":"/ko/features/recovery/subscription-dunning"},{"sidebarTitle":"구독 결제 재시도","title":"구독 결제 재시도","icon":"arrow-rotate-right","href":"/ko/features/recovery/payment-retries"},{"sidebarTitle":"수동 재시도","title":"수동 결제 재시도","icon":"hand-pointer","tag":"NEW","href":"/ko/features/recovery/manual-retry"}]},{"group":"Transactions","icon":"credit-card","pages":[{"title":"결제","icon":"money-bill-transfer","href":"/ko/features/transactions/payments"},{"title":"환불","icon":"rotate-left","href":"/ko/features/transactions/refunds"},{"title":"분쟁","icon":"circle-exclamation","href":"/ko/features/transactions/disputes"}]},{"group":"Entitlements","icon":"gift","tag":"NEW","pages":[{"title":"소개","sidebarTitle":"소개","icon":"box-archive","href":"/ko/features/entitlements/introduction"},{"title":"License Keys","icon":"key","href":"/ko/features/license-keys"},{"title":"Digital Product Delivery","sidebarTitle":"Digital Products","icon":"download","href":"/ko/features/digital-product-delivery"},{"title":"기능 플래그 권한","sidebarTitle":"기능 플래그","icon":"flag","tag":"NEW","href":"/ko/features/entitlements/feature-flags"},{"title":"Discord Entitlement","sidebarTitle":"Discord","icon":"discord","href":"/ko/features/entitlements/discord"},{"title":"GitHub Entitlement","sidebarTitle":"GitHub","icon":"github","href":"/ko/features/entitlements/github"},{"title":"Telegram 자격 부여","sidebarTitle":"Telegram","icon":"telegram","href":"/ko/features/entitlements/telegram"},{"title":"Framer 권한","sidebarTitle":"Framer","icon":"puzzle-piece","href":"/ko/features/entitlements/framer"},{"title":"Notion 권한","sidebarTitle":"Notion","icon":"book","href":"/ko/features/entitlements/notion"}]},{"group":"Payouts and Balances","icon":"wallet","pages":[{"title":"지급 프로세스","icon":"money-bill","href":"/ko/features/payouts/payout-structure"},{"title":"잔액","icon":"file-invoice-dollar","href":"/ko/features/account-summary-payout-wallet"}]},{"group":"Account Management","icon":"user","pages":[{"sidebarTitle":"비즈니스 보관","title":"비즈니스 보관","icon":"box-archive","tag":"NEW","href":"/ko/features/archive-business"},{"title":"다중 브랜드 설정","icon":"building-columns","href":"/ko/features/multi-brands"},{"title":"청구서 관리","icon":"file-invoice-dollar","href":"/ko/features/invoice-generation"},{"title":"팀 구성원","icon":"user-gear","href":"/ko/features/team"},{"title":"커뮤니케이션 환경설정","sidebarTitle":"커뮤니케이션 환경설정","icon":"bell","tag":"NEW","href":"/ko/features/communication-preferences"},{"title":"내 계정","icon":"user-gear","href":"/ko/miscellaneous/accounts"}]},{"group":"Pricing","icon":"dollar-sign","pages":[{"sidebarTitle":"세금 포함 가격","title":"세금 포함 가격","icon":"file-invoice","href":"/ko/features/tax-inclusive-pricing"},{"sidebarTitle":"원하는 만큼 지불하기","title":"원하는 만큼 지불하기 가격 책정","icon":"dollar-sign","href":"/ko/features/pay-what-you-want"},{"title":"B2B 결제","icon":"money-bills","href":"/ko/features/b2b-payments"},{"title":"현지화된 가격","sidebarTitle":"현지화된 가격","icon":"earth-americas","href":"/ko/features/localized-pricing"},{"sidebarTitle":"구매력 평가 (PPP)","title":"구매력 평형","tag":"NEW","icon":"money-bill-trend-up","href":"/ko/features/purchasing-power-parity"},{"sidebarTitle":"Charm Pricing","title":"Charm Pricing","tag":"NEW","icon":"tag","href":"/ko/features/charm-pricing"}]},{"sidebarTitle":"결제","title":"결제 기능","icon":"cart-shopping","href":"/ko/features/checkout"},{"sidebarTitle":"디자인","title":"디자인 및 테마 커스터마이징","icon":"palette","tag":"NEW","href":"/ko/features/design"},{"group":"Payment Methods","icon":"money-bill-wave","pages":[{"title":"Payment Methods","sidebarTitle":"Overview","icon":"layer-group","href":"/ko/features/payment-methods"},{"title":"신용카드 및 직불카드","sidebarTitle":"카드","icon":"credit-card","href":"/ko/features/payment-methods/cards"},{"title":"Digital Wallets","sidebarTitle":"Digital Wallets","icon":"wallet","href":"/ko/features/payment-methods/digital-wallets"},{"title":"지금 구매 나중에 결제 (BNPL)","sidebarTitle":"BNPL","icon":"calendar-days","href":"/ko/features/payment-methods/bnpl"},{"title":"ACH Direct Debit","sidebarTitle":"ACH Direct Debit","icon":"building-columns","href":"/ko/features/payment-methods/ach"},{"title":"인도 결제 방법","sidebarTitle":"인도","icon":"indian-rupee-sign","href":"/ko/features/payment-methods/india"},{"title":"유럽 결제 수단","sidebarTitle":"유럽","icon":"euro-sign","href":"/ko/features/payment-methods/europe"},{"title":"대한민국 결제 방법","sidebarTitle":"대한민국","icon":"won-sign","href":"/ko/features/payment-methods/south-korea"},{"title":"아시아 태평양 결제 수단","sidebarTitle":"아시아 태평양","icon":"earth-asia","href":"/ko/features/payment-methods/asia-pacific"},{"title":"Pix","sidebarTitle":"Pix","icon":"brazilian-real-sign","href":"/ko/features/payment-methods/pix"},{"title":"스테이블코인","sidebarTitle":"스테이블코인","icon":"dollar-sign","href":"/ko/features/payment-methods/stablecoins"},{"title":"WeChat Pay","sidebarTitle":"WeChat Pay","icon":"comment-dollar","href":"/ko/features/payment-methods/wechat"}]},{"title":"타사 분석","sidebarTitle":"타사 분석","icon":"chart-line","tag":"NEW","href":"/ko/features/analytics"},{"sidebarTitle":"적응형 통화","title":"적응형 통화","icon":"money-bill-transfer","href":"/ko/features/adaptive-currency"},{"group":"BYOP","icon":"shuffle","tag":"BETA","pages":[{"title":"Bring Your Own Processor (BYOP)","sidebarTitle":"개요","tag":"BETA","icon":"boxes-stacked","href":"/ko/features/byop"},{"title":"Stripe - Connect \u0026 Raw Card API Access","sidebarTitle":"Stripe","icon":"stripe","href":"/ko/features/byop/stripe"},{"title":"Adyen - 연결 및 Raw Card API 접근","sidebarTitle":"Adyen","icon":"https://mintlify.s3.us-west-1.amazonaws.com/dodopayments/images/logos/adyen.svg","href":"/ko/features/byop/adyen"}]},{"title":"스토어프론트","icon":"store","href":"/ko/features/storefront"},{"title":"제휴사","icon":"users-line","href":"/ko/features/affiliates"},{"title":"Moderation API","icon":"shield-check","tag":"NEW","href":"/ko/features/moderation"},{"title":"iOS에서 디지털 상품 판매하기","icon":"mobile","href":"/ko/features/appstore-digital-goods"},{"title":"대시보드 분석","sidebarTitle":"대시보드 분석","icon":"chart-line","href":"/ko/features/analytics-and-reporting"},{"title":"보고서","sidebarTitle":"보고서","icon":"file-invoice","href":"/ko/features/reports"}]},{"group":"Integrate","pages":[{"group":"SDKs","icon":"box-open","pages":[{"sidebarTitle":"개요","title":"공식 SDK","icon":"box","href":"/ko/developer-resources/dodo-payments-sdks"},{"title":"TypeScript","icon":"js","href":"/ko/developer-resources/sdks/typescript"},{"title":"Python","icon":"python","href":"/ko/developer-resources/sdks/python"},{"title":"Go","icon":"golang","href":"/ko/developer-resources/sdks/go"},{"title":"루비","icon":"gem","href":"/ko/developer-resources/sdks/ruby"},{"title":"자바","icon":"java","href":"/ko/developer-resources/sdks/java"},{"title":"Kotlin","icon":"k","href":"/ko/developer-resources/sdks/kotlin"},{"title":"PHP","icon":"php","href":"/ko/developer-resources/sdks/php"},{"title":"C#","icon":"c","href":"/ko/developer-resources/sdks/csharp"},{"title":"Rust","icon":"rust","href":"/ko/developer-resources/sdks/rust"}]},{"group":"Mobile Checkout SDKs","icon":"mobile","pages":[{"title":"Mobile Integration Guide","sidebarTitle":"Integration Guide","icon":"mobile","href":"/ko/developer-resources/mobile-integration"},{"title":"Android","sidebarTitle":"Android","tag":"NEW","icon":"android","href":"/ko/developer-resources/sdks/android"},{"title":"iOS","sidebarTitle":"iOS","tag":"NEW","icon":"apple","href":"/ko/developer-resources/sdks/ios"},{"title":"React Native","sidebarTitle":"React Native","tag":"NEW","icon":"react","href":"/ko/developer-resources/sdks/react-native"},{"title":"Flutter","sidebarTitle":"Flutter","tag":"NEW","icon":"layer-group","href":"/ko/developer-resources/sdks/flutter"}]},{"group":"Framework Adaptors","icon":"frame","pages":[{"sidebarTitle":"개요","title":"프레임워크 어댑터 개요","icon":"box","href":"/ko/developer-resources/framework-adaptors"},{"title":"Next.js Adaptor","icon":"code-merge","href":"/ko/developer-resources/nextjs-adaptor"},{"title":"Better Auth 어댑터","icon":"code-merge","href":"/ko/developer-resources/better-auth-adaptor"},{"title":"Convex Component","icon":"code-merge","href":"/ko/developer-resources/convex-component"},{"title":"TanStack Adaptor","icon":"code-merge","href":"/ko/developer-resources/tanstack-adaptor"},{"title":"Nuxt 어댑터","icon":"code-merge","href":"/ko/developer-resources/nuxt-adaptor"},{"title":"Express 어댑터","icon":"code-merge","href":"/ko/developer-resources/express-adaptor"},{"title":"Astro Adaptor","icon":"code-merge","href":"/ko/developer-resources/astro-adaptor"},{"title":"SvelteKit Adaptor","icon":"code-merge","href":"/ko/developer-resources/sveltekit-adaptor"},{"title":"Hono Adaptor","icon":"code-merge","href":"/ko/developer-resources/hono-adaptor"},{"title":"Remix Adaptor","icon":"code-merge","href":"/ko/developer-resources/remix-adaptor"},{"title":"Fastify 어댑터","icon":"code-merge","href":"/ko/developer-resources/fastify-adaptor"},{"title":"Bun Adaptor","icon":"code-merge","href":"/ko/developer-resources/bun-adaptor"}]},{"group":"Webhooks","icon":"webhook","pages":[{"sidebarTitle":"개요","title":"Webhooks","icon":"webhook","href":"/ko/developer-resources/webhooks"},{"title":"Webhook Events Guide","icon":"bell","href":"/ko/developer-resources/webhooks/intents/webhook-events-guide"},{"group":"Webhook Payloads","icon":"code","pages":[{"title":"결제","icon":"credit-card","href":"/ko/developer-resources/webhooks/intents/payment"},{"sidebarTitle":"구독","title":"구독 웹훅","icon":"repeat","href":"/ko/developer-resources/webhooks/intents/subscription"},{"title":"환불","icon":"rotate-left","href":"/ko/developer-resources/webhooks/intents/refund"},{"sidebarTitle":"분쟁","title":"분쟁 Webhooks","icon":"circle-exclamation","href":"/ko/developer-resources/webhooks/intents/dispute"},{"title":"라이센스 키","icon":"key","href":"/ko/developer-resources/webhooks/intents/license-key"},{"title":"자격 부여","icon":"gift","href":"/ko/developer-resources/webhooks/intents/entitlement-grant"},{"sidebarTitle":"크레딧 기반 청구","title":"크레딧 기반 청구 웹훅","icon":"coins","href":"/ko/developer-resources/webhooks/intents/credit"},{"title":"Recovery","icon":"rotate","href":"/ko/developer-resources/webhooks/intents/recovery"},{"sidebarTitle":"Payout","title":"Payout Webhooks","icon":"money-bill-transfer","href":"/ko/developer-resources/webhooks/intents/payout"}]},{"group":"Deploy to Cloud","icon":"rocket","pages":[{"title":"Vercel Functions","icon":"triangle","href":"/ko/developer-resources/webhooks/examples/vercel-example"},{"title":"Cloudflare Workers","icon":"cloud","href":"/ko/developer-resources/webhooks/examples/cloudflare-example"},{"title":"Supabase Edge Functions","icon":"bolt","href":"/ko/developer-resources/webhooks/examples/supabase-example"},{"title":"Netlify Functions","icon":"diamond","href":"/ko/developer-resources/webhooks/examples/netlify-example"}]}]},{"group":"Testing \u0026 Demo Tools","icon":"flask","pages":[{"title":"테스트 모드 vs 라이브 모드","icon":"toggle-on","href":"/ko/miscellaneous/test-mode-vs-live-mode"},{"title":"테스트 프로세스","icon":"flask","href":"/ko/miscellaneous/testing-process"},{"title":"Atlas Demo Product","icon":"palette","href":"/ko/features/atlas-demo-website"}]},{"group":"Boilerplates","icon":"box-open","pages":[{"sidebarTitle":"Expo","title":"Expo Boilerplate","icon":"https://mintlify.s3.us-west-1.amazonaws.com/dodopayments/images/logos/expo.svg","tag":"NEW","href":"/ko/developer-resources/expo-boilerplate"},{"sidebarTitle":"Supabase","title":"Supabase 보일러플레이트","icon":"https://mintlify.s3.us-west-1.amazonaws.com/dodopayments/images/logos/supabase.svg","href":"/ko/developer-resources/supabase-boilerplate"},{"sidebarTitle":"피그마 플러그인","title":"Figma 플러그인","icon":"https://mintlify.s3.us-west-1.amazonaws.com/dodopayments/images/logos/figma.svg","href":"/ko/integrations/figma-plugin"},{"sidebarTitle":"Next.js","title":"Next.js Minimal Boilerplate","icon":"https://mintlify.s3.us-west-1.amazonaws.com/dodopayments/images/logos/nextjs.svg","href":"/ko/developer-resources/nextjs-boilerplate"},{"sidebarTitle":"Astro","title":"Astro Minimal Boilerplate","icon":"https://mintlify.s3.us-west-1.amazonaws.com/dodopayments/images/logos/astro.svg","href":"/ko/developer-resources/astro-boilerplate"},{"sidebarTitle":"FastAPI","title":"FastAPI 보일러플레이트","icon":"https://mintlify.s3.us-west-1.amazonaws.com/dodopayments/images/logos/fastapi.svg","tag":"NEW","href":"/ko/developer-resources/fastapi-boilerplate"},{"sidebarTitle":"Go","title":"Go 보일러플레이트","icon":"golang","tag":"NEW","href":"/ko/developer-resources/go-boilerplate"}]},{"title":"Dodo CLI","icon":"terminal","tag":"NEW","href":"/ko/developer-resources/sdks/cli"},{"title":"오버레이 체크아웃","icon":"cart-shopping","href":"/ko/developer-resources/overlay-checkout"},{"title":"인라인 체크아웃","icon":"credit-card","href":"/ko/developer-resources/inline-checkout"},{"title":"청구 SDK","icon":"boxes-stacked","href":"/ko/developer-resources/billingsdk"},{"title":"Dodo Payments MCP Server","icon":"server","href":"/ko/developer-resources/mcp-server"},{"title":"Agent Skills","icon":"wand-magic-sparkles","href":"/ko/developer-resources/agent-skills"},{"sidebarTitle":"데이터베이스 동기화","title":"데이터베이스와 동기화","icon":"database","href":"/ko/developer-resources/dodo-sync"},{"sidebarTitle":"구독 마이그레이션","title":"Dodo Payments로의 구독 마이그레이션","icon":"file-import","href":"/ko/miscellaneous/subscription-migration"}]},{"group":"Merchant of Record","pages":[{"sidebarTitle":"MoR이란 무엇인가요?","title":"소개","icon":"building-columns","href":"/ko/features/mor-introduction"},{"title":"MoR vs PG","icon":"scale-balanced","href":"/ko/features/mor-vs-pg"},{"title":"가맹점 등록이 가능한 국가","icon":"globe","href":"/ko/miscellaneous/accepted-countries-and-territories"},{"title":"검토 및 모니터링 정책","icon":"magnifying-glass","href":"/ko/miscellaneous/review-monitoring-policy"},{"sidebarTitle":"App Store 수수료 우회","title":"Dodo Payments를 사용하여 App Store 및 Play Store 수수료 우회하기","icon":"shield-check","href":"/ko/features/bypassing-app-store-fees"}]},{"group":"Miscellaneous","pages":[{"group":"Support Channels","icon":"headset","pages":[{"title":"도움 및 지원","icon":"headset","href":"/ko/miscellaneous/help-support"},{"title":"기능 요청 및 로드맵","icon":"lightbulb","href":"/ko/features/feature-request"}]},{"title":"모바일 및 데스크톱 앱","icon":"mobile","href":"/ko/features/mobile-app"},{"title":"보안 보고 정책","icon":"shield","href":"/ko/miscellaneous/security-policy"}]}]},{"tab":"Guides","icon":"compass","pages":[{"title":"Guides","href":"/ko/developer-resources/integration-guide"}]},{"tab":"API Reference","icon":"rectangle-code","pages":[{"title":"API Reference","href":"/ko/api-reference/introduction"}]},{"tab":"External Integrations","icon":"plug","pages":[{"title":"External Integrations","href":"/ko/integrations/introduction"}]},{"tab":"Changelog","icon":"calendar-days","pages":[{"title":"Changelog","href":"/ko/changelog/introduction"}]},{"tab":"Community Projects","icon":"users","pages":[{"title":"Community Projects","href":"/ko/community/overview"}]}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/features/usage-based-billing/meters"}]},{"language":"vi","pages":[{"title":"vi","href":"/vi/features/usage-based-billing/meters"}]},{"language":"cn","pages":[{"title":"cn","href":"/cn/features/usage-based-billing/meters"}]},{"language":"hi","pages":[{"title":"hi","href":"/hi/features/usage-based-billing/meters"}]},{"language":"it","pages":[{"title":"it","href":"/it/features/usage-based-billing/meters"}]},{"language":"sv","pages":[{"title":"sv","href":"/sv/features/usage-based-billing/meters"}]}]},"basePath":"","title":"미터 - Dodo Payments Documentation","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D2acuaLg.js","DynamicMarkdown-Co5nikxh.js","zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js"]}