헥토파이낸셜 개발자센터

가상계좌 입금테스트 API

테스트베드 환경에서 가상계좌 입금을 시뮬레이션하는 API입니다. 실제 입금 없이 입금 노티(B1)를 수신할 수 있습니다.

API 정보

GET/spay/APIVBankTest.do
Content-Typeapplication/json
테스트https://tbgw.settlebank.co.kr/spay/APIVBankTest.do

테스트 환경 전용

이 API는 테스트베드 환경에서만 사용 가능합니다. 운영 환경에서는 호출할 수 없습니다.

요청 파라미터

URL Query String 방식으로 파라미터를 전달합니다.

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└mchtIdAN(10)영문+숫자, 최대 10byte*
상점아이디
└methodAN(2)영문+숫자, 최대 2byte*
결제수단
VA: 가상계좌
└bizTypeAN(2)영문+숫자, 최대 2byte*
업무구분
F1: 입금테스트
└vAcntNoN(11)숫자, 최대 11byte*
가상계좌 결제창에서 채번하거나 API로 발급한 가상계좌 번호
└trdAmtN(12)숫자, 최대 12byte*
입금 테스트 금액

요청 예시

브라우저 주소창에서 직접 호출하거나 HTTP GET 요청으로 호출합니다.

https://tbgw.settlebank.co.kr/spay/APIVBankTest.do?mchtId=nx_mid_il&method=VA&bizType=F1&vAcntNo=12345678901234&trdAmt=1000

cURL 예시

curl -X GET "https://tbgw.settlebank.co.kr/spay/APIVBankTest.do?mchtId=nx_mid_il&method=VA&bizType=F1&vAcntNo=12345678901234&trdAmt=1000"

테스트 흐름

  1. 가상계좌 채번(B0) API를 호출하여 가상계좌번호를 발급받습니다.
  2. 발급받은 가상계좌번호로 입금테스트(F1) API를 호출합니다.
  3. 채번 시 등록한 notiUrl로 입금통보(B1) 노티가 전송됩니다.
  4. 노티를 수신하여 정상 처리되는지 확인합니다.

주의 사항

NOTE

노티 수신 확인

입금테스트 호출 후 notiUrl로 입금통보(B1) 노티가 정상적으로 수신되는지 확인하세요.
  • 테스트베드 환경에서만 동작합니다.
  • 실제 은행 입금 없이 입금 노티를 발생시킵니다.
  • 채번된 가상계좌번호로만 테스트가 가능합니다.
  • 테스트 금액은 채번 시 설정한 금액과 일치하지 않아도 됩니다.

응답 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└methodAN(2)영문+숫자, 최대 2byte*VA
결제수단
└bizTypeAN(2)영문+숫자, 최대 2byte*F1
업무구분
└outRsltCdAN(4)영문+숫자, 최대 4byte*0000
결과코드
0000: 정상처리
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*정상적으로 처리되었습니다.
결과메시지
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?