sayren Docs
스토어 설정

PG 자격 증명 세트 제거

`TEST` 또는 `LIVE` 자격 증명 세트 하나를 제거한다. 지금 결제에 쓰는 세트(샌드박스 켜짐이면 TEST, 꺼짐이면 LIVE)는 제거할 수 없다. 제거한 세트는 보관되어 그 세트로 이미 받은 결제의 취소·환불에 계속 쓰인다. 콘솔에 로그인한 **OWNER 전용**이다. ADMIN·STAFF, API 토큰(PAT), M2M 클라이언트, 3rd-party 앱이 위임받은 토큰은 스코프가 있어도 `403 INSUFFICIENT_ROLE`이다.

DELETE
/v1/store/payment-providers/{provider}/credentials/{environment}

TEST 또는 LIVE 자격 증명 세트 하나를 제거한다. 지금 결제에 쓰는 세트(샌드박스 켜짐이면 TEST, 꺼짐이면 LIVE)는 제거할 수 없다. 제거한 세트는 보관되어 그 세트로 이미 받은 결제의 취소·환불에 계속 쓰인다. 콘솔에 로그인한 OWNER 전용이다. ADMIN·STAFF, API 토큰(PAT), M2M 클라이언트, 3rd-party 앱이 위임받은 토큰은 스코프가 있어도 403 INSUFFICIENT_ROLE이다.

Authorization

bearer
AuthorizationBearer <token>

userToken(계정 스코프) 또는 storeToken(스토어 스코프)

In: header

Path Parameters

provider*string
environment*string

Response Body

application/json

curl -X DELETE "https://example.com/v1/store/payment-providers/string/credentials/string"
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "provider": "tosspayments",    "displayName": "string",    "connected": true,    "enabled": true,    "priority": 0,    "environment": "TEST",    "publicConfig": {      "clientKey": "string"    },    "secrets": [      {        "field": "string",        "configured": true,        "masked": "string"      }    ],    "lastVerification": {      "result": "SUCCESS",      "message": "string",      "checkedAt": "string"    },    "updatedAt": "string",    "sandboxMode": true,    "credentialSets": {      "TEST": {        "environment": "TEST",        "publicConfig": {          "clientKey": "string"        },        "secrets": [          {            "field": "string",            "configured": true,            "masked": "string"          }        ],        "lastVerification": {          "result": "SUCCESS",          "message": "string",          "checkedAt": "string"        },        "updatedAt": "string"      },      "LIVE": {        "environment": "TEST",        "publicConfig": {          "clientKey": "string"        },        "secrets": [          {            "field": "string",            "configured": true,            "masked": "string"          }        ],        "lastVerification": {          "result": "SUCCESS",          "message": "string",          "checkedAt": "string"        },        "updatedAt": "string"      }    },    "liveGate": {      "status": "LOCKED",      "conditions": [        {          "code": "TEST_CONNECTION",          "met": true,          "message": "string"        }      ],      "openedAt": "string"    },    "easyPayProviders": [      "string"    ],    "retiredCredentialCount": 0,    "routingExclusion": null  },  "error": null}

PG 연결 해제 DELETE

PG 연결을 해제한다. 이 PG는 결제 설정에서 사라지고 새 결제에 쓰이지 않는다. 자격 증명은 삭제되지 않고 **보관**된다 — 이 PG로 이미 받은 결제의 취소·환불과 결제 확인은 보관된 자격 증명으로 계속 처리된다. 결제 이력이 있어도 해제할 수 있다. 콘솔에 로그인한 **OWNER 전용**이다. ADMIN·STAFF, API 토큰(PAT), M2M 클라이언트, 3rd-party 앱이 위임받은 토큰은 스코프가 있어도 `403 INSUFFICIENT_ROLE`이다.

PG 연결 테스트 POST

저장된 자격 증명 세트로 PG 연결을 확인하고 결과를 그 세트에 저장한다. `environment`를 생략하면 지금 결제에 쓰는 세트를 확인한다. 실패해도 200이며 `result: FAILED`와 사유를 돌려준다. 확인 대상은 시크릿 키·API Secret 인증과 상점 접근 권한이다. 라이브 전환 조건의 연결 테스트 항목은 이 결과로 판정한다. 테스트하는 동안 그 세트가 바뀌면 결과를 저장하지 않고 409다. 콘솔에 로그인한 **OWNER 전용**이다. ADMIN·STAFF, API 토큰(PAT), M2M 클라이언트, 3rd-party 앱이 위임받은 토큰은 스코프가 있어도 `403 INSUFFICIENT_ROLE`이다.