계좌 관리

1. RegistBankAccount - 계좌 등록

POST https://popbill-test.linkhub.co.kr/EasyFin/Bank/BankAccount/Regist

POST https://popbill.linkhub.co.kr/EasyFin/Bank/BankAccount/Regist

계좌조회 서비스를 이용할 계좌를 팝빌에 등록합니다.

계좌를 등록할 때 결제기간만큼 포인트가 차감됩니다. 단, 파트너 포인트를 이용하는 경우에는 1개월 요금이 과금됩니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Query 파라미터

순번	변수명	타입	길이	필수	설명
	UsePeriod	number	2	N	정액제 이용할 개월수 11개월 : 기본값 22개월 33개월 44개월 55개월 66개월 77개월 88개월 99개월 1010개월 1111개월 1212개월 파트너 포인트 사용시 입력값에 관계 없이 기본값 적용

요청 본문

변수명	타입	길이	필수	설명
BankCode	string	4	Y	은행 기관코드 [참고] 조회 가능한 금융기관
AccountNumber	string	30	Y	계좌번호
AccountPWD	string	4	Y	계좌 비밀번호
AccountType	string	2	Y	계좌 유형 법인 개인
IdentityNumber	string	20	Y	실명번호 ('-' 제외) - {AccountType}="법인" 경우 사업자번호 - {AccountType}="개인" 경우 생년월일 (형식 : yyMMdd)
AccountName	string	100	N	계좌 별칭
BankID	string	200	조건부	인터넷뱅킹 아이디 {BankCode}="0004"(국민은행) 경우 필수
FastID	string	50	조건부	조회전용 계정 아이디 {BankCode}="0031"(아이엠뱅크) or "0088"(신한은행) or "0048"(신협중앙회) 경우 필수
FastPWD	string	50	조건부	조회전용 계정 비밀번호 {BankCode}="0031"(아이엠뱅크) or "0088"(신한은행) or "0048"(신협중앙회) 경우 필수
Memo	string	200	N	메모

요청 예시

curl --request POST \
  --url 'https://{domain}/EasyFin/Bank/BankAccount/Regist?UsePeriod={UsePeriod}' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "BankCode": "기관코드",
    "AccountNumber": "계좌번호",
    "AccountPWD": "계좌 비밀번호",
    "AccountType": "법인",
    "IdentityNumber": "실명번호",
    "AccountName": "계좌 별칭",
    "BankID": "인터넷뱅킹 아이디",
    "FastID": "조회전용 계정 아이디",
    "FastPWD": "조회전용 계정 비밀번호",
    "Memo": "메모"
  }'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "등록 완료"
}

2. UpdateBankAccount - 계좌정보 수정

POST https://popbill-test.linkhub.co.kr/EasyFin/Bank/BankAccount/{BankCode}/{AccountNumber}/Update

POST https://popbill.linkhub.co.kr/EasyFin/Bank/BankAccount/{BankCode}/{AccountNumber}/Update

팝빌에 등록된 계좌정보를 수정합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Path 파라미터

순번	변수명	타입	길이	필수	설명
	BankCode	string	4	Y	은행 기관코드 [참고] 조회 가능한 금융기관
	AccountNumber	string	30	Y	계좌번호

요청 본문

변수명	타입	길이	필수	설명
AccountPWD	string	4	Y	계좌 비밀번호
AccountName	string	100	N	계좌 별칭
BankID	string	200	조건부	인터넷뱅킹 아이디 {BankCode}="0004"(국민은행) 경우 필수
FastID	string	50	조건부	조회전용 계정 아이디 {BankCode}="0031"(아이엠뱅크) or "0088"(신한은행) or "0048"(신협중앙회) 경우 필수
FastPWD	string	50	조건부	조회전용 계정 비밀번호 {BankCode}="0031"(아이엠뱅크) or "0088"(신한은행) or "0048"(신협중앙회) 경우 필수
Memo	string	200	N	메모

요청 예시

curl --request POST \
  --url 'https://{domain}/EasyFin/Bank/BankAccount/{BankCode}/{AccountNumber}/Update' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "AccountPWD": "계좌 비밀번호",
    "AccountName": "계좌 별칭",
    "BankID": "인터넷뱅킹 아이디",
    "FastID": "조회전용 계정 아이디",
    "FastPWD": "조회전용 계정 비밀번호",
    "Memo": "메모"
  }'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "수정 완료"
}

3. GetBankAccountInfo - 계좌정보 확인

GET https://popbill-test.linkhub.co.kr/EasyFin/Bank/BankAccount/{BankCode}/{AccountNumber}

GET https://popbill.linkhub.co.kr/EasyFin/Bank/BankAccount/{BankCode}/{AccountNumber}

팝빌에 등록된 계좌 정보를 확인합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Path 파라미터

순번	변수명	타입	길이	필수	설명
	BankCode	string	4	Y	은행 기관코드 [참고] 조회 가능한 금융기관
	AccountNumber	string	30	Y	계좌번호

요청 예시

curl --request GET \
  --url 'https://{domain}/EasyFin/Bank/BankAccount/{BankCode}/{AccountNumber}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
accountNumber	string	30	계좌번호
bankCode	string	4	은행 기관코드 [참고] 조회 가능한 금융기관
accountName	string	100	계좌 별칭
accountType	string	2	계좌 유형 법인 개인
state	number	1	계좌 상태 0준비중 1사용 2정지
regDT	string	14	팝빌에 계좌를 등록한 일시 형식 : yyyyMMddHHmmss
contractDT	string	14	정액제 서비스 시작일시 형식 : yyyyMMddHHmmss
useEndDate	string	8	정액제 서비스 만료일자 형식 : yyyyMMdd
baseDate	string	30	자동연장 결제일 5 15 25
contractState	number	1	정액제 서비스 상태 1사용 또는 사용제한 2해지
closeRequestYN	boolean	-	정액제 서비스 해지신청 여부 true신청 false미신청
useRestrictYN	boolean	-	정액제 서비스 사용제한 여부 true사용제한 false사용
closeOnExpired	boolean	-	정액제 서비스 해지 구분 true일반해지 (정액제 서비스 만료일 해지) false중도해지 (요청 즉시 해지)
unPaidYN	boolean	-	미수금 보유 여부 true보유 false미보유
memo	string	200	메모

응답 예시

{
    "bankCode": "기관코드",
    "accountName": "계좌 별칭",
    "accountType": "법인",
    "accountNumber": "계좌번호",
    "state": 1,
    "regDT": "20251021102519",
    "memo": "메모",
    "contractState": 0,
    "closeRequestYN": false,
    "useRestrictYN": false,
    "closeOnExpired": false,
    "unPaidYN": false
}

4. ListBankAccount - 계좌정보 목록 조회

GET https://popbill-test.linkhub.co.kr/EasyFin/Bank/ListBankAccount

GET https://popbill.linkhub.co.kr/EasyFin/Bank/ListBankAccount

팝빌에 등록된 계좌정보 목록을 반환합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

요청 예시

curl --request GET \
  --url 'https://{domain}/EasyFin/Bank/ListBankAccount' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
accountNumber	string	30	계좌번호
bankCode	string	4	은행 기관코드 [참고] 조회 가능한 금융기관
accountName	string	100	계좌 별칭
accountType	string	2	계좌 유형 법인 개인
state	number	1	계좌 상태 0준비중 1사용 2정지
regDT	string	14	팝빌에 계좌를 등록한 일시 형식 : yyyyMMddHHmmss
contractDT	string	14	정액제 서비스 시작일시 형식 : yyyyMMddHHmmss
useEndDate	string	8	정액제 서비스 만료일자 형식 : yyyyMMdd
baseDate	string	30	자동연장 결제일 5 15 25
contractState	number	1	정액제 서비스 상태 1사용 또는 사용제한 2해지
closeRequestYN	boolean	-	정액제 서비스 해지신청 여부 true신청 false미신청
useRestrictYN	boolean	-	정액제 서비스 사용제한 여부 true사용제한 false사용
closeOnExpired	boolean	-	정액제 서비스 해지 구분 true일반해지 (정액제 서비스 만료일 해지) false중도해지 (요청 즉시 해지)
unPaidYN	boolean	-	미수금 보유 여부 true보유 false미보유
memo	string	200	메모

응답 예시

[
  {
      "bankCode": "기관코드",
      "accountName": "계좌 별칭",
      "accountType": "법인",
      "accountNumber": "계좌번호",
      "state": 1,
      "regDT": "20251021102519",
      "memo": "메모",
      "contractState": 0,
      "closeRequestYN": false,
      "useRestrictYN": false,
      "closeOnExpired": false,
      "unPaidYN": false
  }
]

5. GetBankAccountMgtURL - 계좌 등록 팝업 URL

GET https://popbill-test.linkhub.co.kr/EasyFin/Bank

GET https://popbill.linkhub.co.kr/EasyFin/Bank

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Query 파라미터

순번	변수명	타입	길이	필수	설명
	TG	string	-	Y	고정값 : BankAccount

요청 예시

curl --request GET \
  --url 'https://{domain}/EasyFin/Bank?TG=BankAccount' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
	url	string	-	계좌 등록 팝업 URL

응답 예시

{
    "url": "https://test.popbill.com/App/Taxinvoice/025102114360700001.E?T=Q5LM53CQT...FQH0QUG"
}

6. CloseBankAccount - 정액제 해지요청

POST https://popbill-test.linkhub.co.kr/EasyFin/Bank/BankAccount/Close

POST https://popbill.linkhub.co.kr/EasyFin/Bank/BankAccount/Close

팝빌에 등록된 계좌의 정액제 해지를 요청합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Query 파라미터

변수명	타입	길이	필수	설명
BankCode	string	4	Y	은행 기관코드 [참고] 조회 가능한 금융기관
AccountNumber	string	30	Y	계좌번호
CloseType	string	2	Y	정액제 해지 구분 일반해지 요청일이 포함된 정액제 이용기간 만료 후 해지

요청 예시

curl --request POST \
  --url 'https://{domain}/EasyFin/Bank/BankAccount/Close?BankCode={BankCode}&AccountNumber={AccountNumber}&CloseType={CloseType}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "해지요청 완료"
}

7. RevokeCloseBankAccount - 정액제 해지요청 취소

POST https://popbill-test.linkhub.co.kr/EasyFin/Bank/BankAccount/RevokeClose

POST https://popbill.linkhub.co.kr/EasyFin/Bank/BankAccount/RevokeClose

신청한 정액제 해지요청을 취소합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Query 파라미터

순번	변수명	타입	길이	필수	설명
	BankCode	string	4	Y	은행 기관코드 [참고] 조회 가능한 금융기관
	AccountNumber	string	30	Y	계좌번호

요청 예시

curl --request POST \
  --url 'https://{domain}/EasyFin/Bank/BankAccount/RevokeClose?BankCode={BankCode}&AccountNumber={AccountNumber}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "해지요청 취소완료"
}

8. DeleteBankAccount - 계좌 삭제

POST https://popbill-test.linkhub.co.kr/EasyFin/Bank/BankAccount/Delete

POST https://popbill.linkhub.co.kr/EasyFin/Bank/BankAccount/Delete

등록된 계좌를 삭제합니다.

정액제가 아닌 종량제 이용 시에만 등록된 계좌를 삭제할 수 있습니다.
정액제 이용시 [CloseBankAccount – 정액제 해지요청] 함수를 사용하여 정액제를 해제할 수 있습니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Content-Type	Y	요청 본문 형식 application/json
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

요청 본문

순번	변수명	타입	길이	필수	설명
	BankCode	string	4	Y	은행 기관코드 [참고] 조회 가능한 금융기관
	AccountNumber	string	30	Y	계좌번호

요청 예시

curl --request POST \
  --url 'https://{domain}/EasyFin/Bank/BankAccount/Delete' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "BankCode": "기관코드",
    "AccountNumber": "계좌번호"
  }'

Response

응답 본문

순번	변수명	타입	길이	설명
	code	number	-	API 처리에 대한 응답코드 1성공
	message	string	-	API 처리에 대한 응답메시지

응답 예시

{
    "code": 1,
    "message": "삭제 완료"
}