---
title: Chargeback
description: 비대면 카드 검증에서 Chargeback 검토를 요청하고 상태를 확인하기 위한 REST API 레퍼런스.
canonical: https://developer.unico.io/ko/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/chargeback
locale: ko
generated_by: markdown-export
---

- [/ko/](/ko/)
- 지역별 솔루션
- [비대면 카드 검증](/ko/dual-api/developers/regional-solutions/card-not-present-verification)
- [통합](/ko/dual-api/developers/regional-solutions/card-not-present-verification/integration/overview)
- [API](/ko/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis)
- [API 레퍼런스](/ko/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference)
- Chargeback

**이 페이지에서# Chargeback

### 시작하기 전에​

API 요청은 액세스 토큰을 사용하여 인증됩니다. 유효한 액세스 토큰을 포함하지 않는 요청은 오류를 반환합니다. [인증](/ko/developers/regional-solutions/card-not-present-verification/integration/authentication)에서 자세히 알아보세요.
기본 URL
**UAT**: `https://transactions.transactional.uat.unico.app/api/public/v1`
**프로덕션**: `https://transactions.transactional.unico.app/api/public/v1`

### Chargeback 검토 요청​

`POST /credit/transactions/{transaction_id}/chargeback` — 지정된 거래에 대해 Chargeback 검토를 요청합니다.
헤더
헤더값`Authorization``Bearer {token}` — 유효한 액세스 토큰입니다.
본문
```
{  "datetime": "2023-01-05T03:00:00.000Z",  "requestor": { "key": "cpf", "value": "USER_CPF" },  "name": "USER_NAME",  "reason": "REQUEST_REASON",  "observation": "GENERAL_OBSERVATIONS",  "documents": [    { "label": "FILE_NAME", "data": "JVBERi0xLjQKMSAwI==" }  ]}
```

필드타입필수설명`datetime`string예Chargeback 요청 일시입니다. ISO 8601 형식.`requestor`object예요청자 정보입니다.`requestor.key`string예요청자의 식별 키 유형입니다(예: `cpf`).`requestor.value`string예요청자의 식별 키 값입니다.`name`string예요청자의 이름입니다.`reason`string예Chargeback 요청 사유입니다.`observation`string아니요요청에 대한 일반적인 관찰 사항입니다.`documents`array아니요Chargeback과 관련된 문서입니다. 최대 3개 항목까지 가능하며, 각각 Base64로 인코딩된 PDF 파일이어야 합니다.`documents[].label`string예(항목별)파일 이름 또는 설명입니다.`documents[].data`string예(항목별)Base64로 인코딩된 PDF 파일입니다.
200 OK
```
{  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"}
```

필드설명`id`생성된 Chargeback ID입니다.
오류 응답에 대해서는 [오류 — 거래 생성](/ko/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#transaction-creation)을 참조하세요.
### Chargeback 검토 상태 조회​

`GET /credit/transactions/{transaction_id}/chargeback/{chargeback_id}` — 특정 Chargeback의 상태를 확인합니다.
헤더
헤더값`Authorization``Bearer {token}` — 유효한 액세스 토큰입니다.
200 OK
```
{  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0",  "status": "waiting"}
```

필드설명`id`Chargeback ID입니다.`status`Chargeback의 현재 상태입니다.
가능한 모든 상태는 [열거형 — Chargeback 결과](/ko/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated#chargeback-result)를 참조하세요. 성능을 최적화하려면 이 엔드포인트를 폴링하는 대신 웹훅을 구현하세요.마지막 업데이트 2026년 10월 8일**에