페이 스튜디오 · 링크결제 환불

링크결제 환불

결제 완료된 링크결제를 전체 또는 부분 환불하는 API입니다.

인증이 필요한 요청에는 Accesskey · Secretkey 헤더를 첨부합니다. 공통 응답 형식과 에러 코드는 빠른 시작을 참고하세요.

POST /pay/v1/link/refund

링크결제 환불

결제 완료된 링크결제를 전체 또는 부분 환불하는 API입니다.

요청 파라미터

이름	타입	필수	기본값	조건	설명
`key`	string	필수	-	-	대상 링크결제 key입니다. 목록·생성 API의 key 값을 사용합니다.
`amount`	integer	선택	-	1 이상, 생략 시 전체환불	환불 금액입니다.
`reason`	string	선택	-	255자 이하	환불 사유입니다.
`refund_bank`	string	선택	-	-	가상계좌 환불 은행코드입니다.
`refund_account`	string	선택	-	-	가상계좌 환불 계좌번호입니다.
`refund_holder`	string	선택	-	-	가상계좌 환불 예금주입니다.

응답 파라미터

이름	타입	설명
`traceId`	string	요청 추적 ID입니다.
`code`	string	응답 코드입니다. 성공은 000000입니다.
`message`	string	응답 메시지입니다.
`key`	string	링크결제 key입니다.
`status`	string	링크결제 상태입니다. `READY`—결제 대기(공유됨) `PAID`—결제완료 `EXPIRED`—만료 `CANCELLED`—취소(종료)
`order` 18개 필드	object	환불 후 결제내역 정보입니다.
`key`	string	결제내역 key입니다.
`status`	string	환불 후 결제 상태입니다. `PAID`—결제완료 `PARTIAL_REFUNDED`—부분환불 `REFUNDED`—전체환불
`status_name`	string	환불 후 결제 상태명입니다.
`pay_type`	string	결제수단입니다.
`goods_name`	string	결제 상품명입니다.
`price`	integer	원 결제 금액입니다.
`refund_price`	integer	누적 환불 금액입니다.
`remain_price`	integer	남은 결제 금액입니다.
`cancelable_price`	integer	추가 취소 가능 금액입니다.
`buyer_name`	string	고객명입니다.
`buyer_phone`	string	고객 휴대폰 번호입니다.
`buyer_email`	string	고객 이메일입니다.
`card_no`	string	카드번호 표시값입니다.
`card_name`	string	카드명입니다.
`auth_number`	string	승인번호입니다.
`auth_dttm`	datetime	승인일시입니다.
`cancel_dttm`	datetime	최종 취소일시입니다.
`refunds` 4개 필드	array	환불/취소 내역입니다.
`title`	string	환불/취소 구분명입니다.
`price`	integer	환불 금액입니다.
`current_price`	integer	환불 후 남은 금액입니다.
`date`	datetime	환불 처리일시입니다.

요청 예시

예시 생성 중…

응답 예시 성공

{
  "traceId": "9f2c1a7b-4e0d-4b1a-8c2e-1f3a5d7b9c0e",
  "code": "000000",
  "message": "성공",
  "key": "f1e2d3c4b5a6978869aa",
  "status": "PAID",
  "order": {
    "key": "38bb3e1fbb6a4844a90f",
    "status": "PARTIAL_REFUNDED",
    "status_name": "부분취소",
    "pay_type": "신용카드",
    "goods_name": "홈페이지 제작 착수금",
    "price": 110000,
    "refund_price": 50000,
    "remain_price": 60000,
    "cancelable_price": 60000,
    "buyer_name": "홍길동",
    "buyer_phone": "01012345678",
    "buyer_email": "pay@example.com",
    "card_no": "1234********5678",
    "card_name": "국민카드",
    "auth_number": "12345678",
    "auth_dttm": "2026-06-16 10:05:00",
    "cancel_dttm": null,
    "refunds": [
      {
        "title": "부분 취소",
        "price": 50000,
        "current_price": 60000,
        "date": "2026-06-16 10:20:00"
      }
    ]
  }
}