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 검토를 요청합니다.

헤더

헤더	값
`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입니다.

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

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

시작하기 전에​

Chargeback 검토 요청​

Chargeback 검토 상태 조회​

시작하기 전에

Chargeback 검토 요청

Chargeback 검토 상태 조회