Overview

Note: View the Player Order Reporting Webhook in the API reference page.

The Player Order Reporting Webhook is a real-time notification system provided by Appcharge. Each time a player completes a purchase, Appcharge processes the transaction and sends a detailed update to the publisher’s server via this webhook. This webhook serves as a reliable communication channel to help publishers track transactions, manage purchases, and maintain synchronized data across platforms.

Webhook Configuration

The webhook URL will be configured in Appcharge’s management dashboard. For setup instructions, refer to the Integration Settings Guide.

Transaction Alignment

• Publishers should use appChargePaymentId to create a 1-to-1 transaction alignment with their transaction.
• Appcharge will create a 1-to-1 transaction alignment with the returned publisherPurchaseId.
  
  

Free Orders

Free orders, such as those related to daily bonuses, are also tracked. For these orders, all financial information is nullified (set to 0).

The webhook update sent to the publisher will include the following transaction details for free orders:

• purchaseDateAndTimeUtc: Timestamp when the bonus was awarded (in UTC).
• action: Type of the offer (e.g., purchase or bonus).
• subType: Subtype of the offer (e.g., bonus, rolling offer).
• bundleName: Name of the specific offer.
• products: Array representing the sequence of products that were part of the offer.
• priceInDollar: For free orders, this displays as '0' (indicating no charge).
• playerId: Identifier for the player who received the bonus.
• externalTransactionId: External identifier for the transaction.
• actionStatus:
  • completed: Awarding process completed successfully.
  • failed: Awarding process failed.