요청·응답

결제선생 파트너에서는 REST API(Representational State Transfer API) 형태로 서비스를 제공하고 있습니다.

요청 본문

결제선생 API를 호출할 때는 Json 형식을 사용해주세요. Charset의 경우에는 국제 표준 인코딩 방식인 UTF-8만 지원합니다.

key	value	description
Content-Type	application/json	요청 데이터 타입
charset	UTF-8	언어 설정

응답 본문

API 요청시 페이민트의 서버가 클라이언트 서버에게 전달하는 데이터 양식입니다. 모든 API 응답, 요청 본문은 JSON 형식입니다.

API v2 객체

{
  "code": "0000", //응답 코드
  "msg": "Success", //응답 메세지
  "data": { //응답 데이터 객체
  }
}

API v1 객체

{
  "code": "0000", //응답 코드
  "message": "Success", //응답 메세지
  "apikey": "partner-api-key",
  "member": "partner-merchant-1",
  "merchant": "partner-user-1",
  //api별 데이터 추가
}

응답 HTTP 상태 코드

HTTP 상태 코드	설명
200 - OK	요청이 성공적으로 처리되었습니다.
400 - Bad Request	요청을 처리할 수 없습니다. 필수 파라미터를 보내지 않았거나, 파라미터 포맷이 잘못되었을 때 돌아오는 응답입니다. 요청 파라미터를 확인해주세요.
404 - Not Found	요청한 리소스가 존재하지 않습니다. 요청한 API 주소를 다시 한번 확인해보세요.
500 - Server Error	결제선생 서버에서 에러가 발생했습니다.