sayren Docs
상점 설정

PG 연결 테스트

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

POST
/v1/store/payment-providers/{provider}/verify

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

Authorization

accessToken
headerAuthorizationBearer <token>

Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)

Path Parameters

provider*string

Header Parameters

X-Store-Id*string

대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다

Request Body

application/json
  1. body
environment?string

연결 테스트할 자격 증명 세트. 생략하면 활성 환경(샌드박스면 TEST, 아니면 LIVE)

Value in"TEST""LIVE"

Response Body

성공

application/json
  1. response
meta*
data*
error*|null
curl -X POST 'https://api.sayren.io/v1/store/payment-providers/string/verify' \  -H 'X-Store-Id: string' \  -H 'Content-Type: application/json' \  -d '{}'
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "provider": "tosspayments",    "environment": "TEST",    "result": "SUCCESS",    "message": "string",    "checkedAt": "string"  },  "error": null}