Xsolla-logo

Partial refundWebhook

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

Refund codes:

Code Reason Description
1 Cancellation by the user request / the game request Cancellation initiated from Publisher Account.
3 Integration error Issues in integration between Xsolla and the game.
Recommendation: Do not add the user to blocklist.
5 Test payment Test transaction followed by cancellation.
Recommendation: Do not add the user to blocklist.
7 Fraud notification from PS Payment refused by payment system. Potential fraud detected by PS.
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.
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": {
    }
}