Sent whenever a user completes a payment. Includes payment details.
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). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
custom_parameters | object Your custom parameters. |
Return to indicate successful processing.
Return in case of an error in the provided information (e.g., a required parameter missing, failed authorization, etc.). In this case, the user’s money is debited, but the purchase fails. To make a refund, contact Xsolla customer support at support@xsolla.com.
Return to indicate temporary errors with your servers.
{- "notification_type": "string",
- "settings": {
- "project_id": 0,
- "merchant_id": 0
}, - "user": {
- "ip": "string",
- "phone": "string",
- "email": "string",
- "id": "string",
- "name": "string",
- "country": "string",
- "zip": "string"
}, - "purchase": {
- "virtual_currency": {
- "name": "string",
- "sku": "string",
- "quantity": 0,
- "currency": "string",
- "amount": 0
}, - "checkout": {
- "currency": "string",
- "amount": 0
}, - "subscription": {
- "plan_id": "string",
- "subscription_id": 0,
- "product_id": "string",
- "tags": [
- "string"
], - "date_create": "string",
- "date_next_charge": "string",
- "currency": "string",
- "amount": 0
}, - "virtual_items": {
- "items": [
- {
- "sku": "string",
- "amount": 0
}
], - "currency": "string",
- "amount": 0
}, - "pin_codes": {
- "digital_content": "string",
- "drm": "steam",
- "currency": "string",
- "amount": 0,
- "upgrade": {
- "digital_content_from": {
- "digital_content": "string",
- "DRM": "string"
}, - "digital_content_to": {
- "digital_content": "string",
- "DRM": "string"
}, - "currency": "string",
- "amount": 0
}
}, - "gift": {
- "giver_id": "string",
- "receiver_id": "string",
- "receiver_email": "string",
- "message": "string",
- "hide_giver_from_receiver": "string"
}, - "total": {
- "currency": "string",
- "amount": 0
}, - "promotions": [
- {
- "technical_name": "string",
- "id": 0
}
], - "coupon": {
- "coupon_code": "string",
- "campaign_code": "string"
}
}, - "transaction": {
- "id": 0,
- "external_id": "string",
- "payment_date": "string",
- "payment_method": 0,
- "payment_method_name": "string",
- "payment_method_order_id": "string",
- "dry_run": 0,
- "agreement": 0
}, - "payment_details": {
- "payment": {
- "currency": "string",
- "amount": 0
}, - "payment_method_sum": {
- "currency": "string",
- "amount": 0
}, - "xsolla_balance_sum": {
- "currency": "string",
- "amount": 0
}, - "payout": {
- "currency": "string",
- "amount": 0
}, - "vat": {
- "currency": "string",
- "amount": 0,
- "percent": 0
}, - "payout_currency_rate": 0,
- "xsolla_fee": {
- "currency": "string",
- "amount": 0
}, - "payment_method_fee": {
- "currency": "string",
- "amount": 0
}, - "sales_tax": {
- "currency": "string",
- "amount": 0,
- "percent": 0
}, - "direct_wht": {
- "currency": "string",
- "amount": 0,
- "percent": 0
}, - "repatriation_commission": {
- "currency": "string",
- "amount": 0
}
}, - "custom_parameters": { }
}
{- "error": {
- "code": "INVALID_USER",
- "message": "Invalid user"
}
}