> ## Documentation Index
> Fetch the complete documentation index at: https://playcamp.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration Case Guide

> Practical guides for each integration pattern

Real-world integration cases from game studios, showing the full flow and development tasks for each integration pattern.

## Common Prerequisites

These are required for all integration methods. See [Overview](/guides/developers/game-integration/overview) for details.

<Steps>
  <Step title="Get API Keys">
    Create a project on PlayCamp platform and obtain your **Server Key**.

    | Environment | URL                                   |
    | ----------- | ------------------------------------- |
    | **Sandbox** | `https://sandbox-sdk-api.playcamp.io` |
    | **Live**    | `https://sdk-api.playcamp.io`         |
  </Step>

  <Step title="Register Webhook URL">
    Register a webhook URL to receive event notifications from PlayCamp on your game server. See [Webhook Events](/guides/developers/game-integration/webhook).
  </Step>

  <Step title="Integration Verification">
    To publish a campaign, you must call 3 required APIs (`POST /sponsors`, `POST /coupons/validate`, `POST /payments`) at least once each in the **Live** environment. Calls with `isTest: true` count as verification.
  </Step>
</Steps>

## Choose Your Integration Method

<CardGroup cols={2}>
  <Card title="WebView + Webhook" icon="browser" href="/guides/developers/game-integration/cases/webview-webhook">
    Use PlayCamp's built-in WebView UI for the fastest integration. No additional UI development needed.

    **Best for**: Quickly providing creator boost functionality
  </Card>

  <Card title="Direct Server API" icon="code" href="/guides/developers/game-integration/cases/server-api-direct">
    Build your own UI for creator selection and boost. Full control over the game UX.

    **Best for**: Custom creator selection UI matching your game's style
  </Card>

  <Card title="Partner Gateway" icon="rotate" href="/guides/developers/game-integration/cases/partner-gateway">
    Partner Gateway relays authentication, webhook conversion, and payment sync. Minimizes changes to existing systems.

    **Best for**: Integrating while keeping existing API specifications (prior consultation required)
  </Card>
</CardGroup>

<Info>
  Both methods can be used simultaneously. For example, use WebView for boost and Server API for payment registration.
</Info>

## FAQ

### How should we handle the PlayCamp entry icon in-game?

You can freely design the PlayCamp entry point (icon/button) within your game. There are no specific size or placement guidelines — place it where it feels natural in your game UI. Contact your PlayCamp representative if you need official assets.

### Can we test in Sandbox first?

Yes. All APIs can be tested in the Sandbox environment (`https://sandbox-sdk-api.playcamp.io`) first. Sandbox is completely isolated from Live. You can also use the `isTest: true` parameter to verify integration without creating real data. See [Test Mode](/guides/developers/game-integration/test-mode).

### What if we have multiple campaigns?

When running multiple campaigns for one game, you must specify `campaignId` in API calls to distinguish between campaigns. If `campaignId` is omitted, the request is automatically assigned to the currently active campaign.