Integration Guides

Learn how to integrate Oncade's modern payments layer into your game with our step-by-step guides. Each guide provides detailed instructions and best practices for implementation.

Getting Started

Learn the basics of integrating Oncade into your game

  • 1

    Create a developer account

  • 2

    Register your game and get API credentials

  • 3

    Set up wallet addresses for receiving payments

  • 4

    Configure fee splitting for revenue sharing

Store Integration

Set up your D2C store and manage in-game purchases

  • 1

    Create store items and bundles

  • 2

    Set up affiliate marketing

  • 3

    Configure OpenGraph previews

Platform Payouts

Send money to users via the Platform API using Distributions (push) or Campaigns (pull).

  • 1

    Distributions: batch payouts to known recipients by email

  • 2

    Campaigns: event-driven payouts where users join via link sessions

  • 3

    Compare approaches and choose the right fit

Platform Invoices

Create, send, and manage invoices on behalf of businesses through the Platform API.

  • 1

    Create invoices in draft or sent status

  • 2

    Send drafts to recipients with a separate call

  • 3

    Attach platform fees to invoice payments

Platform Businesses

Create and manage businesses programmatically with the Platform API.

  • 1

    Create businesses with members attached by email

  • 2

    Auto-grant platform access scopes on creation

  • 3

    Members complete account setup to receive funds

Account Linking

Establish a stable user reference for each player using the hosted linking flow and server webhooks.

  • 1

    Create a link session with your Server API key and game ID

  • 2

    Send players through the hosted flow and track the session key

  • 3

    Listen for User.Account.Link.Succeeded and store the stable userRef

Java Integration

Integrate Oncade APIs into Java applications using HTTP client or Jakarta RESTful Web Services (JAX-RS).

  • 1

    Set up Maven dependencies and project configuration

  • 2

    Make API calls using Java HTTP client or JAX-RS

  • 3

    Implement webhook signature verification with HMAC-SHA256

Deals & Special Pricing

Offer special pricing to specific users through deal codes embedded in checkout URLs.

  • 1

    Create deals for items in the devportal

  • 2

    Include deal codes in checkout redirect or wallet purchase calls

  • 3

    Track deal usage via webhooks and devportal statistics