PG 연결 해제
PG 연결을 해제한다. 이 PG는 결제 설정에서 사라지고 새 결제에 쓰이지 않는다. 자격 증명은 삭제되지 않고 **보관**된다 — 이 PG로 이미 받은 결제의 취소·환불과 결제 확인은 보관된 자격 증명으로 계속 처리된다. 결제 이력이 있어도 해제할 수 있다. 콘솔에 로그인한 **OWNER 전용**이다. ADMIN·STAFF, API 토큰(PAT), M2M 클라이언트, 3rd-party 앱이 위임받은 토큰은 스코프가 있어도 `403 INSUFFICIENT_ROLE`이다.
PG 연결을 해제한다. 이 PG는 결제 설정에서 사라지고 새 결제에 쓰이지 않는다. 자격 증명은 삭제되지 않고 보관된다 — 이 PG로 이미 받은 결제의 취소·환불과 결제 확인은 보관된 자격 증명으로 계속 처리된다. 결제 이력이 있어도 해제할 수 있다. 콘솔에 로그인한 OWNER 전용이다. ADMIN·STAFF, API 토큰(PAT), M2M 클라이언트, 3rd-party 앱이 위임받은 토큰은 스코프가 있어도 403 INSUFFICIENT_ROLE이다.
Authorization
bearer userToken(계정 스코프) 또는 storeToken(스토어 스코프)
In: header
Path Parameters
Response Body
curl -X DELETE "https://example.com/v1/store/payment-providers/string"PG 사용 여부·샌드박스 스위치·간편결제 변경 PATCH
PG를 켜거나 끄고(`enabled`), 샌드박스 스위치(`sandboxMode`)와 이 PG로 받는 간편결제사(`easyPayProviders`)를 바꾼다. 셋 중 하나 이상을 보낸다. 켠 간편결제사마다 스토어프론트 결제 옵션이 생긴다. 끈 PG는 새 결제에 쓰이지 않지만, 이미 그 PG로 승인된 결제의 취소·환불은 계속 그 PG로 처리된다. `sandboxMode: false`(라이브 전환)는 `liveGate.conditions`를 모두 충족해야 한다 — 테스트 키 연결 테스트 성공, 지금 테스트 키로 샌드박스 결제 1건 승인, 그 결제의 환불 1건 성공, 라이브 키 연결 테스트 성공, 플랫폼 실결제 허용. `sandboxMode: true`는 언제든 허용되고 바로 실결제가 멈춘다. 사용 중인 PG 중 하나라도 라이브면 구매자 결제는 라이브 PG로만 진행되고 샌드박스 PG는 쓰이지 않는다. 콘솔에 로그인한 **OWNER 전용**이다. ADMIN·STAFF, API 토큰(PAT), M2M 클라이언트, 3rd-party 앱이 위임받은 토큰은 스코프가 있어도 `403 INSUFFICIENT_ROLE`이다.
PG 자격 증명 세트 제거 DELETE
`TEST` 또는 `LIVE` 자격 증명 세트 하나를 제거한다. 지금 결제에 쓰는 세트(샌드박스 켜짐이면 TEST, 꺼짐이면 LIVE)는 제거할 수 없다. 제거한 세트는 보관되어 그 세트로 이미 받은 결제의 취소·환불에 계속 쓰인다. 콘솔에 로그인한 **OWNER 전용**이다. ADMIN·STAFF, API 토큰(PAT), M2M 클라이언트, 3rd-party 앱이 위임받은 토큰은 스코프가 있어도 `403 INSUFFICIENT_ROLE`이다.