> For the complete documentation index, see [llms.txt](https://ofin.gitbook.io/document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ofin.gitbook.io/document/payment/callback.md).

# 결제 결과 Callback

결제 완료 시, 구매자의 한도 정보 또는 결제 및 납부 정보를 플랫폼 서버로 전달합니다.

* 구매 처리 및 한도 정보 갱신 로직을 구현해 주세요.
* 결제에 실패하는 경우 failCallbackUrl로 리다이렉트되며 Callback은 전송하지 않습니다.
* Callback 요청은  `POST` 방식으로 전송됩니다.
* 사전에 **방화벽 정보**를 확인해 주세요.
* 전송에 실패하는 경우 3분 간격으로 최대 4회 재시도 합니다.
* Callback을 받지 못한 최종 실패 건은 납부 정보 조회로 확인해 주세요.

## Response

* **businessNumber (String) (maxLen:10)**
  * 사업자등록번호
* **orderNo (String) (maxLen:50)**
  * 주문번호
* **productDescription (String) (Required) (maxLen:255)**
  * 상품 설명
* **purchaseAmount (Integer) (maxLen:16)**
  * 결제 금액
* **feePayer (String) (maxLen:20)**
  * 수수료 부담 주체
  * 구매자(PURCHASER) / 플랫폼(PLATFORM)
* **feeAmount** (**Integer) (maxLen:16)**
  * 수수료
* **withdrawalAmount (Integer) (maxLen:16)**
  * 출금 예정 금액 
* **withdrawalDueDate (String) (maxLen:10)**
  * 출금 예정일 (yyyy-mm-dd)
* **withdrawalBankName (String) (maxLen:10)**
  * 출금계좌 은행명
* **withdrawalAccountNumber (String) (maxLen:50)**
  * 일부 마스킹된 출금계좌 계좌번호
* **withdrawalAccountHolder (String) (maxLen:20)**
  * 일부 마스킹된 출금계좌 예금주
* **maxLimit (Integer) (maxLen:16)**
  * 사용자 최대 한도
* **usedAmount (Integer) (maxLen:16)**
  * 현재 사용 중인 금액
* **remainingLimit (Integer) (maxLen:16)**
  * 남은 한도

#### **Response Example**

```json
{
  "businessNumber": "5098601645",
  "purchaseAmount": 128900,
  "feePayer": "PLATFORM",
  "feeAmount": 0,
  "withdrawalAmount": 128900,
  "withdrawalDueDate": "2025-09-30",
  "withdrawalBankName": "국민은행",
  "withdrawalAccountNumber": "123****5678",
  "withdrawalAccountHolder": "홍길*",
  "maxLimit": 10000000,
  "usedAmount": 128900,
  "remainingLimit": 9871100
}

```


---

# 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://ofin.gitbook.io/document/payment/callback.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.