> For the complete documentation index, see [llms.txt](https://developers.payssam.kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.payssam.kr/split.md).

# 나눠서 결제 오픈 예정

결제선생 API의 신규 기능인 나눠서 결제가 오픈 예정입니다.\
하나의 청구서로 여러번 분할 결제할 수 있는 최적의 결제 흐름을 구현해 보세요.

### 운영 반영 및 일정 안내

| 구분          | 내용                  | 일정     |
| ----------- | ------------------- | ------ |
| 운영 반영일      | 운영 환경 나눠서 결제 API 반영 | 8월 31일 |
| API 규격 업데이트 | API V2 상세 규격 업데이트   | 8월 31일 |

{% hint style="warning" %}
V2 스펙에 추가되는 기능입니다.\
V1 → V2 마이그레이션을 준비 중이라면, 8월 31일 배포 이후에 진행하시는 것을 권장합니다.
{% endhint %}

### 나눠서 결제 주요 제공 기능

* 하나의 청구서를 최대 6번까지 나누어 결제가 가능합니다.
* 결제 금액을 직접 입력하거나 비율로 나누어 결제가 가능합니다.
* 나눠서 결제할 때마다 파트너사 서버로 결제 완료 웹훅이 발송됩니다.
* 결제건 전체 취소, 개별 취소도 가능합니다.
* 결제를 취소하면 취소 금액만큼 잔여 결제 필요 금액이 복원됩니다. 고객은 복원된 금액을 다시 결제할 수 있습니다.

### 변경 사항

<table data-search="false"><thead><tr><th>기능</th><th>as is</th><th>to be</th></tr></thead><tbody><tr><td>결제 횟수 </td><td>1번 </td><td>최대 6번 </td></tr><tr><td>승인 동기화</td><td>1회 /건 </td><td>최대 6회 /건 </td></tr><tr><td>승인 동기화 (확장)</td><td>결제건 승인동기화</td><td>취소, 파기, 현금 수납처리 </td></tr><tr><td>결제 취소</td><td>전체 취소</td><td>전체  취소, 결제건 별 취소</td></tr><tr><td>조회</td><td>단건 조회</td><td>거래 건 별 조회</td></tr></tbody></table>

### API 스펙 및 정책 안내

* 나눠서 결제는 **API V2** 스펙에 추가됩니다.
  * 나눠서 결제 적용하지 않고 **API V2 기존 기능만** 이용 가능합니다.

{% hint style="warning" %}
본 기능은 V2 전용으로, **API V1 버전에서는 이용이 불가**합니다.
{% endhint %}

***

## <i class="fa-circle-info" style="color:$info;">:circle-info:</i>

<i class="fa-messages-question">:messages-question:</i>  더 궁금한 내용이 있나요? [자주하는 질문](https://developers.payssam.kr/faq/)

<i class="fa-message-code">:message-code:</i>  기술지원이 필요하신가요? [이메일 보내기](mailto:partner_dev@paymint.co.kr)


---

# 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://developers.payssam.kr/split.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.