# ContinuationPagedResultDtoOfStoredCredentialConsentRecordDto

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

Represents a page of results obtained through continuation-token paging.
Supports an approximate total count for display purposes.

## Fields
- `items` (array<[StoredCredentialConsentRecordDto](https://devportal.signapay-sbx.winkpg.io/docs/api/models/StoredCredentialConsentRecordDto.md)>): The items returned for this page. (nullable)
  Fields of each item:
  - `id` (string(uuid))
  - `customerId` (string(uuid)): The customer who gave the consent. (nullable)
  - `paymentMethodId` (string(uuid)): The customer's stored payment method the consent covers. This is the stored payment method's id, not a payment token. (nullable)
  - `allowedUsages` ([StoredCredentialUsage](https://devportal.signapay-sbx.winkpg.io/docs/api/models/StoredCredentialUsage.md)): The kinds of later charge the cardholder agreed to (a combination of flags). Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names. (nullable)
    Values:
    - `None`: No permitted uses. Consent record is effectively inactive.
    - `Recurring`: Scheduled recurring charges (subscriptions, membership dues). Maps to Recurring.
    - `Installment`: Fixed-schedule installment plans dividing a known total. Maps to Installment.
    - `UnscheduledCOF`: Merchant-triggered charges for pre-agreed events (balance top-ups, usage overages, no-show fees, delayed charges). Maps to several MIT reason codes including UnscheduledCOF, NoShow, DelayedCharge, and IncrementalAuth.
    - `OneTimeFuture`: A single known future cardholder-initiated purchase the credential was saved for (e.g. "save card for my next order"). Not used for MITs.
  - `consentTextVersion` (string): The version of the consent text the cardholder was shown: a hash of the rendered text, as returned by the consent configuration operation and sent with the capture. (nullable)
  - `consentText` (string): The exact consent text the cardholder was shown. Null when it was not recorded: a consent captured before the text was kept, or one whose text was no longer held when it was captured. The `consentTextVersion` is recorded either way. (nullable)
  - `capturedAt` (string(date-time)): UTC time the cardholder gave consent. (nullable)
  - `capturedVia` ([ConsentCaptureChannel](https://devportal.signapay-sbx.winkpg.io/docs/api/models/ConsentCaptureChannel.md)): Where the consent was captured: the hosted payment page, the Virtual Terminal, the API, an import or the merchant's back office. (nullable)
    Values:
    - `HostedPaymentPage`: Captured during a hosted payment page checkout via an opt-in checkbox the cardholder ticked. Strongest evidence: cardholder's own action with IP, user agent, and session identifier recorded.
    - `VirtualTerminal`: Captured in the virtual terminal as a merchant operator attestation that consent was obtained from the cardholder offline (in person, by phone, signed form, etc.). Operator identity and capture method recorded.
    - `Api`: Declared by an integrating merchant via the API. The merchant takes liability for the declaration; WinkPG records the API key, timestamp, and merchant-supplied reference.
    - `Imported`: Imported from an external system (e.g. legacy migration, bulk reseller onboarding). Evidence captured outside WinkPG and recorded only as a reference to the external system.
    - `MerchantAdmin`: Captured when a merchant admin manually adds a stored payment method to a customer from the back-office (Customers > customer > Payment Methods). The operator attests that they obtained the cardholder's / account holder's authorization off-line (by phone, in person, or via a signed form on file) and records where the merchant retains that artifact. Operator identity, capture method, ACH authorization type (for bank-account credentials), and a merchant evidence reference are recorded on ConsentEvidence.
  - `declaredMethod` (string): How the consent was obtained, for example `OnlineForm` or `Phone`: the method sent with an API capture, or the method an operator recorded in the Virtual Terminal or the back office. Null for a hosted payment page consent, whose evidence is the checkbox the cardholder ticked. (nullable)
  - `enrollmentTerms` ([EnrollmentTermsDto](https://devportal.signapay-sbx.winkpg.io/docs/api/models/EnrollmentTermsDto.md)): The terms the cardholder agreed to for a recurring or installment consent: the amount, frequency, duration and any fee, card price or surcharge ceiling stated. Null when none were recorded.
  - `initialTransactionId` (string(uuid)): The transaction during which the consent was captured. Null for a consent captured without one, such as a card stored with no payment. (nullable)
  - `initialSchemeTransactionId` (string): The card network's transaction identifier from the initial cardholder-initiated transaction, which later merchant-initiated charges reference. Null when the processor returned none. (nullable)
  - `revokedAt` (string(date-time)): UTC time the consent was revoked. Null while it is active. (nullable)
  - `isRevoked` (boolean): True when the consent has been revoked and no longer permits a merchant-initiated charge. (read only)
  - `evidence` ([ConsentRecordEvidenceDto](https://devportal.signapay-sbx.winkpg.io/docs/api/models/ConsentRecordEvidenceDto.md)): Evidence recorded by the hosted payment page when the cardholder consented there. Null for a consent captured on another channel.
- `nextContinuationToken` (string): Continuation token to use when requesting the next page. Null means no additional pages exist. (nullable)
- `approxTotalCount` (integer(int64)): An approximate total count of matching items. This value is optional and may be stale or estimated, so treat it as an approximation. (nullable)
- `pageItemCount` (integer(int32)): Convenience property for the number of items in this page. (read only)
- `retrievedAt` (string(date-time)): When the page was retrieved. Useful for diagnostics and cache behavior.

## See also

- [All documentation](https://devportal.signapay-sbx.winkpg.io/llms.txt): the machine-readable index of every public page on this site.
