{"templateId":"markdown","versions":[{"version":"2.0","label":"v2.0","link":"/percents-api/cashback/reconciliation","default":true,"active":true,"folderId":"27d36c3a"}],"sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Cashback purchase lookup"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cashback-purchase-lookup","__idx":0},"children":["Cashback purchase lookup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A missing response or reward notification can leave your wallet unsure whether a purchase earned cashback. Look up the original purchase ID to check processing, read the current reward and decide whether to wait or investigate an error. Lookup does not register accounts or change rewards."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET <env-host>/api/v2/transaction/resolve?externalId=issuer-txn-001\nGET <env-host>/api/v2/authorization/resolve?externalId=issuer-auth-001\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api#operation/resolveTransaction"},"children":["settlement lookup"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api#operation/resolveAuthorization"},"children":["authorization lookup"]},". Percent encode the external ID once."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"processing-results","__idx":1},"children":["Processing results"]},{"$$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":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning and next action"},"children":["Meaning and next action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accepted but processing is incomplete. Check again later."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Processing finished. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reward"]}," contains the qualified reward, or is null if none qualified."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Inspect ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]},". Retry a temporary failure with the same event ID. Correct invalid input before retrying."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A missing or inaccessible purchase returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]},". Processing failure is distinct from a successfully processed purchase with no qualified reward."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qualified-reward","__idx":2},"children":["Qualified reward"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"externalId\": \"issuer-txn-001\",\n  \"percentsId\": \"txn_99999999-9999-4999-8999-999999999999\",\n  \"status\": \"processed\",\n  \"reward\": {\n    \"merchantId\": \"mp_55555555-5555-4555-8555-555555555555\",\n    \"offerId\": \"mpo_66666666-6666-4666-8666-666666666666\",\n    \"currency\": \"usd\",\n    \"amountMinor\": 250,\n    \"maxEarnAmountMinor\": 400,\n    \"rewardProductType\": \"cashback\",\n    \"cardholderEarnRate\": {\n      \"kind\": \"basis_points\",\n      \"basisPoints\": 500\n    }\n  },\n  \"error\": null\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An authorization result estimates the reward from the authorization amount. The settlement result is the amount actually awarded and can differ. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/reward-lifecycle"},"children":["reward lifecycle"]}," explains why settlement takes precedence. Do not add the two rewards together."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"identity-lookup","__idx":3},"children":["Identity lookup"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET <env-host>/api/v2/chg/resolve?externalCardholderId=issuer-cardholder-001\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This lookup returns the current cardholder and group ID mappings. Use it after a lost creation response or before calling targeted endpoints. It creates no accounts and returns no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lazilyProvisionedAccounts"]}," key. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/cardholder-groups#lazy-provisioning"},"children":["account identity rules"]}," explain which mappings to retain."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivery-and-retries","__idx":4},"children":["Delivery and retries"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Deduplicate webhooks with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]},". If notifications arrive out of order or a response was lost, read the current result. Do not create another purchase ID to retry the same event. Follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/transaction-ingestion/overview#idempotency-and-retries"},"children":["intake retry rules"]}," to preserve the original event identity."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read current offer terms from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/cashback/offers-and-eligibility"},"children":["offers"]},". Use the reward's embedded earn rate and cap to describe the calculated reward."]}]},"headings":[{"value":"Cashback purchase lookup","id":"cashback-purchase-lookup","depth":1},{"value":"Processing results","id":"processing-results","depth":2},{"value":"Qualified reward","id":"qualified-reward","depth":2},{"value":"Identity lookup","id":"identity-lookup","depth":2},{"value":"Delivery and retries","id":"delivery-and-retries","depth":2}],"frontmatter":{"title":"Cashback purchase lookup","description":"Read current purchase results and identity mappings.","seo":{"title":"Cashback purchase lookup"}},"lastModified":"2026-11-10T20:25:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/percents-api/cashback/reconciliation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}