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

# Marketplace 오류 처리

> APIErrorWrapper, MarketplaceErrorCode 세부 정보 및 실패한 스토어 API 호출에 대한 복구 패턴을 사용하여 PlayFab 마켓플레이스 리뎀션 오류를 처리합니다.

# Marketplace 리뎀션 오류 처리

마켓플레이스 리뎀션 API를 사용할 때는 강력한 오류 처리가 매우 중요합니다. 이 문서에서는 일반적인 오류 코드 이해에서 원활한 오류 복구 전략 구현에 이르기까지 오류 처리를 위한 모범 사례를 살펴봅니다.

오류는 표준 [PlayFab Error Wrapper](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-apple-app-store-inventory-items#apierrorwrapper)를 사용하여 반환됩니다.

## APIErrorWrapper

`APIErrorWrapper`는 모든 실패한 API 응답에 대한 래퍼입니다.

| 이름           | 형식      | 설명                        |
| ------------ | ------- | ------------------------- |
| code         | integer | 숫자 HTTP 코드.               |
| error        | string  | PlayFab 오류 코드.            |
| errorCode    | integer | 숫자 PlayFab 오류 코드.         |
| errorDetails | object  | 요청 개체의 개별 문제에 대한 자세한 설명.  |
| errorMessage | string  | PlayFab errorCode에 대한 설명. |
| status       | string  | 문자열 HTTP 코드.              |

마켓플레이스 관련 문제의 경우 `errorDetails` 개체에 Key-Value Pair(KVP)를 반환합니다.

| 이름                   | 형식        | 설명                                                                                           |
| -------------------- | --------- | -------------------------------------------------------------------------------------------- |
| MarketplaceErrorCode | string\[] | 마켓플레이스 호출이 실패한 경우 마켓플레이스에서 반환된 오류 코드. 배열의 첫 번째 문자열은 오류 코드입니다. 두 번째 문자열은 사용 가능한 경우 오류 메시지입니다. |

<Note>
  이는 마켓플레이스에서 반환한 오류 코드 및 오류 코드 메시지의 통과 전달입니다.
</Note>

오류 응답은 아래와 같이 표시됩니다. 개발자는 `wrapper.errorDetails['MarketplaceErrorCode']`가 null이 아닌지 확인한 다음 첫 번째 요소를 구문 분석하여 다양한 마켓플레이스 오류 코드를 적절하게 처리해야 합니다.

```json theme={null}
"{
    "code":503,
    "errorDetails":
    {
        "MarketplaceErrorCode":["1234","sample error code"]
    },
    ...    
}"
```

## 공개 실패 HTTP 상태 코드

이 섹션에는 redeem API에서 반환된 오류 코드가 나열됩니다.

* **400 - Bad Request**
  * 모든 요청 및 입력 검증 실패 `GenericErroCodes.InvalidRequest`
  * 모든 구성 검증 실패 `GenericErrorCodes.InvalidServiceConfiguration`
  * 모든 마켓플레이스 인증 실패
    * `GenericErrorCodes.InvalidServiceConfiguration` - 서비스 ID 실패와 관련.
    * `GenericErrorCodes.InvalidAuthToken` - 플레이어 ID 실패와 관련.
  * 모든 카탈로그 아이템 구성 실패 `GenericErrorCodes.InvalidCatalogItemConfiguration`
* **401/403 - Not Authorized/Forbidden**
  * PlayFab 인증 실패 `GenericErrorCodes.NotAuthorized`
* **503 - MarketplaceUnavailable**
  * `GenericErrorCodes.DownstreamServiceUnavailable`


## Related topics

- [오류 처리 유형](/ko/services/xbox-services/develop/error-handling/live-types-of-error-handling.md)
- [SDK 오류 처리 모범 사례](/ko/services/playfab/live-service-management/service-gateway/automation/cloudscript/sdk-error-handling-best-practices.md)
- [PlayFab 오류 처리](/ko/services/playfab/sdks/c/errors.md)
- [Lobby 및 Matchmaking C++ SDK 오류 처리](/ko/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-errors.md)
- [CloudScript에서 오류 처리](/ko/services/playfab/live-service-management/service-gateway/automation/cloudscript/handling-errors-in-cloudscript.md)