가상계좌 발급 API

가맹점 서버에서 JSONObject로 요청 전문을 구성하고 HttpURLConnection으로 API를 호출합니다. 서비스 인증서는 클라이언트에 노출하지 말고 서버에서 직렬화하여 요청하세요.

// 가상계좌 발급 API URL
String target_URL = "https://stg-spl.kcp.co.kr/gw/hub/v1/payment";
// 운영: https://spl.kcp.co.kr/gw/hub/v1/payment

JSONObject json_req = new JSONObject();
json_req.put("site_cd", "T0000");
json_req.put("kcp_cert_info", kcp_cert_info);
json_req.put("pay_method", "VCNT");
json_req.put("amount", "1004");
json_req.put("currency", "410");
json_req.put("ordr_idxx", "TEST1234567890");
json_req.put("good_name", "테스트상품");
json_req.put("buyr_name", "홍길동");
json_req.put("buyr_tel2", "010-1234-1234");
json_req.put("buyr_mail", "test@your-shop.example.com");
json_req.put("va_txtype", "41100000");
json_req.put("va_mny", "1004");
json_req.put("va_bankcode", "BK26");
json_req.put("va_name", "홍길동");
json_req.put("va_date", "20261231235959");
json_req.put("va_receipt_gubn", "0");
json_req.put("va_taxno", "01012341234");

String req_data = json_req.toString();
StringBuffer outResult = new StringBuffer();

URL url = new URL(target_URL);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setDoOutput(true);
conn.setRequestMethod("POST");
conn.setRequestProperty("Content-Type", "application/json; charset=utf-8");
conn.setRequestProperty("Accept-Charset", "UTF-8");

try (OutputStream os = conn.getOutputStream()) {
  os.write(req_data.getBytes(StandardCharsets.UTF_8));
  os.flush();
}

try (BufferedReader in = new BufferedReader(
    new InputStreamReader(conn.getInputStream(), StandardCharsets.UTF_8))) {
  String inputLine;
  while ((inputLine = in.readLine()) != null) {
    outResult.append(inputLine);
  }
}
conn.disconnect();

String res_data = outResult.toString();
JSONObject json_res = (JSONObject) new JSONParser().parse(res_data);
String res_cd = (String) json_res.get("res_cd");

// 가상계좌 발급 정상 처리
if ("V000".equals(res_cd)) {
  String tno = (String) json_res.get("tno");
  String account = (String) json_res.get("account");
  String bankcode = (String) json_res.get("bankcode");
  String amount = (String) json_res.get("amount");
  // tno, account, bankcode, amount를 가맹점 서버에 저장
  // 결제 완료 처리는 추후 입금 통보 데이터 수신 후 진행
}