> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

## Error codes

This operation may return the following PlayFab errors:

| Error | Code |
| --- | --- |
| ProductDisabledForTitle | 1609 |




## OpenAPI

````yaml post /Admin/ResolvePurchaseDispute
openapi: 3.0.0
info:
  version: '260922'
  title: PlayFab Admin API
  description: >-
    APIs for managing title configurations, uploaded Game Server code
    executables, and user data
  termsOfService: https://playfab.com/terms/
  contact:
    url: https://community.playfab.com/index.html
  license:
    name: Apache 2.0
    url: https://github.com/PlayFab/API_Specs/blob/master/LICENSE
servers:
  - url: https://{titleId}.playfabapi.com
    description: PlayFab title endpoint
    variables:
      titleId:
        default: your_title_id
        description: Your PlayFab title ID (hex).
security: []
tags:
  - name: Account Management
    description: Account Management APIs
  - name: Authentication
    description: Authentication APIs
  - name: Characters
    description: Characters APIs
  - name: Content
    description: Content Service APIs
  - name: Custom Server Management
    description: Custom Server Management APIs
  - name: Matchmaking
    description: Matchmaking APIs
  - name: Player Data Management
    description: Player Data Management APIs
  - name: Player Item Management
    description: Player Item Management APIs
  - name: PlayStream
    description: PlayStream Management APIs
  - name: ScheduledTask
    description: Task management APIs
  - name: Segments
    description: Segment management APIs
  - name: Server-Side Cloud Script
    description: Server-Side Cloud Script APIs
  - name: Shared Group Data
    description: Shared Group Data APIs
  - name: Title-Wide Data Management
    description: Title-Wide Data Management APIs
  - name: Xbox Store
    description: Xbox Store APIs
paths:
  /Admin/ResolvePurchaseDispute:
    post:
      tags:
        - Player Data Management
      summary: Resolve Purchase Dispute
      description: >
        _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.


        ## Error codes


        This operation may return the following PlayFab errors:


        | Error | Code |

        | --- | --- |

        | ProductDisabledForTitle | 1609 |
      operationId: ResolvePurchaseDispute
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolvePurchaseDisputeRequest'
      responses:
        '200':
          $ref: '#/components/responses/ResolvePurchaseDisputeResponse'
        '400':
          $ref: '#/components/responses/ApiErrorWrapper'
      security:
        - SecretKey: []
components:
  schemas:
    ResolvePurchaseDisputeRequest:
      type: object
      properties:
        OrderId:
          description: Unique order ID for the purchase in question.
          type: string
        Outcome:
          allOf:
            - $ref: '#/components/schemas/ResolutionOutcome'
          description: >-
            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:
          description: >-
            Unique PlayFab assigned ID of the user on whom the operation will be
            performed.
          type: string
        Reason:
          description: >-
            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)
          type: string
      required:
        - PlayFabId
        - OrderId
        - Outcome
      example:
        PlayFabId: '20394883'
        OrderId: B456AE0
        Reason: Customer Request
        Outcome: Reinstate
    ResolutionOutcome:
      type: string
      enum:
        - Revoke
        - Reinstate
        - Manual
    ResolvePurchaseDisputeResponse:
      type: object
      properties:
        PurchaseStatus:
          description: The order's updated purchase status.
          type: string
      example:
        PurchaseStatus: Approved
    ApiErrorWrapper:
      description: The basic wrapper around every failed API response
      type: object
      properties:
        code:
          description: Numerical HTTP code
          type: integer
        status:
          description: String HTTP code
          type: string
        error:
          description: Playfab error code
          type: string
        errorCode:
          description: Numerical PlayFab error code
          type: integer
        errorMessage:
          description: Description for the PlayFab errorCode
          type: string
        errorDetails:
          description: Detailed description of individual issues with the request object
          type: object
      required:
        - code
        - errorCode
  responses:
    ResolvePurchaseDisputeResponse:
      description: ''
      content:
        application/json:
          schema:
            type: object
            properties:
              code:
                type: integer
                description: >-
                  The Http status code. If X-ReportErrorAsSuccess header is set
                  to true, this will report the actual http error code.
              status:
                type: string
                description: The Http status code as a string.
              data:
                $ref: '#/components/schemas/ResolvePurchaseDisputeResponse'
            example:
              code: 200
              status: OK
              data:
                PurchaseStatus: Approved
    ApiErrorWrapper:
      description: This is the outer wrapper for all responses with errors
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorWrapper'
  securitySchemes:
    SecretKey:
      type: apiKey
      in: header
      name: X-SecretKey
      description: >-
        This API requires a title secret key, available to title admins, from
        PlayFab Game Manager.

````

## Related topics

- [Resolve Purchase Dispute](/api-reference/player-data-management/resolve-purchase-dispute.md)
- [Profile Writes Meter API Description](/services/playfab/pricing/meters/profile-writes.md)
- [Refund Purchase](/services/playfab/api-references/rest/admin/player-data-management/refund-purchase.md)
- [Pay For Purchase](/api-reference/player-item-management/pay-for-purchase.md)
- [ResolveSubresourceRegion](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_resolvesubresourceregion_public.md)
