Skip to main content
Custom fields let you collect additional information from customers during checkout. This is essential for integrating Fungies with your application, especially for in-game purchases or user-specific products.

​
Use Cases

Custom fields are commonly used to:
  • Identify players - Collect a playerId or username to deliver in-game items
  • Server selection - Let customers choose which game server to receive items on
  • Account linking - Capture external account IDs to sync purchases with your system
  • Order customization - Collect preferences or configuration options

​
How It Works

  1. You define custom fields in the Fungies Dashboard
  2. Customers fill in the fields during checkout
  3. The data is included in webhook event payloads
  4. Your application uses the data to fulfill the order

​
Example Event Payload

When a customer completes a purchase, the custom field data is included under the customFields key: 
{
  "id": "6f97c060-570d-46e8-81af-033539210df3",
  "data": {
    "items": [
      {
        "id": "a0bf335d-25b9-4eda-bf92-f45f7bd2ed18",
        "name": "Legendary Sword",
        "quantity": "1",
        "internalId": null,
        "customFields": {
          "playerId": "123",
          "serverName": "US-1"
        }
      },
      {
        "id": "adb745b7-b23a-4960-ab21-7f21b7312840",
        "name": "Legendary Shield",
        "quantity": "1",
        "internalId": null,
        "customFields": {
          "playerId": "123",
          "serverName": "US-1"
        }
      }
    ]
    // ...
}

​
Key Concepts

Project-Level Fields

Custom fields are defined at the project level and apply to all products in that project

Required by Default

All custom fields are required—customers must fill them out to complete checkout

Validation Support

Fields can be validated with regex patterns or your own validation API

Multiple Field Types

Support for text inputs and dropdown selections

​
Next Steps

Set Up Custom Fields

Create custom fields in the Fungies Dashboard

Validate Customer Data

Add validation rules to ensure data quality