Player Data Management - Resolve Purchase Dispute
NOTE: This is a Legacy Economy API, and is in bugfix-only mode. All new Economy features are being developed only for version 2. Attempts to resolve a dispute with the original order's payment provider.
POST https://titleId.playfabapi.com/Admin/ResolvePurchaseDisputeRequest Header
| Name | Required | Type | Description |
|---|---|---|---|
| X-SecretKey | True |
string |
This API requires a title secret key, available to title admins, from PlayFab Game Manager. |
Request Body
| Name | Required | Type | Description |
|---|---|---|---|
| OrderId | True |
string |
Unique order ID for the purchase in question. |
| Outcome | True |
Enum for the desired purchase result state after notifying the payment provider. Valid values are Revoke, Reinstate and Manual. Manual will cause no change to the order state. |
|
| PlayFabId | True |
string |
Unique PlayFab assigned ID of the user on whom the operation will be performed. |
| Reason |
string |
The Reason parameter should correspond with the payment providers reason field, if they require one such as Facebook. In the case of Facebook this must match one of their refund or dispute resolution enums (See: https://developers.facebook.com/docs/payments/implementation-guide/handling-disputes-refunds) |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK | ||
| 400 Bad Request |
This is the outer wrapper for all responses with errors |
Security
X-SecretKey
This API requires a title secret key, available to title admins, from PlayFab Game Manager.
Type:
apiKey
In:
header
Definitions
| Name | Description |
|---|---|
|
Api |
The basic wrapper around every failed API response |
|
Resolution |
|
|
Resolve |
|
|
Resolve |
ApiErrorWrapper
The basic wrapper around every failed API response
| Name | Type | Description |
|---|---|---|
| code |
integer |
Numerical HTTP code |
| error |
string |
Playfab error code |
| errorCode |
integer |
Numerical PlayFab error code |
| errorDetails |
object |
Detailed description of individual issues with the request object |
| errorMessage |
string |
Description for the PlayFab errorCode |
| status |
string |
String HTTP code |
ResolutionOutcome
| Name | Type | Description |
|---|---|---|
| Manual |
string |
|
| Reinstate |
string |
|
| Revoke |
string |
ResolvePurchaseDisputeRequest
| Name | Type | Description |
|---|---|---|
| OrderId |
string |
Unique order ID for the purchase in question. |
| Outcome |
Enum for the desired purchase result state after notifying the payment provider. Valid values are Revoke, Reinstate and Manual. Manual will cause no change to the order state. |
|
| PlayFabId |
string |
Unique PlayFab assigned ID of the user on whom the operation will be performed. |
| Reason |
string |
The Reason parameter should correspond with the payment providers reason field, if they require one such as Facebook. In the case of Facebook this must match one of their refund or dispute resolution enums (See: https://developers.facebook.com/docs/payments/implementation-guide/handling-disputes-refunds) |
ResolvePurchaseDisputeResponse
| Name | Type | Description |
|---|---|---|
| PurchaseStatus |
string |
The order's updated purchase status. |