환불 요청
POST /v1/refunds는 결제된 주문의 전체 또는 부분 환불을 시작하고 GET /v1/refunds/{refund_no}로 상태를 조회합니다.
핵심 사항
- trade_no는 원래 주문을 식별합니다. 운영 환불에는 멱등 참조인 out_refund_no가 필요합니다.
- amount는 최소 통화 단위의 선택적 양의 정수이며 생략하면 환불 가능한 잔액 전체를 환불합니다.
- 환불은 비동기일 수 있습니다. pending, succeeded, failed를 확인하고 서명된 환불 이벤트로 확정을 판단하세요.
예시
bash
curl "https://api.kukopay.com/v1/refunds/REF_20260921_0001" \
-H "X-Api-Key: $KUKOPAY_API_KEY"