Chargeback

시작하기 전에

API 요청은 액세스 토큰을 사용하여 인증됩니다. 유효한 액세스 토큰을 포함하지 않는 요청은 오류를 반환합니다. 인증에서 자세히 알아보세요.

기본 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 분석을 시작하지 않으며 책임 보증도 적용되지 않습니다. 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은 변경되지 않습니다.

오류 응답에 대해서는 오류 — 거래 생성을 참조하세요.

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 결과를 참조하세요. 성능을 최적화하려면 이 엔드포인트를 폴링하는 대신 웹훅을 구현하세요.

시작하기 전에​

Chargeback 보고​

Chargeback 상태 조회​

시작하기 전에

Chargeback 보고

Chargeback 상태 조회