지급대행 준비
지급대행 서비스를 사용하려면, PG가맹점 정보를 암호화한 토큰을 먼저 발급받아야 합니다.
해당 토큰은 지급대행 API를 인증에 사용됩니다.
Open API를 통해 결제 연동한 가맹점은 API Key를 사용해 토큰을 발급받을 수 있으며, 사전에 API Key를 발급받지 못한 가맹점은 onlinesupport@eximbay.com으로 문의해 주세요.
토큰 발급이 완료되면, 지급대행 API 연동을 시작하실 수 있습니다.
Open API를 통해 결제 연동한 가맹점은 API Key를 사용해 토큰을 발급받을 수 있으며, 사전에 API Key를 발급받지 못한 가맹점은 onlinesupport@eximbay.com으로 문의해 주세요.
토큰 발급이 완료되면, 지급대행 API 연동을 시작하실 수 있습니다.
요청 URL
| 구분 | URL |
|---|---|
| 운영 | https://pgonline.eximbay.com |
| 테스트 | https://pgonline-test.eximbay.com |
토큰 발급
GET/v1/api/accounts/token
발급된 apiKey를 Base64 방식으로 인코딩 후, HTTP 요청 헤더에 인코딩 된 값을 헤더 이름 apiKey 에 설정해 주세요.
요청
curl --location 'https://pgonline-test.eximbay.com/v1/api/accounts/token' \
--header 'apiKey: ••••••'
응답 파라미터
token string
토큰 값 입니다.
expired_at DateTime
토큰 만료 시간입니다.
테스트 서버는 일주일 후에 토큰이 만료되며, 운영 서버에서는 2시간마다 토큰이 만료됩니다.
테스트 서버는 일주일 후에 토큰이 만료되며, 운영 서버에서는 2시간마다 토큰이 만료됩니다.
응답
{
"rescode": "SUCCESS",
"resmsg": "SUCCESS",
"type": "token",
"data": {
"token": "****************",
"expired_at": "2025-01-02 19:41:14"
}
}