카드정보 결제 API

카드사 인증 없이 카드 정보만 입력해서 결제할 수 있습니다.

API 사용하기에서 API 사용에 필요한 인증 정보를 구성해두세요.

카드정보 결제란

카드 결제는 인증 여부에 따라 인증 결제, 비인증 결제로 나뉩니다. 카드 결제 과정에서 카드사가 제공하는 인증 과정(ISP, 안심클릭)이 있는 경우가 인증 결제입니다. 카드정보 결제는 인증 과정 없이 직접 카드정보를 입력해서 결제하는 방식으로 비인증 결제에 속합니다. '수기 결제', '키인(Key-in) 결제'라고 불리기도 합니다.

결제 요청하기

카드정보 결제 API 요청에는 주문 정보와 카드 정보가 요청 본문에 포함되어야 합니다.

필수적인 카드정보로 카드 번호와 카드 유효기간 정보가 필요합니다. 가맹점에서 PG 가입을 할 때 카드정보 결제에 옵션으로 추가설정한 항목이 있다면 비밀번호, 카드 소유자 생년월일 필드를 추가할 수 있습니다.

요청
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.tosspayments.com/v1/payments/key-in"))
    .header("Authorization", "Basic dGVzdF9ha19aT1J6ZE1hcU4zd1FkNWs2eWdyNUFrWVhRR3d5Og==")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"amount\":15000,\"orderId\":\"7ShRKsAoYpvf54_aPGUQZ\",\"orderName\":\"토스티셔츠 외 2건\",\"cardNumber\":\"4330123412341234\",\"cardExpirationYear\":\"24\",\"cardExpirationMonth\":\"07\",\"cardPassword\":\"12\",\"customerBirthday\":\"881212\"}"))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

정상적으로 요청이 승인되면 일반 카드결제의 응답과 동일한 형태로 응답이 돌아옵니다.


카드정보 결제 API를 자세히 알아보세요

카드정보 결제 API를 직접 실행해보세요

  • 더 궁금한 내용이 있나요?자주 묻는 질문
  • 코드 샘플을 참고하세요TossPayments GitHub
  • 기술지원이 필요한가요?디스코드 채팅|이메일 보내기