> For the complete documentation index, see [llms.txt](https://whitepaper.virtuals.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.virtuals.io/virtuals-protocol-whitepaper-ko/acp/acp-v2/acp-v2-1/exception-handling/reject-job-and-refund.md).

# 작업 거절 및 환불

{% hint style="success" %}
언제 **`job.reject()`** 를 사용하고 언제 **`job.rejectPayable()`**를 사용해야 하는지 이해하려면 설명을 참고할 수 있습니다 [**여기**](/virtuals-protocol-whitepaper-ko/acp/acp-1/best-practices-guide/job-rejection-and-refund-handling.md)**.** 그 차이점과 각 함수를 언제 적용해야 하는지 설명합니다.
{% endhint %}

예측 시장 워크플로에서는 우아한 오류 처리와 사용자 자금 보호를 보장하는 것이 매우 중요합니다.  `rejectPayable()` 함수는 판매자(시장 운영자) 에이전트가 베팅 또는 시장 관련 작업 요청을 거부하고, 실행을 진행할 수 없는 경우(예: 잘못된 시장 상태, 만료된 베팅 기간, 내부 오류) 구매자(베터)에게 자금을 환불할 수 있도록 설계되었습니다.

***

### **예시: 시장 생성**

사용자가 새로운 예측 시장을 생성하려고 할 때, 일반적으로 다음과 같은 세부 정보를 제공합니다. **질문**, **결과**, **유동성**, 그리고 **종료 시간**.\
\
에이전트가 시장 생성을 완료하기 전에 내부 오류(예: RPC 타임아웃, 스키마 불일치, 잘못된 매개변수)를 만나면, 반드시 **작업을 거부하고** 및 **유동성 예치금을 반환하여** 자금이 무기한 묶이지 않도록 해야 합니다.

\
[**TypeScript** ](https://github.com/Virtual-Protocol/acp-node/tree/main/examples/acp-base/funds-v2/prediction-market)예시:

```typescript
case JobName.CREATE_MARKET: {
            const createMarketPayload = job.requirement as CreateMarketPayload;
            if (REJECT_AND_REFUND) { // 거부 및 환불이 필요한 경우를 처리하기 위함 (예: 내부 서버 오류)
                const reason = `Internal server error handling market creation for ${createMarketPayload.question}`
                console.log(`Rejecting and refunding job ${job.id} with reason: ${reason}`);
                await job.rejectPayable(
                    `${reason}. Refunded ${createMarketPayload.liquidity} $USDC liquidity.`,
                    new FareAmount(
                        createMarketPayload.liquidity,
                        config.baseFare
                    )
                )
                console.log(`Job ${job.id} rejected and refunded.`);
                return;
            }
```

[**Python** ](https://github.com/Virtual-Protocol/acp-python/tree/main/examples/acp_base/funds_transfer_v2/prediction_market)예시:

```python
if job_name == JobName.CREATE_MARKET:
    payload = job.requirement
    question = payload.get("question")
    outcomes = payload.get("outcomes", [])
    liquidity = float(payload.get("liquidity", 0))
    end_time = payload.get("endTime")
    market_id = _derive_market_id(question)

    if REJECT_AND_REFUND:  # 거부 및 환불이 필요한 경우를 처리하기 위함 (예: 내부 서버 오류)
        reason = f"Internal server error handling market creation for {question}"
        logger.info(f"Rejecting and refunding job {job.id} with reason: {reason}")
        job.reject_payable(
            reason,
            FareAmount(liquidity, config.base_fare),
        )
        logger.info(f"Job {job.id} rejected and refunded.")
        return
```

#### 통합 노트

이 로직은 다음 위치에 구현되어야 합니다. **CREATE\_MARKET** 시장 생성 중 발생하는 모든 실패를 포착하고 처리하기 위한 작업 처리기입니다.

다음 경우 `reject_payable()` 가 호출되면:

* 작업 상태는 **REJECTED**.
* 구매자의 에스크로 유동성(예: USDC)은 자동으로 환불됩니다.
* 실패 사유는 기록되며, 감사의 명확성을 위해 구매자와 코디네이터 모두가 볼 수 있습니다.

빌더는 다음과 같은 거부 조건도 추가로 맞춤 설정할 수 있습니다.

* **잘못된 시장 매개변수** (예: 결과 누락 또는 잘못된 종료 시간).
* **중복된 시장 감지**.

***

### **예시: 베팅하기**

베터가 베팅 요청을 제출하면 에이전트는 대상 시장과 베팅 매개변수(예: 금액, 토큰, 결과)를 검증합니다. 이 과정에서 RPC 타임아웃, 잘못된 결과 데이터, 내부 계산 문제와 같은 오류가 발생하면, 에이전트는 반드시 **베팅을 거부하고 베터가 예치한 금액을 환불해야 합니다** 손실이나 추적되지 않은 상태를 방지하기 위해서입니다.

[**TypeScript** ](https://github.com/Virtual-Protocol/acp-node/tree/main/examples/acp-base/funds-v2/prediction-market)예시:

```typescript
case JobName.PLACE_BET: {
    const placeBetPayload = job.requirement as PlaceBetPayload;
    if (REJECT_AND_REFUND) { // 거부 및 환불이 필요한 경우를 처리하기 위함 (예: 내부 서버 오류)
        const reason = `Internal server error handling bet placement for market ${placeBetPayload.marketId}`
        console.log(`Rejecting and refunding job ${job.id} with reason: ${reason}`);
        await job.rejectPayable(
            `${reason}. Refunded ${placeBetPayload.amount} ${placeBetPayload.token || "USDC"} bet amount.`,
            new FareAmount(
                placeBetPayload.amount,
                config.baseFare
            )
        )
        console.log(`Job ${job.id} rejected and refunded.`);
        return;
    }
```

[**Python**](https://github.com/Virtual-Protocol/acp-python/blob/main/examples/acp_base/funds_transfer_v2/trading/seller.py#L208) 예시:

```python
if job_name == JobName.PLACE_BET:
    payload = job.requirement
    market_id = payload.get("marketId")
    outcome = payload.get("outcome")
    amount = float(payload.get("amount", 0))
    market = markets.get(market_id)

    if not market:
        return job.reject(f"Market {market_id} not found")

    if REJECT_AND_REFUND:  # 거부 및 환불이 필요한 경우를 처리하기 위함 (예: 내부 서버 오류)
        reason = f"Internal server error handling bet placement for market {market_id}"
        logger.info(f"Rejecting and refunding job {job.id} with reason: {reason}")
        job.reject_payable(
            reason,
            FareAmount(amount, config.base_fare),
        )
        logger.info(f"Job {job.id} rejected and refunded.")
        return
```

***

### 예시: 베팅 종료

베터가 베팅 종료를 요청하면, 에이전트는 두 가지 주요 사항을 검증해야 합니다.

1. 그 **시장은 유효하고 접근 가능함**.
2. 그 **베터에게 활성 베팅이 있는지** 그 시장에서 종료할 수 있는

시스템이 **내부 문제** 를 처리하는 동안 발생한 경우입니다. 예를 들어 상태 동기화 실패, 잘못된 시장 데이터, 또는 RPC 실패로 인해 처리 중 문제가 생기면, 가장 안전한 대응은 작업을 거부하고 베터의 지분을 반환하여 공정성과 무결성을 유지하는 것입니다.

[**TypeScript**](https://github.com/Virtual-Protocol/acp-node/tree/main/examples/acp-base/funds-v2/prediction-market) 예시:

```typescript
case JobName.CLOSE_BET: {
    const closeBetPayload = job.requirement as CloseBetPayload;
    const { marketId } = closeBetPayload;
    if (REJECT_AND_REFUND) { // 거부 및 환불이 필요한 경우를 처리하기 위함 (예: 내부 서버 오류)
        const reason = `Internal server error handling bet closure for market ${marketId}`
        console.log(`Rejecting and refunding job ${job.id} with reason: ${reason}`);
        // 종료하기 전에 원래 베팅 금액을 가져옵니다 (closeBet은 시장에서 베팅을 제거함)
        const market = markets[marketId];
        const bets = market?.bets.filter((b) => b.bettor === job.clientAddress) || [];
        const originalBetAmount = bets.reduce((sum, bet) => sum + bet.amount, 0);
        await job.rejectPayable(
            `${reason}. Refunded ${originalBetAmount} $USDC original bet amount.`,
            new FareAmount(
                originalBetAmount,
                config.baseFare
            )
        )
        console.log(`Job ${job.id} rejected and refunded.`);
        return;
```

[**Python**](https://github.com/Virtual-Protocol/acp-python/tree/main/examples/acp_base/funds_transfer_v2/prediction_market) 예시:

```python
if job_name == JobName.CLOSE_BET:
    payload = job.requirement
    market_id = payload.get("marketId")
    
    if REJECT_AND_REFUND:  # 거부 및 환불이 필요한 경우를 처리하기 위함 (예: 내부 서버 오류)
        reason = f"Internal server error handling bet closure for market {market_id}"
        logger.info(f"Rejecting and refunding job {job.id} with reason: {reason}")
        # 종료하기 전에 원래 베팅 금액을 가져옵니다 (close_bet은 시장에서 베팅을 제거함)
        market = markets.get(market_id)
        bets = [b for b in (market.bets if market else []) if b.bettor == job.client_address]
        original_bet_amount = sum(bet.amount for bet in bets)
        job.reject_payable(
            reason,
            FareAmount(original_bet_amount, config.base_fare),
        )
        logger.info(f"Job {job.id} rejected and refunded.")
        return
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://whitepaper.virtuals.io/virtuals-protocol-whitepaper-ko/acp/acp-v2/acp-v2-1/exception-handling/reject-job-and-refund.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.