Overview

Berith BaaS API는 블록체인 환경에 대해 잘 모르는 개발자라도 베리드가 제공하는 API를 활용해 서비스를 개발하고 운영, 모니터링 할 수 있도록 통합 비즈니스 API를 제공합니다.

Blockchain기반 Berith BaaS 서비스

• NFT

  대체 불가능한 토큰으로 블록체인 기술을 활용하여 자신의 작품을 디지털 자산으로 발행하고 평가 받을 수 있습니다.

• 전자계약

  블록체인 인증으로 투명한 전자계약체결이 가능한 개방형 블록체인전자계약 플랫폼 입니다.

• Enterprise

  블록체인 활용을 원하는 기업을 위한 맞춤형 솔루션으로 블록체인 설치부터 관리, 모니터링까지 한번에 제공합니다.

• Wallet

  암호화폐 사용자에게 필요한 다양한 기능을 제공함으로써 사용자는 안정적이고 편리하게 서비스를 이용하실 수 있습니다.

• Pay

  블록체인과 핀테크 기술을 결합한 온/오프라인 지불 결제 서비스 입니다.

• Membership

  규모와 지역에 제약 없이 적용 가능하며 소상공인도 쉽게 적용, 사용 가능한 종합 마켓팅 플랫폼 입니다.

• SSO

  블록체인 기반 통합 SSO플랫폼으로 단 한번의 로그인만으로 기업의 각종 시스템과 서비스에 접속이 가능합니다.

• 전자투표

  블록체인 기술 기반으로 정확한 투표 기록을 작성하고 결정을 내릴 수 있는 방식을 제시하는 플랫폼 입니다.

• 추첨

  블록체인을 이용한 이벤트 추첨 시스템으로 스마트 컨트랙트를 이용해 이벤트 생성과 추첨을 자동화하였습니다.

• 이력추적

  블록체인 기반의 데이터 검증 및 추적시스템으로 기록된 데이터와 이벤트의 히스토리를 추적 관리하는 서비스 입니다.

계정, 체인, 전자서명 트랜잭션, 개인키 생성 외 블록체인 자체검사, 노드로그 조회 등 다양한 블록체인 라이브러리를 제공하여 블록체인을 쉽게 접근하여 개발할 수 있도록 합니다.

회원

CI 중복 체크

HTTP request

POST /api/member/join/duplicateCheckCi HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 27
Host: {url}

{
    "SEF_CERT_CI" : "b"
}
                        

Curl request

$ curl 'https://baas.berith.co/v1/api/member/join/duplicateCheckCi' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
        "SEF_CERT_CI" : "b"
}'
                        

Request headers

Name	Description
Content-Type	application/json

Request fields

Path	Type	Optional	Description
SEF_CERT_CI	String		본인 인증 CI

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 113

{
	"resultCode" : "E2001",
	"resultMessage" : "이미 가입된 회원입니다.",
	"resultData" : false
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Boolean		처리 결과

회원 등록

HTTP request

POST /api/member/join/join HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 1164
Host: {url}

{
	"WRLS_TEL_NO2" : "7747",
	"WRLS_TEL_NO3" : "8226",
	"NTRY_PATH" : null,
	"STPL_AGRM" : [ {
		"COOPCO_CD" : "7000",
		"STPL_TYP_CD" : "10",
		"AGRM_YN" : "Y",
		"AGRM_DT" : "20211015",
		"AGRM_HR" : "140838",
		"AGRM_END_DT" : null,
		"AGRM_END_HR" : null
	}, {
		"COOPCO_CD" : "7000",
		"STPL_TYP_CD" : "20",
		"AGRM_YN" : "Y",
		"AGRM_DT" : "20211015",
		"AGRM_HR" : "140838",
		"AGRM_END_DT" : null,
		"AGRM_END_HR" : null
	}, {
		"COOPCO_CD" : "7010",
		"STPL_TYP_CD" : "30",
		"AGRM_YN" : "Y",
		"AGRM_DT" : "20211015",
		"AGRM_HR" : "140838",
		"AGRM_END_DT" : null,
		"AGRM_END_HR" : null
	}, {
		"COOPCO_CD" : "7020",
		"STPL_TYP_CD" : "30",
		"AGRM_YN" : "N",
		"AGRM_DT" : null,
		"AGRM_HR" : null,
		"AGRM_END_DT" : "20211015",
		"AGRM_END_HR" : "140838"
	} ],
	"GNDR_DV_CD" : "M",
	"NTRY_COOPCO_CD" : null,
	"NTRY_CHNL_CD" : null,
	"SEF_CERT_CI" : "20211015140838",
	"EML_ADDR" : "aaa@aaa.com",
	"BTDY" : "20211015",
	"MMB_ID" : "20211015140838",
	"PWD" : "20211015140838",
	"MMB_NM" : "20211015140838",
	"WRLS_TEL_NO1" : "010"
}

Curl request

$ curl 'https://baas.berith.co/v1/api/member/join/join' -i -X POST \
	-H 'Content-Type: application/json;charset=UTF-8' \
	-d '{
"WRLS_TEL_NO2" : "7747",
"WRLS_TEL_NO3" : "8226",
"NTRY_PATH" : null,
"STPL_AGRM" : [ {
	"COOPCO_CD" : "7000",
	"STPL_TYP_CD" : "10",
	"AGRM_YN" : "Y",
	"AGRM_DT" : "20211015",
	"AGRM_HR" : "140838",
	"AGRM_END_DT" : null,
	"AGRM_END_HR" : null
}, {
	"COOPCO_CD" : "7000",
	"STPL_TYP_CD" : "20",
	"AGRM_YN" : "Y",
	"AGRM_DT" : "20211015",
	"AGRM_HR" : "140838",
	"AGRM_END_DT" : null,
	"AGRM_END_HR" : null
}, {
	"COOPCO_CD" : "7010",
	"STPL_TYP_CD" : "30",
	"AGRM_YN" : "Y",
	"AGRM_DT" : "20211015",
	"AGRM_HR" : "140838",
	"AGRM_END_DT" : null,
	"AGRM_END_HR" : null
}, {
	"COOPCO_CD" : "7020",
	"STPL_TYP_CD" : "30",
	"AGRM_YN" : "N",
	"AGRM_DT" : null,
	"AGRM_HR" : null,
	"AGRM_END_DT" : "20211015",
	"AGRM_END_HR" : "140838"
} ],
"GNDR_DV_CD" : "M",
"NTRY_COOPCO_CD" : null,
"NTRY_CHNL_CD" : null,
"SEF_CERT_CI" : "20211015140838",
"EML_ADDR" : "aaa@aaa.com",
"BTDY" : "20211015",
"MMB_ID" : "20211015140838",
"PWD" : "20211015140838",
"MMB_NM" : "20211015140838",
"WRLS_TEL_NO1" : "010"
}'

Request headers

Name	Description
Content-Type	application/json

Request fields

Path	Type	Optional	Description
MMB_NM	String		회원 명
MMB_ID	String		회원 ID
PWD	String		비밀번호
BTDY	String		생일
GNDR_DV_CD	String		성별 구분 코드(M/F)
SEF_CERT_CI	String		본인 인증 CI
NTRY_COOPCO_CD	String	true	가입 제휴사 코드
NTRY_CHNL_CD	String	true	가입 채널 코드
NTRY_PATH	String	true	가입 경로
WRLS_TEL_NO1	String		무선 전화 번호1
WRLS_TEL_NO2	String		무선 전화 번호2
WRLS_TEL_NO3	String		무선 전화 번호3
EML_ADDR	String		이메일 주소
STPL_AGRM	Array		약관 동의 정보

Request fields-stplagrm

Path	Type	Optional	Description
COOPCO_CD	String		제휴사 코드
STPL_TYP_CD	String		약관 유형 코드
AGRM_YN	String		동의 여부(Y/N)
AGRM_DT	String	true	동의 일자 - 동의 여부 Y
AGRM_HR	String	true	동의 시간 - 동의 여부 Y
AGRM_END_DT	String	true	동의 종료 일자 - 동의 여부 N
AGRM_END_HR	String	true	동의 종료 시간 - 동의 여부 N

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1551

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"WRLS_TEL_NO2" : "7747",
		"WRLS_TEL_NO3" : "8226",
		"NTRY_PATH" : null,
		"STPL_AGRM" : [ {
			"COOPCO_CD" : "7000",
			"STPL_TYP_CD" : "10",
			"AGRM_YN" : "Y",
			"AGRM_DT" : "20211015",
			"AGRM_HR" : "140838",
			"AGRM_END_DT" : null,
			"AGRM_END_HR" : null,
			"UNFY_MMB_NO" : 293
		}, {
			"COOPCO_CD" : "7000",
			"STPL_TYP_CD" : "20",
			"AGRM_YN" : "Y",
			"AGRM_DT" : "20211015",
			"AGRM_HR" : "140838",
			"AGRM_END_DT" : null,
			"AGRM_END_HR" : null,
			"UNFY_MMB_NO" : 293
		}, {
			"COOPCO_CD" : "7010",
			"STPL_TYP_CD" : "30",
			"AGRM_YN" : "Y",
			"AGRM_DT" : "20211015",
			"AGRM_HR" : "140838",
			"AGRM_END_DT" : null,
			"AGRM_END_HR" : null,
			"UNFY_MMB_NO" : 293
		}, {
			"COOPCO_CD" : "7020",
			"STPL_TYP_CD" : "30",
			"AGRM_YN" : "N",
			"AGRM_DT" : null,
			"AGRM_HR" : null,
			"AGRM_END_DT" : "20211015",
			"AGRM_END_HR" : "140838",
			"UNFY_MMB_NO" : 293
		} ],
		"GNDR_DV_CD" : "M",
		"UNFY_MMB_NO" : 293,
		"NTRY_COOPCO_CD" : null,
		"NTRY_CHNL_CD" : null,
		"SEF_CERT_CI" : "20211015140838",
		"EML_ADDR" : "aaa@aaa.com",
		"BTDY" : "20211015",
		"MMB_ID" : "20211015140838",
		"PWD" : "08DA1AE3D982A390AD987567DE6FB009BDCCF40A7D046BD7C3AE8BF47D967187",
		"MMB_NM" : "20211015140838",
		"WRLS_TEL_NO1" : "010"
	}
}

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	Number		통합 회원 번호
MMB_NM	String		회원 명
MMB_ID	String		회원 ID
PWD	String		비밀번호
BTDY	String		생일
GNDR_DV_CD	String		성별 구분 코드(M/F)
SEF_CERT_CI	String		본인 인증 CI
NTRY_COOPCO_CD	String	true	가입 제휴사 코드
NTRY_CHNL_CD	String	true	가입 채널 코드
NTRY_PATH	String	true	가입 경로
WRLS_TEL_NO1	String		무선 전화 번호1
WRLS_TEL_NO2	String		무선 전화 번호2
WRLS_TEL_NO3	String		무선 전화 번호3
EML_ADDR	String		이메일 주소
STPL_AGRM	Array		약관 동의 정보

Response fields-stplagrm

Path	Type	Optional	Description
COOPCO_CD	String		제휴사 코드
STPL_TYP_CD	String		약관 유형 코드
AGRM_YN	String		동의 여부(Y/N)
AGRM_DT	String	true	동의 일자 - 동의 여부 Y
AGRM_HR	String	true	동의 시간 - 동의 여부 Y
AGRM_END_DT	String	true	동의 종료 일자 - 동의 여부 N
AGRM_END_HR	String	true	동의 종료 시간 - 동의 여부 N

회원 정보 조회

HTTP request

POST /api/member/info/getMemberInfo HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOH0.RBO0lRaVeGjjLDNQZs3Ua6Z7GhltiX5wQCc_xqdoC3A
Content-Length: 28
Host: {url}

{
	"UNFY_MMB_NO" : "34"
}
							

Curl request

$ curl 'https://baas.berith.co/v1/api/member/info/getMemberInfo' -i -X POST \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOH0.RBO0lRaVeGjjLDNQZs3Ua6Z7GhltiX5wQCc_xqdoC3A' \
-d '{
"UNFY_MMB_NO" : "34"
}'
							

Request fields

Name	Description
Content-Type	application/json
x-auth-token	토큰

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 977

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"REG_DTM" : 1630309860000,
		"MMB_ST_CD" : "1",
		"WRLS_TEL_NO2" : "ZuPqTBcXUAhkqChEd1pbEg==",
		"WRLS_TEL_NO3" : "3eLUC2Yh6TInAyVHRohKJA==",
		"STPL_AGRM_DTM" : 1630309860000,
		"NTRY_PATH" : null,
		"GNDR_DV_CD" : "JKd0c0jKF3VkSWxKESdbBw==",
		"UNFY_MMB_NO" : 34,
		"NTRY_COOPCO_CD" : null,
		"NTRY_CHNL_CD" : null,
		"CRD_NO" : null,
		"SEF_CERT_CI" : "MFvwbvB96mxTX19lL/SgWw==",
		"AG_NTRY_YN" : null,
		"TMP_PWD_YN" : "N",
		"EML_ADDR" : "KGlENVoyFvxlXQbhq6aTV+C0EZsOOheQZmgkG9LjLwE=",
		"BTDY" : "1wq82DPQsljAQD93vyg9Wg==",
		"CRD_REG_DTM" : 1630309860000,
		"UPD_DTM" : 1633412597000,
		"MMB_ID" : "lCfCRkAk5u3t9IDJxDQGug==",
		"PWD" : "7B521E15DD384168A914867DED0C24D62189CE32B31C79B0D0B60D0E95169ADF",
		"MMB_NM" : "MFvwbvB96mxTX19lL/SgWw==",
		"WRLS_TEL_NO1" : "k4xtAN3OMS7fL/5BBKkWvA=="
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	Number		통합 회원 번호
MMB_NM	String		회원 명
MMB_ID	String		회원 ID
TMP_PWD_YN	String		임시 비밀번호 여부
PWD	String		비밀번호
BTDY	String		생일
GNDR_DV_CD	String		성별 구분 코드
SEF_CERT_CI	String		본인 인증 CI
AG_NTRY_YN	String	true	재 가입 여부
NTRY_COOPCO_CD	String	true	가입 제휴사 코드
NTRY_CHNL_CD	String	true	가입 채널 코드
NTRY_PATH	String	true	가입 경로
MMB_ST_CD	String		회원 상태 코드
WRLS_TEL_NO1	String		무선 전화 번호1
WRLS_TEL_NO2	String		무선 전화 번호2
WRLS_TEL_NO3	String		무선 전화 번호3
EML_ADDR	String		이메일 주소
CRD_NO	String	true	카드 번호
CRD_REG_DTM	Number		카드 등록 일시
REG_DTM	Number		등록 일시
UPD_DTM	Number		변경 일시
STPL_AGRM_DTM	Number		약관 동의 일시

회원 약관 동의 여부 조회

HTTP request

POST /api/member/info/getMemberAgreeList HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOH0.RBO0lRaVeGjjLDNQZs3Ua6Z7GhltiX5wQCc_xqdoC3A
Content-Length: 29
Host: {url}

{
	"UNFY_MMB_NO" : "113"
}
							

Curl request

$ curl 'https://baas.berith.co/v1/api/member/info/getMemberAgreeList' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOH0.RBO0lRaVeGjjLDNQZs3Ua6Z7GhltiX5wQCc_xqdoC3A' \
		-d '{
	"UNFY_MMB_NO" : "113"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
UNFY_MMB_NO	String		통합 회원 번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 799

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : [ {
		"UNFY_MMB_NO" : 113,
		"AGRM_DTM" : "20210917091341",
		"AGRM_YN" : "Y",
		"STPL_TYP_CD" : "10",
		"COOPCO_CD" : "7000",
		"AGRM_END_DTM" : null
	}, {
		"UNFY_MMB_NO" : 113,
		"AGRM_DTM" : "20210917091341",
		"AGRM_YN" : "Y",
		"STPL_TYP_CD" : "20",
		"COOPCO_CD" : "7000",
		"AGRM_END_DTM" : null
	}, {
		"UNFY_MMB_NO" : 113,
		"AGRM_DTM" : "20210917091341",
		"AGRM_YN" : "Y",
		"STPL_TYP_CD" : "30",
		"COOPCO_CD" : "7000",
		"AGRM_END_DTM" : null
	}, {
		"UNFY_MMB_NO" : 113,
		"AGRM_DTM" : null,
		"AGRM_YN" : "N",
		"STPL_TYP_CD" : "30",
		"COOPCO_CD" : "7020",
		"AGRM_END_DTM" : "20210917091341"
	} ]
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData[]	Array		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	Number		통합 회원 번호
COOPCO_CD	String		제휴사 코드
STPL_TYP_CD	String		약관 유형 코드
AGRM_YN	String		동의 여부(Y/N)
AGRM_DTM	String	true	동의 일시
AGRM_END_DTM	String	true	철회 일시

로그인

제휴사로그인, 일반로그인 관련 API를 제공합니다.

제휴사 로그인

제휴사 로그인 성공

HTTP request

POST /api/login/coopcoLogin HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 47
Host: {url}

{
	"COOPCO_CD" : "7000",
	"PWD" : "sang"
}
							

Curl request

curl 'https://baas.berith.co/v1/api/login/coopcoLogin' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-d '{
	"COOPCO_CD" : "7000",
	"PWD" : "sang"
}'
							

Request fields

Path	Type	Optional	Description
COOPCO_CD	String		제휴사 코드
PWD	String		제휴사 로그인 비밀번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 239

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxN30.GCZq_2p5pXtojrrPjWnZUIyeigAmOiwVp3KCsR1NtL8"
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	String		토큰

제휴사 로그인 실패

HTTP request

POST /api/login/coopcoLogin HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 55
Host: {url}

{
	"COOPCO_CD" : "7000",
	"PWD" : "asdflj;lasdf"
}
							

Curl request

$ curl 'https://baas.berith.co/v1/api/login/coopcoLogin' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "COOPCO_CD" : "7000",
  "PWD" : "asdflj;lasdf"
}'
							

Request fields

Path	Type	Optional	Description
COOPCO_CD	String		제휴사 코드
PWD	String		제휴사 로그인 비밀번호

HTTP response

HTTP/1.1 200 OK
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 78

{
	"resultCode" : "E0003",
	"resultMessage" : "제휴사 인증 실패"
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지

로그인 성공

HTTP request

POST /api/login/login HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 50
Host: {url}

{
	"MMB_ID" : "sangkimyul",
	"PWD" : "sang"
}
							

Curl request

$ curl 'https://baas.berith.co/v1/api/login/login' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-d '{
	"MMB_ID" : "sangkimyul",
	"PWD" : "sang"
}'
							

Request fields

Path	Type	Optional	Description
MMB_ID	String		회원 ID
PWD	String		비밀번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 793

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"REG_DTM" : 1630309860000,
		"MMB_ST_CD" : "1",
		"WRLS_TEL_NO2" : "7747",
		"WRLS_TEL_NO3" : "8226",
		"STPL_AGRM_DTM" : 1630309860000,
		"NTRY_PATH" : null,
		"GNDR_DV_CD" : "M",
		"UNFY_MMB_NO" : 34,
		"NTRY_COOPCO_CD" : null,
		"NTRY_CHNL_CD" : null,
		"CRD_NO" : null,
		"SEF_CERT_CI" : "b",
		"AG_NTRY_YN" : null,
		"TMP_PWD_YN" : "N",
		"EML_ADDR" : "sangkimyul@naver.com",
		"BTDY" : "19870117",
		"CRD_REG_DTM" : 1630309860000,
		"UPD_DTM" : 1633412597000,
		"MMB_ID" : "sangkimyul",
		"PWD" : "7B521E15DD384168A914867DED0C24D62189CE32B31C79B0D0B60D0E95169ADF",
		"MMB_NM" : "b",
		"WRLS_TEL_NO1" : "010"
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	Number		통합 회원 번호
MMB_NM	String		회원 명
MMB_ID	String		회원 ID
TMP_PWD_YN	String		임시 비밀번호 여부
PWD	String		비밀번호
BTDY	String		생일
GNDR_DV_CD	String		성별 구분 코드
SEF_CERT_CI	String		본인 인증 CI
AG_NTRY_YN	String	true	재 가입 여부
NTRY_COOPCO_CD	String	true	가입 제휴사 코드
NTRY_CHNL_CD	String	true	가입 채널 코드
NTRY_PATH	String	true	가입 경로
MMB_ST_CD	String		회원 상태 코드
WRLS_TEL_NO1	String		무선 전화 번호1
WRLS_TEL_NO2	String		무선 전화 번호2
WRLS_TEL_NO3	String		무선 전화 번호3
EML_ADDR	String		이메일 주소
CRD_NO	String	true	카드 번호
CRD_REG_DTM	Number		카드 등록 일시
REG_DTM	Number		등록 일시
UPD_DTM	Number		변경 일시
STPL_AGRM_DTM	Number		약관 동의 일시

로그인 실패

HTTP request

								POST /api/login/login HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 58
Host: {url}

{
	"MMB_ID" : "sangkimyul",
	"PWD" : "asdflj;lasdf"
}
							

Curl request

$ curl https://baas.berith.co/v1/api/login/login' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-d '{
	"MMB_ID" : "sangkimyul",
	"PWD" : "asdflj;lasdf"
}'
							

Request fields

Path	Type	Optional	Description
MMB_ID	String		로그인 ID
PWD	String		로그인 비밀번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 78

{
	"resultCode" : "E0002",
	"resultMessage" : "사용자 인증 실패"
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

SSO로그인

SSO Server API는 SSO Agent의 Method를 호출하는 방식과 SSO VIEW URL을 호출(Web Browser에서 접근)하는 방식으로 구분된다

SSO 세션 생성 요청(WEB, APP)

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path	Type	Optional	Description
chnnlCode	String		채널 코드(PC, APP)
unityMberNo	Number		통합 회원 번호

HTTP response

내용없음
							

Response fields

Path	Type	Optional	Description
ssoAuthToken	String		sso 토큰

SSO 로그인을 위한 인증 토큰 요청(WEB)

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path	Type	Optional	Description
chnnlCode	String		채널 코드(PC)

HTTP response

내용없음
							

Response fields

Path	Type	Optional	Description
ssoAuthToken	String		sso 토큰

SSO 로그아웃을 위한 인증 토큰 요청(WEB)

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path	Type	Optional	Description
chnnlCode	String		채널 코드(PC)

HTTP response

내용없음
							

Response fields

Path	Type	Optional	Description
ssoAuthToken	String		sso 토큰

회원정보 요청(WEB, APP)

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path	Type	Optional	Description
chnnlCode	String		채널 코드(PC, APP)
ssoAuthToken	String		sso 토큰

HTTP response

내용없음
							

Response fields

Path	Type	Optional	Description
unityMberNo	Number		통합 회원 번호

SSO 세션 생성 요청(APP) [서버 SFA방식]

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path	Type	Optional	Description
chnnlCode	String		채널 코드(APP)
unityMberNo	Number		통합 회원 번호

HTTP response

내용없음
							

Response fields

Path	Type	Optional	Description
ssoAuthToken	String		sso 토큰

회원정보 요청(APP) [서버 SFA방식]

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path	Type	Optional	Description
chnnlCode	String		채널 코드(APP)
ssoAuthToken	String		sso 토큰

HTTP response

내용없음
							

Response fields

Path	Type	Optional	Description
unityMberNo	Number		통합 회원 번호

회원정보 삭제(APP) [서버 SFA방식]

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path	Type	Optional	Description
chnnlCode	String		채널 코드(PC, APP)
ssoAuthToken	String		sso 토큰
unityMberNo	Number		통합 회원 번호

HTTP response

내용없음
							

Response fields

Path	Type	Optional	Description
resultCode	String		결과 코드

최초 로그인(WEB)

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path	Type	Optional	Description
chnnlCode	String		채널 코드(PC)
ssoAuthToken	String		sso 토큰
returnUrl	String		로그인 이후 화면 url

SSO 로그인(WEB)

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path	Type	Optional	Description
chnnlCode	String		채널 코드(PC)
ssoAuthToken	String		sso 토큰
returnUrl	String		로그인 이후 화면 url

SSO 로그아웃(WEB)

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path	Type	Optional	Description
chnnlCode	String		채널 코드(PC, APP)
ssoAuthToken	String		sso 토큰
returnUrl	String		로그아웃 이후 화면 url

멤버십

멤버십 포인트 적립, 사용 관련 API를 제공합니다.

포인트 적립 - 회원

HTTP request

POST /api/point/saveMemberPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o
Content-Length: 657
Host: {url}

{
	"ACML_TGT_AMT" : "50",
	"TRC_NO" : "20211015140840",
	"TOT_DC_AMT" : "",
	"PINT_ACML_TYP_CD" : "10",
	"TRSC_TYP_CD" : "200",
	"VALD_TRM" : "1",
	"TRSC_RSN_CD" : "RR01",
	"TRSC_DT" : "20211015",
	"BRND_CD" : "2000",
	"MBRSH_DC_AMT" : "",
	"MBRSH_PINT_SETL_YN" : "N",
	"CHNL_TYP_CD" : "1",
	"TRSC_ORGN_DV_CD" : "10",
	"STOR_NO" : "2000",
	"ACML_PINT" : "123",
	"TOT_SEL_AMT" : "5000",
	"COOPCO_CD" : "7000",
	"MMB_CERT_DV_VLU" : "34",
	"TRSC_BIZ_DV_CD" : "21",
	"TRSC_HR" : "140840",
	"RMK" : "",
	"MMB_CERT_DV_CD" : "2",
	"AFT_ACML_YN" : "N",
	"UNIQ_RCGN_NO" : "20211015140840",
	"VALD_TRM_DV_CD" : "1"
}
							

Curl request

$ curl 'https://baas.berith.co/v1/api/point/saveMemberPoint' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o' \
		-d '{
	"ACML_TGT_AMT" : "50",
	"TRC_NO" : "20211015140840",
	"TOT_DC_AMT" : "",
	"PINT_ACML_TYP_CD" : "10",
	"TRSC_TYP_CD" : "200",
	"VALD_TRM" : "1",
	"TRSC_RSN_CD" : "RR01",
	"TRSC_DT" : "20211015",
	"BRND_CD" : "2000",
	"MBRSH_DC_AMT" : "",
	"MBRSH_PINT_SETL_YN" : "N",
	"CHNL_TYP_CD" : "1",
	"TRSC_ORGN_DV_CD" : "10",
	"STOR_NO" : "2000",
	"ACML_PINT" : "123",
	"TOT_SEL_AMT" : "5000",
	"COOPCO_CD" : "7000",
	"MMB_CERT_DV_VLU" : "34",
	"TRSC_BIZ_DV_CD" : "21",
	"TRSC_HR" : "140840",
	"RMK" : "",
	"MMB_CERT_DV_CD" : "2",
	"AFT_ACML_YN" : "N",
	"UNIQ_RCGN_NO" : "20211015140840",
	"VALD_TRM_DV_CD" : "1"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
TRSC_TYP_CD	String		거래 유형 코드
TRSC_BIZ_DV_CD	String		업무 구분 코드
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
BRND_CD	String		브랜드 코드
STOR_NO	String		가맹점 코드
TRSC_ORGN_DV_CD	String		거래 발생 구분 코드
MMB_CERT_DV_CD	String		회원 인증 구분 코드
MMB_CERT_DV_VLU	String		회원 인증 구분값
TOT_SEL_AMT	String		총 매출 금액
TOT_DC_AMT	String		총 할인 금액
MBRSH_DC_AMT	String		멤버십 할인 금액
ACML_TGT_AMT	String		포인트 적립 대상 금액
TRSC_RSN_CD	String		거래 사유 코드
AFT_ACML_YN	String		사후 적립 여부
MBRSH_PINT_SETL_YN	String		멤버십 포인트 결제 여부
UNIQ_RCGN_NO	String		제휴사 고유 식별 번호
PINT_ACML_TYP_CD	String		포인트 적립 유형 코드
ACML_PINT	String		적립 포인트
VALD_TRM_DV_CD	String		유효 기간 구분
VALD_TRM	String		유효 개월수/기간
RMK	String		비고

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 529

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "210",
		"TRSC_BIZ_DV_CD" : "21",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140840",
		"TRC_NO" : "20211015140840",
		"CHNL_TYP_CD" : "1",
		"APV_DT" : "20211015",
		"APV_NO" : "9000000412",
		"ACML_PINT" : "123",
		"USE_PINT" : "0",
		"RMND_PINT" : 23625,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
TRSC_TYP_CD	String		거래 유형 코드
TRSC_BIZ_DV_CD	String		업무 구분 코드
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
APV_DT	String		통합 승인 일자
APV_NO	String		통합 승인 번호
ACML_PINT	String		적립 포인트
USE_PINT	String		사용 포인트
RMND_PINT	Number		잔여 포인트
RES_CD	String		응답 코드
RES_MSG	String		응답 메시지

포인트 적립 취소 - 회원

HTTP request

POST /api/point/saveMemberPointCancel HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o
Content-Length: 520
Host: {url}

{
	"STOR_NO" : "2000",
	"TRC_NO" : "20211015140842",
	"PINT_ACML_TYP_CD" : "10",
	"TRSC_TYP_CD" : "200",
	"ORG_UNIQ_RCGN_NO" : "20211015140840",
	"TRSC_RSN_CD" : "RR01",
	"ORG_APV_NO" : "9000000412",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "2000",
	"MMB_CERT_DV_VLU" : "34",
	"TRSC_BIZ_DV_CD" : "22",
	"ORG_APV_DT" : "20211015",
	"TRSC_HR" : "140842",
	"MMB_CERT_DV_CD" : "2",
	"CHNL_TYP_CD" : "1",
	"TRSC_ORGN_DV_CD" : "10",
	"UNIQ_RCGN_NO" : "20211015140842"
}
							

Curl request

$ curl 'http://{url}/api/point/saveMemberPointCancel' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o' \
    -d '{
  "STOR_NO" : "2000",
  "TRC_NO" : "20211015140842",
  "PINT_ACML_TYP_CD" : "10",
  "TRSC_TYP_CD" : "200",
  "ORG_UNIQ_RCGN_NO" : "20211015140840",
  "TRSC_RSN_CD" : "RR01",
  "ORG_APV_NO" : "9000000412",
  "TRSC_DT" : "20211015",
  "COOPCO_CD" : "7000",
  "BRND_CD" : "2000",
  "MMB_CERT_DV_VLU" : "34",
  "TRSC_BIZ_DV_CD" : "22",
  "ORG_APV_DT" : "20211015",
  "TRSC_HR" : "140842",
  "MMB_CERT_DV_CD" : "2",
  "CHNL_TYP_CD" : "1",
  "TRSC_ORGN_DV_CD" : "10",
  "UNIQ_RCGN_NO" : "20211015140842"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
TRSC_TYP_CD	String		거래 유형 코드
TRSC_BIZ_DV_CD	String		업무 구분 코드
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
BRND_CD	String		브랜드 코드
STOR_NO	String		가맹점 코드
TRSC_ORGN_DV_CD	String		거래 발생 구분 코드
MMB_CERT_DV_CD	String		회원 인증 구분 코드
MMB_CERT_DV_VLU	String		회원 인증 구분값
TRSC_RSN_CD	String		거래 사유 코드
UNIQ_RCGN_NO	String		제휴사 고유 식별 번호
ORG_APV_DT	String		원 통합 승인 일자
ORG_APV_NO	String		원 통합 승인 번호
ORG_UNIQ_RCGN_NO	String		원 제휴사 고유 식별 번호
PINT_ACML_TYP_CD	String		포인트 적립 유형 코드

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 529

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "210",
		"TRSC_BIZ_DV_CD" : "22",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140842",
		"TRC_NO" : "20211015140842",
		"CHNL_TYP_CD" : "1",
		"APV_DT" : "20211015",
		"APV_NO" : "9000000413",
		"ACML_PINT" : "123",
		"USE_PINT" : "0",
		"RMND_PINT" : 23502,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
TRSC_TYP_CD	String		거래 유형 코드
TRSC_BIZ_DV_CD	String		업무 구분 코드
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
APV_DT	String		통합 승인 일자
APV_NO	String		통합 승인 번호
ACML_PINT	String		적립 포인트
USE_PINT	String		사용 포인트
RMND_PINT	Number		잔여 포인트
RES_CD	String		응답 코드
RES_MSG	String		응답 메시지

포인트 사용 - 회원

HTTP request

POST /api/point/useMemberPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMn0.KXRvkZcmJtrUqYfWl1veWqMbUHzYENG6QbDlHInffUs
Content-Length: 533
Host: {url}

{
	"STOR_NO" : "2000",
	"TRC_NO" : "20211015140842",
	"TOT_DC_AMT" : "1000",
	"TRSC_TYP_CD" : "300",
	"TRSC_RSN_CD" : "CD01",
	"TOT_SEL_AMT" : "5000",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "2000",
	"MMB_CERT_DV_VLU" : "34",
	"TRSC_BIZ_DV_CD" : "31",
	"MBRSH_DC_AMT" : "10",
	"USE_PINT" : "1000",
	"TRSC_HR" : "140842",
	"RMK" : "",
	"MMB_CERT_DV_CD" : "2",
	"PINT_USE_TYP_CD" : "11",
	"CHNL_TYP_CD" : "1",
	"TRSC_ORGN_DV_CD" : "10",
	"UNIQ_RCGN_NO" : "20211015140842"
}
							

Curl request

$ curl 'https://baas.berith.co/v1/api/point/useMemberPoint' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMn0.KXRvkZcmJtrUqYfWl1veWqMbUHzYENG6QbDlHInffUs' \
    -d '{
  "STOR_NO" : "2000",
  "TRC_NO" : "20211015140842",
  "TOT_DC_AMT" : "1000",
  "TRSC_TYP_CD" : "300",
  "TRSC_RSN_CD" : "CD01",
  "TOT_SEL_AMT" : "5000",
  "TRSC_DT" : "20211015",
  "COOPCO_CD" : "7000",
  "BRND_CD" : "2000",
  "MMB_CERT_DV_VLU" : "34",
  "TRSC_BIZ_DV_CD" : "31",
  "MBRSH_DC_AMT" : "10",
  "USE_PINT" : "1000",
  "TRSC_HR" : "140842",
  "RMK" : "",
  "MMB_CERT_DV_CD" : "2",
  "PINT_USE_TYP_CD" : "11",
  "CHNL_TYP_CD" : "1",
  "TRSC_ORGN_DV_CD" : "10",
  "UNIQ_RCGN_NO" : "20211015140842"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
TRSC_TYP_CD	String		거래 유형 코드
TRSC_BIZ_DV_CD	String		업무 구분 코드
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
BRND_CD	String		브랜드 코드
STOR_NO	String		가맹점 코드
TRSC_ORGN_DV_CD	String		거래 발생 구분 코드
MMB_CERT_DV_CD	String		회원 인증 구분 코드
MMB_CERT_DV_VLU	String		회원 인증 구분값
TOT_SEL_AMT	String		총 매출 금액
TOT_DC_AMT	String		총 할인 금액
MBRSH_DC_AMT	String		멤버십 할인 금액
TRSC_RSN_CD	String		거래 사유 코드
UNIQ_RCGN_NO	String		제휴사 고유 식별 번호
PINT_USE_TYP_CD	String		포인트 사용 유형 코드
USE_PINT	String		사용 포인트
RMK	String		비고

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 528

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "310",
		"TRSC_BIZ_DV_CD" : "31",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140842",
		"TRC_NO" : "20211015140842",
		"CHNL_TYP_CD" : "1",
		"APV_DT" : "20211015",
		"APV_NO" : "9000000414",
		"ACML_PINT" : 0,
		"USE_PINT" : "1000",
		"RMND_PINT" : 22502,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
TRSC_TYP_CD	String		거래 유형 코드
TRSC_BIZ_DV_CD	String		업무 구분 코드
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
APV_DT	String		통합 승인 일자
APV_NO	String		통합 승인 번호
ACML_PINT	Number		적립 포인트
USE_PINT	String		사용 포인트
RMND_PINT	Number		잔여 포인트
RES_CD	String		응답 코드
RES_MSG	String		응답 메시지

포인트 사용 취소 - 회원

HTTP request

POST /api/point/useMemberPointCancel HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMn0.KXRvkZcmJtrUqYfWl1veWqMbUHzYENG6QbDlHInffUs
Content-Length: 519
Host: {url}

{
	"STOR_NO" : "2000",
	"TRC_NO" : "20211015140844",
	"TRSC_TYP_CD" : "300",
	"ORG_UNIQ_RCGN_NO" : "20211015140842",
	"TRSC_RSN_CD" : "CD01",
	"ORG_APV_NO" : "9000000414",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "2000",
	"MMB_CERT_DV_VLU" : "34",
	"TRSC_BIZ_DV_CD" : "32",
	"ORG_APV_DT" : "20211015",
	"TRSC_HR" : "140844",
	"MMB_CERT_DV_CD" : "2",
	"PINT_USE_TYP_CD" : "11",
	"CHNL_TYP_CD" : "1",
	"TRSC_ORGN_DV_CD" : "10",
	"UNIQ_RCGN_NO" : "20211015140844"
}
							

Curl request

$ curl 'https://baas.berith.co/v1/api/point/useMemberPointCancel' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMn0.KXRvkZcmJtrUqYfWl1veWqMbUHzYENG6QbDlHInffUs' \
    -d '{
  "STOR_NO" : "2000",
  "TRC_NO" : "20211015140844",
  "TRSC_TYP_CD" : "300",
  "ORG_UNIQ_RCGN_NO" : "20211015140842",
  "TRSC_RSN_CD" : "CD01",
  "ORG_APV_NO" : "9000000414",
  "TRSC_DT" : "20211015",
  "COOPCO_CD" : "7000",
  "BRND_CD" : "2000",
  "MMB_CERT_DV_VLU" : "34",
  "TRSC_BIZ_DV_CD" : "32",
  "ORG_APV_DT" : "20211015",
  "TRSC_HR" : "140844",
  "MMB_CERT_DV_CD" : "2",
  "PINT_USE_TYP_CD" : "11",
  "CHNL_TYP_CD" : "1",
  "TRSC_ORGN_DV_CD" : "10",
  "UNIQ_RCGN_NO" : "20211015140844"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
TRSC_TYP_CD	String		거래 유형 코드
TRSC_BIZ_DV_CD	String		업무 구분 코드
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
BRND_CD	String		브랜드 코드
STOR_NO	String		가맹점 코드
TRSC_ORGN_DV_CD	String		거래 발생 구분 코드
MMB_CERT_DV_CD	String		회원 인증 구분 코드
MMB_CERT_DV_VLU	String		회원 인증 구분값
TRSC_RSN_CD	String		거래 사유 코드
UNIQ_RCGN_NO	String		제휴사 고유 식별 번호
ORG_APV_DT	String		원 통합 승인 일자
ORG_APV_NO	String		원 통합 승인 번호
ORG_UNIQ_RCGN_NO	String		원 제휴사 고유 식별 번호
PINT_USE_TYP_CD	String		포인트 사용 유형 코드

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 528

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "310",
		"TRSC_BIZ_DV_CD" : "32",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140844",
		"TRC_NO" : "20211015140844",
		"CHNL_TYP_CD" : "1",
		"APV_DT" : "20211015",
		"APV_NO" : "9000000415",
		"ACML_PINT" : 0,
		"USE_PINT" : "1000",
		"RMND_PINT" : 23502,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
TRSC_TYP_CD	String		거래 유형 코드
TRSC_BIZ_DV_CD	String		업무 구분 코드
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
APV_DT	String		통합 승인 일자
APV_NO	String		통합 승인 번호
ACML_PINT	Number		적립 포인트
USE_PINT	String		사용 포인트
RMND_PINT	Number		잔여 포인트
RES_CD	String		응답 코드
RES_MSG	String		응답 메시지

포인트 조회 - 회원

HTTP request

								POST /api/point/getMemberPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNX0.qqxXheeSKIxMlj5lW4a65tdtKNBEhzO-_SKdOgtzLhA
Content-Length: 53
Host: {url}

{
  "UNFY_MMB_NO" : "34",
  "COOPCO_CD" : "7000"
}
							

Curl request

$ curl 'http://{url}/api/point/getMemberPoint' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNX0.qqxXheeSKIxMlj5lW4a65tdtKNBEhzO-_SKdOgtzLhA' \
    -d '{
  "UNFY_MMB_NO" : "34",
  "COOPCO_CD" : "7000"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
COOPCO_CD	String		제휴사 코드
UNFY_MMB_NO	String		통합 회원 번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 311

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"UNFY_MMB_NO" : 34,
		"XTNCT_SCHE_PINT" : 25356,
		"USE_PINT_CMLT" : 7060,
		"TNSF_POSB_PINT" : 11502,
		"RMND_PINT" : 23502,
		"ACML_PINT_CMLT" : 30562,
		"STPL_AGRM_YN" : "Y"
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	Number		통합 회원 번호
STPL_AGRM_YN	String		제휴사 정보제공 동의 여부
RMND_PINT	Number		잔여 포인트
TNSF_POSB_PINT	Number		선물 가능 포인트
ACML_PINT_CMLT	Number		총 적립 누적 포인트
USE_PINT_CMLT	Number		총 사용 누적 포인트
XTNCT_SCHE_PINT	Number		당월 소멸 예정 포인트

총 적립 포인트(누적) 조회 - 회원

HTTP request

POST /api/point/getMemberTotalSavedPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o
Content-Length: 28
Host: {url}

{
	"UNFY_MMB_NO" : "34"
}
							

Curl request

$ curl 'http://{url}/api/point/getMemberTotalSavedPoint' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o' \
    -d '{
  "UNFY_MMB_NO" : "34"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
UNFY_MMB_NO	String		통합 회원 번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 166

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"UNFY_MMB_NO" : 34,
		"ACML_PINT_CMLT" : 30562
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	Number		통합 회원 번호
ACML_PINT_CMLT	Number		총 적립 누적 포인트

총 사용 포인트(누적) 조회 - 회원

HTTP request

POST /api/point/getMemberTotalUsedPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNH0.nfk5Z3mDTc8cLh3gN_AyYUd2Dq07A7WsFJBA0Me6-jc
Content-Length: 28
Host: {url}

{
	"UNFY_MMB_NO" : "34"
}
							

Curl request

$ curl 'http://{url}/api/point/getMemberTotalUsedPoint' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNH0.nfk5Z3mDTc8cLh3gN_AyYUd2Dq07A7WsFJBA0Me6-jc' \
    -d '{
  "UNFY_MMB_NO" : "34"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
UNFY_MMB_NO	String		통합 회원 번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 164

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"UNFY_MMB_NO" : 34,
		"USE_PINT_CMLT" : 7060
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	Number		통합 회원 번호
USE_PINT_CMLT	Number		총 사용 누적 포인트

포인트 거래 내역(소멸, 적립, 사용) 조회 - 회원

HTTP request

POST /api/point/listMemberPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA
Content-Length: 316
Host: {url}

{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140839",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140839",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}
							

Curl request

$ curl 'http://{url}/api/point/listMemberPoint' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA' \
    -d '{
  "STOR_NO" : "1000",
  "TRC_NO" : "20211015140839",
  "SRCH_DV_VLU" : "34",
  "SRCH_DV" : "2",
  "PAGE" : "1",
  "LIMIT" : "5",
  "TRSC_DT" : "20211015",
  "COOPCO_CD" : "7000",
  "BRND_CD" : "1000",
  "START_DT" : "20210915",
  "TRSC_HR" : "140839",
  "CHNL_TYP_CD" : "1",
  "END_DT" : "20211015"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
BRND_CD	String		브랜드 코드
STOR_NO	String		가맹점 코드
SRCH_DV	String		회원 인증 구분 코드
SRCH_DV_VLU	String		회원 인증 구분값
START_DT	String		조회 시작 일자
END_DT	String		조회 종료 일자
PAGE	String		페이지 번호
LIMIT	String		페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2378

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "130",
		"TRSC_BIZ_DV_CD" : "10",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140839",
		"TRC_NO" : "20211015140839",
		"CHNL_TYP_CD" : "1",
		"RESULTS" : [ {
			"TRSC_HR" : "140521",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 1,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000411",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140521",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 2,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000410",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 31,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140519",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 3,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000409",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 22,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140519",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140517",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 4,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000408",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 21,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140517",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140459",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 5,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000407",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140459",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		} ],
		"UNFY_MMB_NO" : "34",
		"RMND_PINT" : "23502",
		"TOTAL_PAGE" : 33,
		"TOTAL_CNT" : 161,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	String		통합 회원 번호
TOTAL_PAGE	Number		전체 페이지 수
TOTAL_CNT	Number		전체 내역 수
RMND_PINT	String		잔여 포인트
RES_CD	String		응답 코드
RES_MSG	String		응답 메시지
RESULTS	Array		조회 결과

Response fields-resultdata-results

Path	Type	Optional	Description
RNUM	Number		순번
APV_DT	String		통합 승인 일자
APV_NO	String		통합 승인 번호
PINT_CAN_POSB_YN	String		취소 가능 여부
TRSC_RSN_CD	String		거래 사유 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRSC_DV_CD	Number		거래 구분 코드
PINT	Number		포인트
STOR_NM	String		사용처
RMK	String		포인트 내용
UNIQ_RCGN_NO	String		제휴사 고유 식별 번호

포인트 거래 적립 내역 조회 - 회원

HTTP request

POST /api/point/listMemberSavedPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA
Content-Length: 316
Host: {url}

{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140839",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140839",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}
							

Curl request

$ curl 'https://baas.berith.co/v1/api/point/listMemberSavedPoint' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA' \
		-d '{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140839",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140839",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
BRND_CD	String		브랜드 코드
STOR_NO	String		가맹점 코드
SRCH_DV	String		회원 인증 구분 코드
SRCH_DV_VLU	String		회원 인증 구분값
START_DT	String		조회 시작 일자
END_DT	String		조회 종료 일자
PAGE	String		페이지 번호
LIMIT	String		페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2374

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "130",
		"TRSC_BIZ_DV_CD" : "20",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140839",
		"TRC_NO" : "20211015140839",
		"CHNL_TYP_CD" : "1",
		"RESULTS" : [ {
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 1,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000409",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 22,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140519",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140517",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 2,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000408",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 21,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140517",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140456",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 3,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000405",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 22,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140456",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140454",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 4,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000404",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 21,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140454",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "135505",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 5,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000401",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 22,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015135505",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		} ],
		"UNFY_MMB_NO" : "34",
		"RMND_PINT" : "23502",
		"TOTAL_PAGE" : 17,
		"TOTAL_CNT" : 81,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	String		통합 회원 번호
TOTAL_PAGE	Number		전체 페이지 수
TOTAL_CNT	Number		전체 내역 수
RMND_PINT	String		잔여 포인트
RES_CD	String		응답 코드
RES_MSG	String		응답 메시지
RESULTS	Array		조회 결과

Response fields-resultdata-results

Path	Type	Optional	Description
RNUM	Number		순번
APV_DT	String		통합 승인 일자
APV_NO	String		통합 승인 번호
PINT_CAN_POSB_YN	String		취소 가능 여부
TRSC_RSN_CD	String		거래 사유 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRSC_DV_CD	Number		거래 구분 코드
PINT	Number		포인트
STOR_NM	String		사용처
RMK	String		포인트 내용
UNIQ_RCGN_NO	String		제휴사 고유 식별 번호

포인트 거래 사용 내역 조회 - 회원

HTTP request

POST /api/point/listMemberUsedPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNX0.qqxXheeSKIxMlj5lW4a65tdtKNBEhzO-_SKdOgtzLhA
Content-Length: 316
Host: {url}

{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140845",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140845",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}
							

Curl request

$ curl 'https://baas.berith.co/v1/api/point/listMemberUsedPoint' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNX0.qqxXheeSKIxMlj5lW4a65tdtKNBEhzO-_SKdOgtzLhA' \
		-d '{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140845",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140845",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
BRND_CD	String		브랜드 코드
STOR_NO	String		가맹점 코드
SRCH_DV	String		회원 인증 구분 코드
SRCH_DV_VLU	String		회원 인증 구분값
START_DT	String		조회 시작 일자
END_DT	String		조회 종료 일자
PAGE	String		페이지 번호
LIMIT	String		페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2379

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "130",
		"TRSC_BIZ_DV_CD" : "30",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140845",
		"TRC_NO" : "20211015140845",
		"CHNL_TYP_CD" : "1",
		"RESULTS" : [ {
			"TRSC_HR" : "140844",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 1,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000415",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140844",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140842",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 2,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000414",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 31,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140842",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140521",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 3,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000411",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140521",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 4,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000410",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 31,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140519",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140459",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 5,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000407",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140459",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		} ],
		"UNFY_MMB_NO" : "34",
		"RMND_PINT" : "23502",
		"TOTAL_PAGE" : 17,
		"TOTAL_CNT" : 81,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description

Response fields-resultdata-results

Path	Type	Optional	Description
RNUM	Number		순번
APV_DT	String		통합 승인 일자
APV_NO	String		통합 승인 번호
PINT_CAN_POSB_YN	String		취소 가능 여부
TRSC_RSN_CD	String		거래 사유 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRSC_DV_CD	Number		거래 구분 코드
PINT	Number		포인트
STOR_NM	String		사용처
RMK	String		포인트 내용
UNIQ_RCGN_NO	String		제휴사 고유 식별 번호

포인트 거래 소멸 내역 조회 - 회원

HTTP request

POST /api/point/listMemberDisappearedPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA
Content-Length: 316
Host: {url}

{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140838",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140838",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}
							

Curl request

$ curl 'https://baas.berith.co/v1/api/point/listMemberDisappearedPoint' -i -X POST \
	-H 'Content-Type: application/json;charset=UTF-8' \
	-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA' \
	-d '{
"STOR_NO" : "1000",
"TRC_NO" : "20211015140838",
"SRCH_DV_VLU" : "34",
"SRCH_DV" : "2",
"PAGE" : "1",
"LIMIT" : "5",
"TRSC_DT" : "20211015",
"COOPCO_CD" : "7000",
"BRND_CD" : "1000",
"START_DT" : "20210915",
"TRSC_HR" : "140838",
"CHNL_TYP_CD" : "1",
"END_DT" : "20211015"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
BRND_CD	String		브랜드 코드
STOR_NO	String		가맹점 코드
SRCH_DV	String		회원 인증 구분 코드
SRCH_DV_VLU	String		회원 인증 구분값
START_DT	String		조회 시작 일자
END_DT	String		조회 종료 일자
PAGE	String		페이지 번호
LIMIT	String		페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 839

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "130",
		"TRSC_BIZ_DV_CD" : "41",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140838",
		"TRC_NO" : "20211015140838",
		"CHNL_TYP_CD" : "1",
		"RESULTS" : [ {
			"TRSC_HR" : "130313",
			"RMK" : null,
			"RNUM" : 1,
			"APV_DT" : null,
			"APV_NO" : null,
			"STOR_NM" : null,
			"TRSC_DV_CD" : 41,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : null,
			"UNIQ_RCGN_NO" : null,
			"PINT" : 1000,
			"TRSC_DT" : "20210923"
		} ],
		"UNFY_MMB_NO" : "34",
		"RMND_PINT" : "23502",
		"TOTAL_PAGE" : 1,
		"TOTAL_CNT" : 1,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	String		통합 회원 번호
TOTAL_PAGE	Number		전체 페이지 수
TOTAL_CNT	Number		전체 내역 수
RMND_PINT	String		잔여 포인트
RES_CD	String		응답 코드
RES_MSG	String		응답 메시지
RESULTS	Array		조회 결과

Response fields-resultdata-results

Path	Type	Optional	Description
RNUM	Number		순번
APV_DT	Null		통합 승인 일자
APV_NO	Null		통합 승인 번호
PINT_CAN_POSB_YN	String		취소 가능 여부
TRSC_RSN_CD	Null		거래 사유 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRSC_DV_CD	Number		거래 구분 코드
PINT	Number		포인트
STOR_NM	Null		사용처
RMK	Null		포인트 내용
UNIQ_RCGN_NO	Null		제휴사 고유 식별 번호

포인트 거래 상세 내역(소멸, 적립, 사용) 조회 - 관리자

HTTP request

POST /api/point/listMemberPointDetail HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA
Content-Length: 316
Host: {url}

{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140839",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140839",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}
							

Curl request

$ curl 'http://{url}/api/point/listMemberPointDetail' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA' \
		-d '{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140839",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140839",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
COOPCO_CD	String		제휴사 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRC_NO	String		추적 번호
CHNL_TYP_CD	String		채널 유형 코드
BRND_CD	String		브랜드 코드
STOR_NO	String		가맹점 코드
SRCH_DV	String		회원 인증 구분 코드
SRCH_DV_VLU	String		회원 인증 구분값
START_DT	String		조회 시작 일자
END_DT	String		조회 종료 일자
PAGE	String		페이지 번호
LIMIT	String		페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3859

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "130",
		"TRSC_BIZ_DV_CD" : "10",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140839",
		"TRC_NO" : "20211015140839",
		"CHNL_TYP_CD" : "1",
		"RESULTS" : [ {
			"STOR_NO" : "2000",
			"TOT_DC_AMT" : 1000,
			"APV_NO" : "9000000411",
			"STOR_NM" : "7000",
			"VALD_TRM" : null,
			"TRSC_RSN_CD" : "CD01",
			"TOT_SEL_AMT" : 5000,
			"TRSC_DT" : "20211015",
			"BRND_CD" : "2000",
			"MBRSH_DC_AMT" : 10,
			"TRSC_HR" : "140521",
			"RMK" : "제휴사 상품구매",
			"UNFY_MMB_NO" : 34,
			"RNUM" : 1,
			"APV_DT" : "20211015",
			"TRSC_BEF_RMND_PINT" : 22502,
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"MBRSH_PINT_SETL_YN" : "Y",
			"UNIQ_RCGN_NO" : "20211015140521",
			"VALD_TRM_DV_CD" : null,
			"PINT" : 1000
		}, {
			"STOR_NO" : "2000",
			"TOT_DC_AMT" : null,
			"APV_NO" : "9000000409",
			"STOR_NM" : "7000",
			"VALD_TRM" : null,
			"TRSC_RSN_CD" : "RR01",
			"TOT_SEL_AMT" : 5000,
			"TRSC_DT" : "20211015",
			"BRND_CD" : "2000",
			"MBRSH_DC_AMT" : null,
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"UNFY_MMB_NO" : 34,
			"RNUM" : 2,
			"APV_DT" : "20211015",
			"TRSC_BEF_RMND_PINT" : 23625,
			"TRSC_DV_CD" : 22,
			"PINT_CAN_POSB_YN" : "N",
			"MBRSH_PINT_SETL_YN" : null,
			"UNIQ_RCGN_NO" : "20211015140519",
			"VALD_TRM_DV_CD" : null,
			"PINT" : 123
		}, {
			"STOR_NO" : "2000",
			"TOT_DC_AMT" : 1000,
			"APV_NO" : "9000000410",
			"STOR_NM" : "7000",
			"VALD_TRM" : null,
			"TRSC_RSN_CD" : "CD01",
			"TOT_SEL_AMT" : 5000,
			"TRSC_DT" : "20211015",
			"BRND_CD" : "2000",
			"MBRSH_DC_AMT" : 10,
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"UNFY_MMB_NO" : 34,
			"RNUM" : 3,
			"APV_DT" : "20211015",
			"TRSC_BEF_RMND_PINT" : 23502,
			"TRSC_DV_CD" : 31,
			"PINT_CAN_POSB_YN" : "N",
			"MBRSH_PINT_SETL_YN" : "Y",
			"UNIQ_RCGN_NO" : "20211015140519",
			"VALD_TRM_DV_CD" : null,
			"PINT" : 1000
		}, {
			"STOR_NO" : "2000",
			"TOT_DC_AMT" : null,
			"APV_NO" : "9000000408",
			"STOR_NM" : "7000",
			"VALD_TRM" : 1,
			"TRSC_RSN_CD" : "RR01",
			"TOT_SEL_AMT" : 5000,
			"TRSC_DT" : "20211015",
			"BRND_CD" : "2000",
			"MBRSH_DC_AMT" : null,
			"TRSC_HR" : "140517",
			"RMK" : "제휴사 상품구매",
			"UNFY_MMB_NO" : 34,
			"RNUM" : 4,
			"APV_DT" : "20211015",
			"TRSC_BEF_RMND_PINT" : 23502,
			"TRSC_DV_CD" : 21,
			"PINT_CAN_POSB_YN" : "N",
			"MBRSH_PINT_SETL_YN" : "N",
			"UNIQ_RCGN_NO" : "20211015140517",
			"VALD_TRM_DV_CD" : "1",
			"PINT" : 123
		}, {
			"STOR_NO" : "2000",
			"TOT_DC_AMT" : 1000,
			"APV_NO" : "9000000407",
			"STOR_NM" : "7000",
			"VALD_TRM" : null,
			"TRSC_RSN_CD" : "CD01",
			"TOT_SEL_AMT" : 5000,
			"TRSC_DT" : "20211015",
			"BRND_CD" : "2000",
			"MBRSH_DC_AMT" : 10,
			"TRSC_HR" : "140459",
			"RMK" : "제휴사 상품구매",
			"UNFY_MMB_NO" : 34,
			"RNUM" : 5,
			"APV_DT" : "20211015",
			"TRSC_BEF_RMND_PINT" : 22502,
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"MBRSH_PINT_SETL_YN" : "Y",
			"UNIQ_RCGN_NO" : "20211015140459",
			"VALD_TRM_DV_CD" : null,
			"PINT" : 1000
		} ],
		"UNFY_MMB_NO" : "34",
		"RMND_PINT" : "23502",
		"TOTAL_PAGE" : 33,
		"TOTAL_CNT" : 161,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
UNFY_MMB_NO	String		통합 회원 번호
TOTAL_PAGE	Number		전체 페이지 수
TOTAL_CNT	Number		전체 내역 수
RMND_PINT	String		잔여 포인트
RES_CD	String		응답 코드
RES_MSG	String		응답 메시지
RESULTS	Array		조회 결과

Response fields-resultdata-results

Path	Type	Optional	Description
RNUM	Number		순번
APV_DT	String		통합 승인 일자
APV_NO	String		통합 승인 번호
PINT_CAN_POSB_YN	String		취소 가능 여부
TRSC_RSN_CD	String		거래 사유 코드
TRSC_DT	String		거래 일자
TRSC_HR	String		거래 시간
TRSC_DV_CD	Number		거래 구분 코드
PINT	Number		포인트
STOR_NM	String		사용처
RMK	String		포인트 내용
UNIQ_RCGN_NO	String		제휴사 고유 식별 번호
UNFY_MMB_NO	Number		통합 회원 번호
BRND_CD	String		브랜드 코드
STOR_NO	String		가맹점 코드
VALD_TRM_DV_CD	Null		유효 기간 구분
VALD_TRM	Null		유효 개월수/기간
TOT_SEL_AMT	Number		총 매출 금액
TOT_DC_AMT	Number		총 할인 금액
MBRSH_DC_AMT	Number		멤버십 할인 금액
MBRSH_PINT_SETL_YN	String		멤버십 포인트 결제 여부
TRSC_BEF_RMND_PINT	Number		거래 전 잔여 포인트

마이너스 포인트 내역 조회 - 관리자

HTTP request

POST /api/point/listMemberMinusPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o
Content-Length: 137
Host: {url}

{
	"UNFY_MMB_NO" : null,
	"MMB_ID" : null,
	"PAGE" : "1",
	"LIMIT" : "5",
	"END_DT" : "20210930",
	"START_DT" : "20210901"
}
							

Curl request

$ curl 'http://{url}/api/point/listMemberMinusPoint' -i -X POST \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o' \
-d '{
"UNFY_MMB_NO" : null,
"MMB_ID" : null,
"PAGE" : "1",
"LIMIT" : "5",
"END_DT" : "20210930",
"START_DT" : "20210901"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
UNFY_MMB_NO	String	true	통합 회원 번호
MMB_ID	String	true	회원 ID
START_DT	String		조회 시작 일자
END_DT	String		조회 종료 일자
PAGE	String		페이지 번호
LIMIT	String		페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 697

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"RESULTS" : [ {
			"STOR_NO" : "1000",
			"APV_NO" : "9000000100",
			"MINUS_PINT" : 800,
			"STOR_NM" : "POINT",
			"COOPCO_CD" : "7000",
			"BRND_NM" : "POINT",
			"COOPCO_NM" : "BE MEMBERSHIP",
			"BRND_CD" : "1000",
			"MAPG_PINT" : 900,
			"UNFY_MMB_NO" : 90,
			"RNUM" : 1,
			"APV_DT" : "20210913",
			"MMB_ID" : "sangkimyul1",
			"UNIQ_RCGN_NO" : "700020210913130320",
			"CONTENT" : "POINT 제휴사 상품구매 적립취소",
			"MMB_NM" : "김상열"
		} ],
		"TOTAL_PAGE" : 1,
		"TOTAL_CNT" : 1
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Object		처리 결과

Response fields-resultdata

Path	Type	Optional	Description
TOTAL_PAGE	Number		전체 페이지 수
TOTAL_CNT	Number		전체 내역 수
RESULTS	Array		조회 결과

Response fields-resultdata-results

Path	Type	Optional	Description
RNUM	Number		순번
MMB_ID	String		고객ID
MMB_NM	String		고객명
UNFY_MMB_NO	Number		통합회원번호
COOPCO_CD	String		제휴사 코드
COOPCO_NM	String		제휴사 명
BRND_CD	String		브랜드 코드
BRND_NM	String		브랜드 명
STOR_NO	String		매장 코드
STOR_NM	String		매장 명
CONTENT	String		거래사유
MAPG_PINT	Number		매핑 포인트
MINUS_PINT	Number		마이너스 포인트
APV_DT	String		원 승인일자
APV_NO	String		원 승인번호
UNIQ_RCGN_NO	String		제휴사 고유 식별 번호

정산내역 조회 - 운영사

HTTP request

POST /api/point/listCoopcoTstPintMmSumr HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNH0.nfk5Z3mDTc8cLh3gN_AyYUd2Dq07A7WsFJBA0Me6-jc
Content-Length: 58
Host: {url}

{
	"COOPCO_CD" : "7000",
	"CLOSE_YEARMM" : "202109"
}
							

Curl request

$ curl 'http://{url}/api/point/listCoopcoTstPintMmSumr' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNH0.nfk5Z3mDTc8cLh3gN_AyYUd2Dq07A7WsFJBA0Me6-jc' \
    -d '{
  "COOPCO_CD" : "7000",
  "CLOSE_YEARMM" : "202109"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
COOPCO_CD	String		운영사 코드
CLOSE_YEARMM	String		조회 년/월 'YYYYMM'

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3838

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"RESULTS" : [ {
			"GUBUN_2" : "일반",
			"SUM_33" : 37539,
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"SUM_13" : 30383,
			"SUM_28" : 37539,
			"GUBUN_1" : "적립"
		}, {
			"GUBUN_2" : "적립 계",
			"SUM_33" : 37539,
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"SUM_13" : 30383,
			"SUM_28" : 37539,
			"GUBUN_1" : "적립"
		}, {
			"GUBUN_2" : null,
			"SUM_33" : null,
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "적립취소"
		}, {
			"GUBUN_2" : null,
			"SUM_33" : 37539,
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"SUM_13" : 30383,
			"SUM_28" : 37539,
			"GUBUN_1" : "적립 계(적립취소 반영)"
		}, {
			"GUBUN_2" : "회원탈퇴소멸",
			"SUM_33" : null,
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : "유효기간경과소멸",
			"SUM_33" : 1000,
			"GUBUN_3" : null,
			"SUM_12" : 0,
			"GUBUN_4" : null,
			"SUM_13" : 1000,
			"SUM_28" : 1000,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : "소멸 계",
			"SUM_33" : 1000,
			"GUBUN_3" : null,
			"SUM_12" : 0,
			"GUBUN_4" : null,
			"SUM_13" : 1000,
			"SUM_28" : 1000,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : 2960,
			"GUBUN_3" : "POINT",
			"SUM_12" : 945,
			"GUBUN_4" : null,
			"SUM_13" : 2015,
			"SUM_28" : 2960,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : 6000,
			"GUBUN_3" : "COFFEE",
			"SUM_12" : 3000,
			"GUBUN_4" : null,
			"SUM_13" : 3000,
			"SUM_28" : 6000,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : 8960,
			"GUBUN_3" : "사용 계",
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"SUM_13" : 5015,
			"SUM_28" : 8960,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : "사용 계",
			"SUM_33" : 8960,
			"GUBUN_3" : null,
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"SUM_13" : 5015,
			"SUM_28" : 8960,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : null,
			"GUBUN_3" : "POINT",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : null,
			"GUBUN_3" : "COFFEE",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : null,
			"GUBUN_3" : "사용취소 계",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : "사용취소 계",
			"SUM_33" : null,
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : null,
			"SUM_33" : 8960,
			"GUBUN_3" : null,
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"SUM_13" : 5015,
			"SUM_28" : 8960,
			"GUBUN_1" : "사용 계(사용취소(전월)반영)"
		} ]
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Array		처리 결과

Response fields-resultdata-results

Path	Type	Optional	Description
GUBUN_1	String		1DEPTH
GUBUN_2	String		2DEPTH
GUBUN_3	Null		3DEPTH
GUBUN_4	Null		4DEPTH
SUM_12	Number		제휴사1 내역
SUM_13	Number		제휴사2 내역
SUM_28	Number		합계 내역
SUM_33	Number		정산 합계 내역

정산내역 조회 - 제휴사

HTTP request

POST /api/point/listOprcoTstPintMmSumr HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA
Content-Length: 81
Host: {url}

{
	"COOPCO_CD" : "7000",
	"CLOSE_YEARMM" : "202109",
	"BRND_CD" : "1000"
}
							

Curl request

$ curl 'http://{url}/api/point/listOprcoTstPintMmSumr' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA' \
    -d '{
  "COOPCO_CD" : "7000",
  "CLOSE_YEARMM" : "202109",
  "BRND_CD" : "1000"
}'
							

Request headers

Name	Description
Content-Type	application/json
x-auth-token	토큰

Request fields

Path	Type	Optional	Description
COOPCO_CD	String		운영사 코드
BRND_CD	String		제휴사 코드
CLOSE_YEARMM	String		조회 년/월 'YYYYMM'

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2611

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"RESULTS" : [ {
			"GUBUN_2" : "일반",
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"GUBUN_1" : "적립"
		}, {
			"GUBUN_2" : "적립 계",
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"GUBUN_1" : "적립"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "적립취소"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"GUBUN_1" : "적립 계(적립취소 반영)"
		}, {
			"GUBUN_2" : "회원탈퇴소멸",
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : "유효기간경과소멸",
			"GUBUN_3" : null,
			"SUM_12" : 0,
			"GUBUN_4" : null,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : "소멸 계",
			"GUBUN_3" : null,
			"SUM_12" : 0,
			"GUBUN_4" : null,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "POINT",
			"SUM_12" : 945,
			"GUBUN_4" : null,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "COFFEE",
			"SUM_12" : 3000,
			"GUBUN_4" : null,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "사용 계",
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : "사용 계",
			"GUBUN_3" : null,
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "POINT",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "COFFEE",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "사용취소 계",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : "사용취소 계",
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : null,
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"GUBUN_1" : "사용 계(사용취소(전월)반영)"
		} ]
	}
}
							

Response fields

Path	Type	Optional	Description
resultCode	String		처리 결과 코드
resultMessage	String		처리 결과 메시지
resultData	Array		처리 결과

Response fields-resultdata-results

Path	Type	Optional	Description
GUBUN_1	String		1DEPTH
GUBUN_2	String		2DEPTH
GUBUN_3	Null		3DEPTH
GUBUN_4	Null		4DEPTH
SUM_12	Number		제휴사1 내역