{"title":"Voucher Log Object Reference","slug":"voucher-log-object-reference","url":"https://support.storeconnect.com/articles/voucher-log-object-reference","url_markdown":"https://support.storeconnect.com/articles/voucher-log-object-reference.md","subtitle":null,"summary":"Records all voucher events, including redemptions, activations, cancellations, and balance checks, with success status and failure reasons.","type":"Developer_Documentation","video_url":"","keywords":"salesforce, object reference, Voucher Log, s_c__Voucher_Log__c, api","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Overview\n\nStoreConnect automatically creates a Voucher Log record for every voucher event — on both web checkout and POS. Use these records to audit voucher activity, investigate disputed redemptions, or trace failed attempts. Voucher Log records are read-only and managed by StoreConnect.\n\n| Property | Value |\n|----------|-------|\n| **API Name** | `s_c__Voucher_Log__c` |\n| **Label** | Voucher Log |\n| **Plural Label** | Voucher Logs |\n| **Type** | Custom Object |\n\n## Fields\n\n| Field Label | API Name | Type | Required | Description |\n|-------------|----------|------|----------|-------------|\n| Event Date | `s_c__Event_Date__c` | DateTime | No | Date and time the voucher event occurred. |\n| Event | `s_c__Event__c` | Picklist | No | The type of voucher event. See [Event values](#event-values). |\n| Metadata | `s_c__Metadata__c` | LongTextArea(131072) | No | JSON string containing event-specific data, such as the redemption amount, balance at time of event, and any error message. |\n| Reason | `s_c__Reason__c` | Picklist | No | The reason for a failed event. Populated only when `Success` is false. See [Reason values](#reason-values). |\n| Success | `s_c__Success__c` | Checkbox | No | Whether the voucher event succeeded (`true`) or failed (`false`). |\n| Voucher | `s_c__Voucher_Id__c` | Lookup ([s_c__Voucher__c](voucher-object-reference)) | No | The voucher this log entry refers to. |\n| StoreConnect External ID | `s_c__sC_Id__c` | Text(36) | No | Do not modify this External ID from within Salesforce — it is the foreign key connection used within your web store. |\n\n## Event values\n\n| Value | Description |\n|-------|-------------|\n| `create` | A new voucher record was created. |\n| `activate` | The voucher was activated (activation code verified). |\n| `cancel` | The voucher was cancelled. |\n| `lock` | The voucher was locked. |\n| `unlock` | The voucher was unlocked. |\n| `redeem` | The voucher was applied as a payment at web checkout or POS. |\n| `balance` | A balance check was performed on the voucher. |\n\n## Reason values\n\nPopulated only when `Success` is `false`.\n\n| Value | Description |\n|-------|-------------|\n| `wrong status` | The voucher is in a status that does not allow the requested action (for example, cancelled or locked). |\n| `expired` | The voucher has passed its expiry date. |\n| `wrong activation code` | The activation code provided did not match. |\n| `passed activation date` | The voucher activation date has elapsed. |\n| `no balance` | The voucher has no remaining balance. |\n| `invalid pin` | The PIN entered did not match the voucher's PIN. |\n| `pending for activation` | The voucher is still in a pending state awaiting activation. |\n\n## Relationships\n\n| Field | Type | Related Object | Relationship Name |\n|-------|------|----------------|-------------------|\n| `s_c__Voucher_Id__c` | Lookup | [s_c__Voucher__c](voucher-object-reference) | Voucher_Logs |"}