--- title: Chargeback description: 비대면 카드 검증에서 Chargeback을 보고하고 상태를 확인하기 위한 REST API 레퍼런스. canonical: https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/chargeback locale: ko generated_by: markdown-export --- - [/ko/](/ko/) - 지역별 솔루션 - [비대면 카드 검증](/ko/developers/regional-solutions/card-not-present-verification) - [통합](/ko/developers/regional-solutions/card-not-present-verification/integration/overview) - [API](/ko/developers/regional-solutions/card-not-present-verification/integration/apis) - [API 레퍼런스](/ko/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이 접수되었음을 Unico에 보고합니다. 보고는 이의 제기가 아닙니다이 엔드포인트는 Chargeback을 보고하기만 합니다. Chargeback 분석을 시작하지 않으며 [책임 보증](/ko/developers/regional-solutions/card-not-present-verification/about-idpay/chargeback)도 적용되지 않습니다. Unico가 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"} ``` 필드타입필수설명`datetime`string예Chargeback이 접수된 일시입니다. ISO 8601 형식.`requestor`object예요청자 정보입니다.`requestor.key`string예요청자의 식별 키 유형입니다(예: `cpf`).`requestor.value`string예요청자의 식별 키 값입니다.`name`string예요청자의 이름입니다.`reason`string예Chargeback 사유입니다.`observation`string아니요Chargeback에 대한 일반적인 관찰 사항입니다. 201 Created ``` { "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"} ``` 필드설명`id`Chargeback ID입니다. 하나의 거래에는 하나의 Chargeback만 존재합니다. 이미 Chargeback이 있는 거래를 보고하면 기존 Chargeback의 `id`와 함께 `200 OK`를 반환하며, 기존 Chargeback은 변경되지 않습니다. 오류 응답에 대해서는 [오류 — 거래 생성](/ko/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은 `waiting` 상태로 유지됩니다. 포털에서 해당 거래에 이의 제기가 등록되면 동일한 `id`로 분석 진행 상황과 결과를 확인할 수 있습니다. 가능한 모든 상태는 [열거형 — Chargeback 결과](/ko/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated#chargeback-result)를 참조하세요. 성능을 최적화하려면 이 엔드포인트를 폴링하는 대신 [웹훅](/ko/developers/regional-solutions/card-not-present-verification/integration/webhook)을 구현하세요.마지막 업데이트 2026년 10월 23일**에