Xsolla-logo

RefundWebhook

Sent whenever a payment is canceled. Includes payment details. Learn more about a refund process in the instruction.

Refund codes:

Code Reason Description
1 Cancellation by the user request / the game request Cancellation initiated from Publisher Account.
2 Chargeback Transaction chargeback requested.
3 Integration error Issues in integration between Xsolla and the game.
Recommendation: Do not add the user to blocklist.
4 Potential fraud Fraud suspected.
5 Test payment Test transaction followed by cancellation.
Recommendation: Do not add the user to blocklist.
6 User invoice expired Invoice overdue (used for postpaid model).
7 Fraud notification from PS Payment refused by payment system. Potential fraud detected by PS.
Recommendation: Do not add the user to blocklist.
8 Cancellation by the PS request Cancellation requested by payment system.
Recommendation: Do not add the user to blocklist.
9 Cancellation by the user request The user was not satisfied with the game or the purchase for any reason.
Recommendation: Do not add the user to blocklist.
10 Cancellation by the game request Cancellation requested by the game.
Recommendation: Do not add the user to blocklist.
11 Account holder called to report fraud The account owner states that they didn’t make the transaction.
12 Friendly fraud Friendly fraud reported.
13 Duplicate Duplicate transaction for the same invoice.
Request
Request Body schema: application/json
notification_type
required
string

Type of notification.

required
object

Transaction details (object).

required
object

Payment details (object).

object

Custom project settings (object).

object

User details (object).

object

Purchase details (object).

object

Refund details (object).

custom_parameters
object

Your custom parameters.

Responses
204

Return to indicate successful processing.

400

Return in case of an error in the provided information (e.g., a required parameter missing, failed authorization, etc.).

500

Return to indicate temporary errors with your servers.

Request samples
application/json
{
  • "notification_type": "string",
  • "settings": {
    },
  • "user": {
    },
  • "purchase": {
    },
  • "transaction": {
    },
  • "refund_details": {
    },
  • "payment_details": {
    },
  • "custom_parameters": { }
}
Response samples
application/json
{
  • "error": {
    }
}