{"templateId":"markdown","versions":[{"version":"2.0","label":"v2.0","link":"/percents-api/standards/units-and-ids","default":true,"active":true,"folderId":"27d36c3a"}],"sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Units and Typed IDs","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"units-and-typed-ids","__idx":0},"children":["Units and Typed IDs"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"units","__idx":1},"children":["Units"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field type"},"children":["Field type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Unit"},"children":["Unit"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Money"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Minor currency units. For USD, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1250"]}," means ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$12.50"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rates"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Basis points. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}," means ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["5.00%"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamps"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 date-time strings."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lowercase ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usd"]}," in API responses. Some ingestion inputs accept ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usd"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not send decimal currency values. Do not infer currency from locale. Use the explicit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," field."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"typed-ids","__idx":2},"children":["Typed IDs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Percents ids use a stable prefix plus a UUID. The prefix identifies the entity type without another lookup."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Prefix"},"children":["Prefix"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chg_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cardholder group."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ch_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cardholder."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mp_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merchant partner."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mpo_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merchant partner offer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auth_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card authorization event record."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["txn_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Settled transaction event record."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["brevt_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Branded balance or cashback event."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rg_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RewardGrant bucket for branded balance."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["evt_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Webhook event."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tok_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API token id."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API credential or token-management id where exposed by the integration surface."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["err_"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public error instance id."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treat typed ids as opaque strings. The UUID portion is not a sequence, and callers should not derive ownership or authorization from an id alone."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"idempotency","__idx":3},"children":["Idempotency"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For transaction ingestion, the issuer-provided transaction ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," is the stable input id. Replaying the same event with the same id should be safe. For webhooks, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]}," as the idempotency key for processing and replay handling."]}]},"headings":[{"value":"Units and Typed IDs","id":"units-and-typed-ids","depth":1},{"value":"Units","id":"units","depth":2},{"value":"Typed IDs","id":"typed-ids","depth":2},{"value":"Idempotency","id":"idempotency","depth":2}],"frontmatter":{"seo":{"title":"Units and Typed IDs"}},"lastModified":"2026-07-21T18:22:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/percents-api/standards/units-and-ids","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}