Skip to main content

사전 준비 작업

  • API 인증키를 발급받으려면 스텝페이 포탈에서 회원가입이 필요합니다.
  • 결제 연동키 발급 후 스텝페이 포탈에서 PG 설정이 필요합니다.

인증 키 설정

스텝페이에서 사용하는 인증 키는 두 가지 종류가 있습니다. API 인증키는 스텝페이 포탈의 [설정] 메뉴의 ‘인증키 관리’에서 확인할 수 있습니다. 인증키_관리.png

1. Secret-Token

Secret-Token은 V1 API 호출 시 필요한 인증 키입니다. Secret-Token은 스텝페이 포탈에 가입하면 별도의 절차 없이 모든 고객에게 생성되는 키 입니다.
Secret-Token은 HTTP Request 요청 시 필요한 값입니다. 시크릿 키를 웹 프론트에서 사용하게 되면 노출 위험이 있으니, 백엔드에서 연동하시길 권장드립니다.

2. Payment-Key

Payment-Key를 사용하여 결제를 연동하는 경우, PG 설정을 통해 사용하고자 하는 PG가 설정되어 있어야 합니다. 인증키_관리.png

API 인증

스텝페이 V1 API를 사용하려면 HTTP Header에 Secret-Token을 전달해야 합니다.
curl --location 'https://api.steppay.kr/api/v1/subscriptions' \
--header 'Secret-Token:${Secret-Token}'