> For the complete documentation index, see [llms.txt](https://docs.pancakeswap.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pancakeswap.finance/kr/undefined-4/pancake-gifts.md).

# Pancake Gifts

### 🎯 Pancake Gifts란 무엇인가요?

**Pancake Gifts**를 사용하면 **링크** 또는 **QR 코드**만으로 누구나 친구, 사용자 또는 커뮤니티에 토큰(선택 사항으로 가스비 포함)을 보낼 수 있습니다. 받는 사람에게는 간단하고 안전하며 가스비가 필요 없는 경험입니다.

메시지를 보내는 것만큼 쉽게 암호화폐를 시작할 수 있도록 만들어졌습니다. 지갑 충전도, 브릿징도, 선불 수수료도 필요 없습니다.

### 🤝 Pancake Gifts를 만든 이유

Web3 온보딩에는 여전히 많은 걸림돌이 있습니다. 신규 사용자는 다음과 같은 이유로 시작하기도 전에 포기하는 경우가 많습니다.

* **지갑에 가스비가 없음** → 어떤 온체인 작업도 수행할 수 없음
* **올바른 체인에 자금이 없음** → dApp을 사용하기 전에 브릿징이 필요함
* **시작하려면 암호화폐를 구매해야 함** → CEX 가입 또는 법정화폐 온램프가 필요함

Pancake Gifts는 다음과 같은 방법으로 이러한 장벽을 없앱니다.

* ✅ 선물에 **네이티브 가스 토큰 포함**으로 받는 사람이 즉시 이용 가능
* ✅ **가스비를 미리 대납**(보내는 사람이 소액의 수수료 부담)
* ✅ **간단한 링크 또는 QR로 수령 가능** — 복잡한 온보딩 불필요

다음 두 경우 모두를 위한 도구입니다.

* 온체인을 막 시작하는 신규 사용자
* **채택 확대, 사용자 보상 또는 캠페인 진행**을 더 친근한 방식으로 하려는 Web3 네이티브 커뮤니티

***

### ⚙️ 기능 요약

| 기능            | 설명                                         |
| ------------- | ------------------------------------------ |
| **지원 체인**     | BNB 체인(초기 출시)                              |
| **선물 코드 유형**  | 링크 **또는** QR 코드                            |
| **1회 사용**     | 각 코드는 한 번만 수령할 수 있습니다                      |
| **지원 토큰**     | 최대 2개 토큰: BEP-20 1개(필수), 네이티브 가스 토큰 1개(선택) |
| **사용자 지정 금액** | 토큰별로 다른 값을 설정할 수 있습니다                      |
| **선물 수령 가스비** | 보내는 사람이 가스비를 미리 지불합니다(BNB로 약 \~$0.05)      |
| **선물 내역**     | 보낸 모든 선물, 수령 상태, 만료 시점을 확인할 수 있습니다         |
| **보안 검사**     | 전송 수수료 토큰 및 복잡한 로직의 토큰은 허용되지 않습니다          |

### 🚫 제한 사항

1. **코드당 선물 1개** — 대량 선물은 아직 지원되지 않습니다.
2. **선물은 복구할 수 없음** — 취소되었거나 만료된 후에는 다시 사용할 수 없습니다.
3. **지원되지 않는 토큰은 차단됨** — 전송 수수료가 있거나 특수한 로직이 있는 토큰은 생성 시 오류가 표시됩니다.
4. **수령 실패 시 재시도** — 백엔드에서 몇 차례 재시도합니다. 그래도 실패하면 선물은 **수령 불가**로 표시되며 자금을 되찾으려면 수동으로 취소해야 합니다.
5. **선물은 같은 체인에서 수령해야 함** — 예를 들어 ETH 선물은 Ethereum에서 수령해야 합니다. 크로스체인 수령은 아직 지원되지 않습니다.

***

### 🕒 취소 및 만료 로직

선물은 상태와 시간에 따라 정해진 수명 주기를 따릅니다.

#### 수동 취소

* **생성자**는 아직 **수령되지 않았고** **만료 기간 내**에 있는 모든 선물을 취소할 수 있습니다.
* 토큰(최초 선물 수령 가스비 제외)은 보낸 사람에게 반환됩니다.
* 취소된 선물은 다시 활성화하거나 재사용할 수 **없습니다**.

#### 자동 만료

* 선물은 사용자가 정한 기간(기본값: 7일) 이후 **자동으로 만료**됩니다.
* 수령되지 않은 토큰은 보낸 사람의 지갑으로 **자동 반환**됩니다.
* 만료된 선물도 재사용할 수 없습니다.

***

### 🔄 선물 상태 및 의미

| 상태        | 설명                                     |
| --------- | -------------------------------------- |
| **대기 중**  | 선물이 생성되어 수령을 기다리고 있습니다                 |
| **수령 완료** | 수령자가 선물을 성공적으로 수령했습니다                  |
| **취소됨**   | 보낸 사람이 선물을 수동으로 취소했습니다                 |
| **만료됨**   | 수령되지 않은 채 만료 시간이 지났습니다                 |
| **수령 불가** | 재시도 횟수를 초과했습니다. 자금을 되찾으려면 선물을 취소해야 합니다 |

***

### ⚠️ 오류 처리 및 예외 상황

1. **지원되지 않는 토큰**
   * 전송 수수료가 있거나 특수한 로직이 있는 토큰은 선물 생성이 차단됩니다.
2. **가스 불일치**
   * **실제 수령 가스 비용이 ≥** 보낸 사람이 미리 지불한 수수료인 경우 과다 사용을 방지하기 위해 수령이 자동으로 실패합니다. 가스비 수준이 범위 내로 돌아오면 다시 시도됩니다.
3. **수령 시도 실패**
   * 첫 수령 시도가 실패하면 재시도가 이루어집니다.
   * 그래도 실패하면:
     * 수령자에게 "수령 불가"가 표시됩니다.
     * 보낸 사람은 자금을 되찾기 위해 선물을 수동으로 취소해야 하며, 수령자는 새 선물 코드를 요청해야 합니다.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pancakeswap.finance/kr/undefined-4/pancake-gifts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.