# Voucher Log Object Reference

Source: https://support.storeconnect.com/articles/voucher-log-object-reference · Last modified 21 August 2026

## Overview

StoreConnect 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.

| Property | Value |
|----------|-------|
| **API Name** | `s_c__Voucher_Log__c` |
| **Label** | Voucher Log |
| **Plural Label** | Voucher Logs |
| **Type** | Custom Object |

## Fields

| Field Label | API Name | Type | Required | Description |
|-------------|----------|------|----------|-------------|
| Event Date | `s_c__Event_Date__c` | DateTime | No | Date and time the voucher event occurred. |
| Event | `s_c__Event__c` | Picklist | No | The type of voucher event. See [Event values](#event-values). |
| 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. |
| Reason | `s_c__Reason__c` | Picklist | No | The reason for a failed event. Populated only when `Success` is false. See [Reason values](#reason-values). |
| Success | `s_c__Success__c` | Checkbox | No | Whether the voucher event succeeded (`true`) or failed (`false`). |
| Voucher | `s_c__Voucher_Id__c` | Lookup ([s_c__Voucher__c](voucher-object-reference)) | No | The voucher this log entry refers to. |
| 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. |

## Event values

| Value | Description |
|-------|-------------|
| `create` | A new voucher record was created. |
| `activate` | The voucher was activated (activation code verified). |
| `cancel` | The voucher was cancelled. |
| `lock` | The voucher was locked. |
| `unlock` | The voucher was unlocked. |
| `redeem` | The voucher was applied as a payment at web checkout or POS. |
| `balance` | A balance check was performed on the voucher. |

## Reason values

Populated only when `Success` is `false`.

| Value | Description |
|-------|-------------|
| `wrong status` | The voucher is in a status that does not allow the requested action (for example, cancelled or locked). |
| `expired` | The voucher has passed its expiry date. |
| `wrong activation code` | The activation code provided did not match. |
| `passed activation date` | The voucher activation date has elapsed. |
| `no balance` | The voucher has no remaining balance. |
| `invalid pin` | The PIN entered did not match the voucher's PIN. |
| `pending for activation` | The voucher is still in a pending state awaiting activation. |

## Relationships

| Field | Type | Related Object | Relationship Name |
|-------|------|----------------|-------------------|
| `s_c__Voucher_Id__c` | Lookup | [s_c__Voucher__c](voucher-object-reference) | Voucher_Logs |

---

## Follow StoreConnect

- [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://getstoreconnect.com/partners)
- [News](https://getstoreconnect.com/articles/news)
- [Events](https://getstoreconnect.com/articles/events)
- [Feature Comparison](https://getstoreconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://getstoreconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

---

StoreConnect Support — https://support.storeconnect.com/articles/voucher-log-object-reference