High-Level Flow

Direct Checkout High-Level Flow (In-Game Payments)

This article explains the high-level flow for implementing Direct Checkout inside your app or game.

Prerequisites

Before starting, make sure that:

• You have access to the Neon Console and have created API keys
• You have your own inventory configured on your side (SKUs, prices, etc.)

Direct Checkout Flow

Direct Checkout integration steps:

1. Configure the visual theme for your Checkout page.
   (if you have not already done so)
2. Identify the player’s location.
   You may identify the player’s location using your own services, or by using Neon’s GET /prices endpoint, which supports IP-based country detection.
3. Determine whether Neon can be used.
   Determine whether Neon can be shown as a payment method Based on the player’s region and your application logic.
4. Create a Checkout session.
   Once the player selects an item to purchase, your backend creates a POST /checkout request to generate a Neon Checkout session. See the Checkout API section for request structure and implementation details.
5. Handle fulfillment.
   After a successful payment, Neon sends a webhook event to your backend, which you register via Neon Console. Your system should then validate the purchase and grant the purchased items or entitlements to the player.
6. Complete the purchase flow.
   Once fulfillment is complete, the purchase process is finished.
   Before going to Live, you can test the entire integration flow using Sandbox Checkout environments. Test payment details and testing instructions are available here.