수동 정산 요청 API

승인된 카드 결제 건 중에서 특정 결제만 매입해서 정산받으려면 수동 정산 요청 API를 사용하세요.

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

수동 매입이 필요한 경우

매입 방식에는 자동 매입과 수동 매입이 있습니다. 자동 매입의 경우 결제승인이 난 건을 다음 날 카드사로 자동으로 보내는 방식으로 매입한 뒤 대금을 정산 받습니다. 이 경우 따로 API 호출이 필요하지 않습니다.

수동 매입은 매입해서 정산받을 결제 건을 가맹점에서 직접 특정하고 싶은 경우에 사용합니다. 이 경우 수동 정산 요청 API를 직접 호출합니다. 가맹점에서 PG 가입을 할 때 수동 매입으로 설정한 뒤 사용할 수 있습니다.

예를 들어 시험 접수를 하는 가맹점이라면 시험 접수 기간에 이루어진 결제와 접수 취소 기간에 이루어진 결제취소를 취합해 남은 거래만 정산하고자 할 것입니다. 즉 최종적으로 확정된 거래에 대해서만 정산하고 싶을 때 수동 정산 요청 API를 사용합니다.

수동 정산 요청 API 호출하기

수동 정산 요청 API는 정산조회 API의 엔드포인트 주소인 /v1/settlements를 사용하고, 요청 본문에는 정산을 원하는 결제 건을 특정하도록 paymentKey 를 포함합니다.

요청
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.tosspayments.com/v1/settlements"))
    .header("Authorization", "Basic dGVzdF9ha19aT1J6ZE1hcU4zd1FkNWs2eWdyNUFrWVhRR3d5Og==")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"paymentKey\":\"5zJ4xY7m0kODnyRpQWGrN2xqGlNvLrKwv1M9ENjbeoPaZdL6\"}"))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

요청에 성공하면 HTTP 200 OK와 함께 빈 본문이 돌아옵니다.


수동 정산 요청 API를 자세히 알아보세요

수동 정산 요청 API를 직접 실행해보세요

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