{"templateId":"markdown","versions":[{"version":"2.0","label":"v2.0","link":"/percents-api/branded-rewards/reconciliation","default":true,"active":true,"folderId":"27d36c3a"}],"sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Audit Trail","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":"audit-trail","__idx":0},"children":["Audit Trail"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Percents exposes enough identifiers and summaries to reconcile issuer state with Percents processing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"audit-chain","__idx":1},"children":["Audit Chain"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n A[auth_ or txn_ id] --> B[brevt_ reward event]\n B --> C[rg_ RewardGrant bucket]\n B --> E[evt_ webhook]\n","diagramHtml":"

auth_ or txn_ id

brevt_ reward event

rg_ RewardGrant bucket

evt_ webhook

","diagramHtmlDark":"

auth_ or txn_ id

brevt_ reward event

rg_ RewardGrant bucket

evt_ webhook

"},"children":["flowchart LR\n A[auth_ or txn_ id] --> B[brevt_ reward event]\n B --> C[rg_ RewardGrant bucket]\n B --> E[evt_ webhook]\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start from the Percents ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auth_"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["txn_"]}," id, then use the audit chain to answer three questions:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Did Percents receive and process the transaction?"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which branded balance or cashback effects were created, posted, reversed, expired, or spent?"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which webhook deliveries correspond to the effect?"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reconciliation-endpoints","__idx":2},"children":["Reconciliation Endpoints"]},{"$$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":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Use"},"children":["Use"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api/rewards/getrewardsummary"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v2/chg/{chgId}/rewards/summary"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Compare aggregate branded balance and cashback totals."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api/rewards/getrewardactivityfeed"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v2/chg/{chgId}/rewards/activity"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review cardholder-visible activity rows."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api/rewards/getexpiringbalances"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v2/chg/{chgId}/rewards/expiring"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identify branded balance that is nearing expiry."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api/rewards/getbalancedetails"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v2/chg/{chgId}/merchant/{merchantId}/balance"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reconcile a merchant-scoped branded balance."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api/rewards/gettransactionrewarddetails"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v2/chg/{chgId}/transaction/{txnId}/reward-detail"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reconcile one transaction and its reward events."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api/rewards/getrewardoverviewfortransactions"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v2/chg/{chgId}/transactions/reward-overviews"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reconcile many transactions by id."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhook-attempts","__idx":3},"children":["Webhook Attempts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Webhook records have a stable ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]}," and attempts are retried on the configured schedule. Issuers should store:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["receive timestamp"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["signature verification result"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["processing status"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["source ids from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a webhook is replayed, the issuer should return success if the event was already processed successfully."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"accounting-backing","__idx":4},"children":["Accounting Backing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Percents uses a double-entry ledger to back all debt and liability changes resulting from cardholder activity, transfers, and expiration. The public API exposes the balances, reward events, and webhooks needed for issuer reconciliation."]}]},"headings":[{"value":"Audit Trail","id":"audit-trail","depth":1},{"value":"Audit Chain","id":"audit-chain","depth":2},{"value":"Reconciliation Endpoints","id":"reconciliation-endpoints","depth":2},{"value":"Webhook Attempts","id":"webhook-attempts","depth":2},{"value":"Accounting Backing","id":"accounting-backing","depth":2}],"frontmatter":{"seo":{"title":"Audit Trail"}},"lastModified":"2026-07-21T18:22:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/percents-api/branded-rewards/reconciliation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}