페이 스튜디오 · 링크결제 수정

링크결제 수정

결제 전 링크결제 요청 정보를 수정하거나 결제요청을 종료하는 API입니다.

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

PUT /pay/v1/link

링크결제 수정

결제 전 링크결제 요청 정보를 수정하거나 결제요청을 종료하는 API입니다.

요청 파라미터

이름	타입	필수	기본값	조건	설명
`key`	string	필수	-	-	대상 링크결제 key입니다. 목록·생성 API의 key 값을 사용합니다.
`product_key`	string	선택	-	-	상품 key입니다. 빈 문자열을 보내면 상품 연결을 해제합니다.
`goods_name`	string	선택	-	100자 이하	결제 상품명입니다.
`amount`	integer	선택	-	1 이상	결제 요청 금액입니다.
`buyer_name`	string	선택	-	100자 이하	고객명입니다.
`buyer_phone`	string	선택	-	30자 이하	고객 휴대폰 번호입니다.
`buyer_email`	string	선택	-	100자 이하	고객 이메일입니다.
`expire_dttm`	datetime	선택	-	YYYY-MM-DD 또는 YYYY-MM-DD HH:mm:ss	결제 가능 만료일시입니다. 빈 문자열을 보내면 만료일시를 해제합니다.
`memo`	string	선택	-	255자 이하	관리 메모입니다.
`status`	string	선택	-	-	결제요청을 종료할 때 전달하는 상태값입니다. `CANCELLED`—결제요청 종료(취소)
`close`	boolean	선택	-	true	결제요청 종료 여부입니다.

응답 파라미터

이름	타입	설명
`traceId`	string	요청 추적 ID입니다.
`code`	string	응답 코드입니다. 성공은 000000입니다.
`message`	string	응답 메시지입니다.
`key`	string	링크결제 내부 key입니다.
`share_key`	string	고객 공유 링크 key입니다.
`status`	string	링크결제 상태입니다. `READY`—결제 대기(공유됨) `PAID`—결제완료 `EXPIRED`—만료 `CANCELLED`—취소(종료)
`status_name`	string	링크결제 상태명입니다.
`pay_url`	string	고객 결제 링크입니다.
`goods_name`	string	결제 상품명입니다.
`amount`	integer	결제 요청 금액입니다.
`buyer_name`	string	고객명입니다.
`buyer_phone`	string	고객 휴대폰 번호입니다.
`buyer_email`	string	고객 이메일입니다.
`memo`	string	관리 메모입니다.
`expire_dttm`	datetime	결제 가능 만료일시입니다.
`create_dttm`	datetime	생성일시입니다.

요청 예시

예시 생성 중…

응답 예시 성공

{
  "traceId": "9f2c1a7b-4e0d-4b1a-8c2e-1f3a5d7b9c0e",
  "code": "000000",
  "message": "성공",
  "key": "f1e2d3c4b5a6978869aa",
  "share_key": "9f2c1a7b4e0d4b1a8c2e1f3a5d7b9c0e7a8b9c0d",
  "status": "READY",
  "status_name": "공유",
  "pay_url": "https://www.doublestudio.co.kr/share/link/9f2c1a7b4e0d4b1a8c2e1f3a5d7b9c0e7a8b9c0d/",
  "goods_name": "홈페이지 제작 착수금 변경",
  "amount": 120000,
  "buyer_name": "홍길동",
  "buyer_phone": "01012345678",
  "buyer_email": "pay@example.com",
  "memo": "6월 착수금",
  "expire_dttm": "2026-07-10 23:59:59",
  "create_dttm": "2026-06-16 10:00:00"
}