---
title: "결제요청 예약시각 수정 API"
method: PUT
path: "/subscribe/payments/schedule/{merchant_uid}"
tags: ["subscribe"]
---

# 결제요청 예약시각 수정 API

`PUT /subscribe/payments/schedule/{merchant_uid}`

결제예약 시 사용한 거래주문번호(merchant_uid)를 이용하여 해당하는 예약 건의 결제요청 예약시각을 수정할 수 있습니다.

## Path parameters

- `merchant_uid` string, required

## Response `200`

정상적으로 예약 변경이 완료되었습니다.

- SingleScheduleResponse — 등록된 결제예약 정보. 바로 아래 ScheduleResult structure를 확인하세요
  - `code` integer — 0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다
  - `message` string — code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
  - `response` ScheduleResultAnnotation
    - `customer_uid` string — 빌링키와 매핑되며 고객사에서 채번하는 구매자의 결제 수단 식별 고유번호
    - `merchant_uid` string — 고객사 주문번호
    - `imp_uid` string — 포트원 거래고유번호<br> 예약된 결제가 실행 전 철회되거나 아직 실행 전 예약 상태에 있으면 imp_uid 는 null 입니다.
    - `pg_provider` string — PG사 구분코드<br> 슈퍼빌링키 예약결제 실행 시 라우팅된 결제를 실행한 PG사의 구분코드입니다.
    - `pg_id` string — PG사 상점아이디<br>슈퍼빌링키 예약결제 실행 시 라우팅된 결제를 실행한 PG사의 상점아이디입니다.
    - `customer_id` string — 구매자 ID
    - `schedule_at` integer — 예약결제 실행 예정 시각 UNIX timestamp in seconds
    - `executed_at` integer — 예약결제가 실행된 시각 UNIX timestamp
    - `revoked_at` integer — 예약결제 실행을 철회한 시각 UNIX timestamp
    - `amount` number — 결제금액
    - `currency` string — 통화 e.g.) KRW, USD, VND, ... Default: KRW
    - `name` string — 제품명
    - `buyer_name` string — 주문자명
    - `buyer_email` string — 주문자 Email주소
    - `buyer_tel` string — 주문자 전화번호
    - `buyer_addr` string — 주문자 주소
    - `buyer_postcode` string — 주문자 우편번호
    - `custom_data` string — 예약된 결제가 수행될 때 결제정보와 함께 저장할 추가정보
    - `schedule_status` string — 예약상태 <ul><li>scheduled:예약됨(실행되기 전) </li><li>executed:예약된 결제실행완료 </li><li>revoked:예약철회</li></ul>
    - `payment_status` string — 실행된 결제의 승인 상태 <ul><li> null:아직 예약결제가 실행되지 않음(null 이라는 값의 문자열이 아닌 실제 null 입니다) </li><li> paid:예약결제가 결제승인됨 </li><li>failed:예약결제가 승인실패됨 </li><li> cancelled:예약결제가 결제승인 후 환불됨</li></ul>
    - `fail_reason` string — 실행된 결제가 승인 실패인 경우, 실패사유
    - `promotion_id` string — `promotion-id-`로 시작하며, 프로모션 아이디에 설정된 할인 내용을 적용하여 결제합니다. 비인증 결제 경우 빌링키 발급시 저장된 마스킹된 카드번호를 통해 프로모션 적용 여부가 결정됩니다.

## Other responses

- `400` — 필수 파라미터 누락, 이미 실행 혹은 취소된 결제예약, 예약시각이 현재 시각보다 과거인 경우
- `404` — 존재하지 않는 결제예약
- `500` — 포트원 내부 이슈로 인한 API 호출 실패

---

[API](https://skmtc.net/iamport/apis/rest-api.md) · [All operations](https://skmtc.net/iamport/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iamport/rest-api/versions/006dfffdec43/schema)