PayNow

TrustStoreRequirementDto

categoryenumRequired
Represents categories of requirements that must be fulfilled for store setup and compliance in the PayNow platform.
Possible enum values
  • invalid

    Invalid or unspecified category. Default value that should not be used in production.

  • business

    Business information and operational requirements. Includes company details, business model, store policies, refund procedures, and operational guidelines for running a store on PayNow.

  • kyc

    Know Your Customer (KYC) identity verification requirements. Includes government-issued ID verification, proof of address, and identity confirmation as per PayNow's KYC Policy and conducted via any third party KYC partners

  • compliance

    Regulatory compliance requirements including AML checks and content policies. Covers sanctions screening, FATF checks, prohibited customer/product screening, and content compliance as defined in PayNow's policies.

  • risk

    Risk management and fraud prevention requirements. Includes transaction monitoring, unusual activity detection, and ongoing risk assessment procedures to protect against fraudulent activities.

  • technical

    Technical integration and setup requirements. Covers API configuration, webhook setup, platform integration, and any technical prerequisites for store operation.

  • financial

    Financial setup and verification requirements. Includes payment processing configuration, banking information, Tipalti/Trolley payout setup, tax documentation (W-9, W-8, etc.), and payment method verification.

  • legal

    Legal agreement and policy acceptance requirements. Covers acceptance of User Agreement, Terms of Service, Privacy Policy, and any other legal documents required by PayNow for store operation.

  • other

    Other miscellaneous requirements that don't fit into the above categories. Used for special cases or additional requirements specific to certain store types or jurisdictions.

codestringRequired
Unique code identifying the type of requirement. Copied from template or custom for ad-hoc requirements.
created_atstringRequired
When this requirement was created
idFlakeIdRequired
metadataobjectRequired
Additional metadata for this requirement (stored as JSON)
namestringRequired
Human-readable name of the requirement. Copied from template or custom for ad-hoc requirements.
requested_byenumRequired
Determines the party that needs to perform or requests a verification
Possible enum values
  • invalid
  • store

    The associated store

  • paynow

    We as a platform, RequestedByDetail is the admin actor ID in that case (or null if internal)

  • payment_processor

    Payment processor, e.g. Stripe

  • payout_provider

    Payout provider, e.g. Trolley, PayPal

  • kyc_provider

    KYC provider, e.g. Stripe, Onefootprint

  • external

    External party, not fitting in any other category, e.g. government, regulators

restricts_capabilitiesstring[]Required
Store capabilities that are restricted until this requirement is satisfied
statusenumRequired
Possible enum values
  • invalid
  • pending

    Requirement created, awaiting action

  • under_review

    Submitted, under review, or awaiting external verification

  • requires_revision

    Rejected, needs store to resubmit with corrections

  • approved

    Requirement successfully fulfilled

  • expired

    Requirement expired and needs renewal

  • waived

    Requirement waived by PayNow (manual override)

  • rejected_final

    Requirement fully rejected - usually terminal state for the entire store

store_idFlakeIdRequired
submissionsTrustStoreRequirementSubmissionDto[]Required
Associated submissions for this requriement.
idFlakeIdRequired
store_idFlakeIdRequired
store_requirement_field_idstringRequired
The identifier of the specific field within the store requirement.
store_requirement_idFlakeIdRequired
submitted_atstringRequired
The timestamp when this submission was made.
submitted_byActorDtoRequired
typeenumRequired
Possible enum values
  • anonymous
  • user
  • api_key
  • customer
  • game_server
  • internal
  • admin
  • platform
  • global_customer
idFlakeIdOptional
file_content_typestringOptional
The MIME content type of the uploaded file.
file_idstringOptional
The identifier of the uploaded file, if a file was submitted.
file_namestringOptional
The original name of the uploaded file.
file_size_bytesintegerOptional
The size of the uploaded file in bytes.
submitted_by_ip_addressstringOptional
The IP address from which the submission was made.
submitted_by_user_agentstringOptional
The user agent string of the client that made the submission.
text_valuestringOptional
The text value submitted for this field, if applicable.
deadline_atstringOptional
When this requirement must be completed by (optional)
descriptionstringOptional
Detailed description explaining what the store needs to provide. Copied from template or custom for ad-hoc requirements.
originating_flag_idFlakeIdOptional
rejected_atstringOptional
When this requirement was rejected for not meeting standards
requested_by_detailstringOptional
Specifies the specific requester entity (e.g., "stripe", "trolley", or admin user ID) Free-form string for internal records
schemanullOptional
JSON schema defining the form fields, validation rules, and document requirements
submitted_atstringOptional
When the store submitted their response to this requirement
template_idstringOptional
Template ID if this requirement was created from a template. Null for ad-hoc requirements.
updated_atstringOptional
When this requirement was last updated
verified_atstringOptional
When this requirement was verified and approved
Example
{
  "category": "invalid",
  "code": "string",
  "created_at": "2024-01-01T00:00:00Z",
  "id": "411486491630370816",
  "metadata": {},
  "name": "string",
  "requested_by": "invalid",
  "restricts_capabilities": [
    "string"
  ],
  "status": "invalid",
  "store_id": "411486491630370816",
  "submissions": [
    {
      "id": "411486491630370816",
      "store_id": "411486491630370816",
      "store_requirement_field_id": "string",
      "store_requirement_id": "411486491630370816",
      "submitted_at": "2024-01-01T00:00:00Z",
      "submitted_by": {
        "type": "anonymous",
        "id": "411486491630370816"
      },
      "text_value": "string",
      "file_id": "string",
      "file_name": "string",
      "file_content_type": "string",
      "file_size_bytes": 0,
      "submitted_by_ip_address": "string",
      "submitted_by_user_agent": "string"
    }
  ],
  "template_id": "string",
  "originating_flag_id": "411486491630370816",
  "description": "string",
  "schema": {},
  "requested_by_detail": "string",
  "updated_at": "2024-01-01T00:00:00Z",
  "deadline_at": "2024-01-01T00:00:00Z",
  "submitted_at": "2024-01-01T00:00:00Z",
  "verified_at": "2024-01-01T00:00:00Z",
  "rejected_at": "2024-01-01T00:00:00Z"
}