010가상계좌 입금테스트 API
테스트베드 환경에서 가상계좌 입금을 시뮬레이션하는 API입니다. 실제 입금 없이 입금 노티(B1)를 수신할 수 있습니다.
주의 사항
테스트 환경 전용
이 API는 테스트베드 환경에서만 사용 가능합니다. 운영 환경에서는 호출할 수 없습니다.
API 정보
GET/spay/APIVBankTest.do
Content-Type
application/json테스트
https://tbgw.settlebank.co.kr/spay/APIVBankTest.do요청 파라미터
URL Query String 방식으로 파라미터를 전달합니다.
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└mchtIdAN(10)영문+숫자, 최대 10byte*상점아이디
상점아이디
└methodAN(2)영문+숫자, 최대 2byte*결제수단
결제수단
VA: 가상계좌└bizTypeN(2)숫자, 최대 2byte*업무구분
업무구분
F1: 입금테스트└vAcntNoN(11)숫자, 최대 11byte*가상계좌번호 (010 형식). 채번(A4) API로 발급받은 번호를 입력합니다.
가상계좌번호 (010 형식). 채번(A4) API로 발급받은 번호를 입력합니다.
└trdAmtN(9)숫자, 최대 9byte*입금 테스트 금액
입금 테스트 금액
요청 예시
브라우저 주소창에서 직접 호출하거나 HTTP GET 요청으로 호출합니다.
https://tbgw.settlebank.co.kr/spay/APIVBankTest.do?mchtId=nxva_sb_il&method=VA&bizType=F1&vAcntNo=01012345678&trdAmt=1000
cURL 예시
curl -X GET "https://tbgw.settlebank.co.kr/spay/APIVBankTest.do?mchtId=nxva_sb_il&method=VA&bizType=F1&vAcntNo=01012345678&trdAmt=1000"
응답
GET 요청 결과는 Plain Text로 반환됩니다.
| 응답 | 설명 |
|---|---|
OK | 입금 테스트 성공. notiUrl로 입금통보(B1) 노티가 전송됩니다. |
| 에러 메시지 | 실패 시 에러 메시지가 반환됩니다. |
테스트 흐름
- 010 가상계좌 채번(A4) API를 호출하여 가상계좌번호를 발급받습니다.
- 발급받은 가상계좌번호로 입금테스트(F1) API를 호출합니다.
- 채번 시 등록한
notiUrl로 입금통보(B1) 노티가 전송됩니다. - 노티를 수신하여 정상 처리되는지 확인합니다.
주의 사항
NOTE
노티 수신 확인
입금테스트 호출 후 notiUrl로 입금통보(B1) 노티가 정상적으로 수신되는지 확인하세요.
- 테스트베드 환경에서만 동작합니다.
- 실제 은행 입금 없이 입금 노티를 발생시킵니다.
- 채번된 가상계좌번호로만 테스트가 가능합니다.
- 테스트 금액은 채번 시 설정한 금액과 일치하지 않아도 됩니다.
