수동 정산 요청 API

일정 기간 동안 쌓인 거래 기록을 모아 자동으로 정산하지 않고 API를 통해 직접 특정 건을 골라 정산을 요청하는 방식이 수동 정산입니다.

예를 들어 시험 접수를 대행하는 가맹점에서는 결제가 완료된 후 접수 취소가 발생할 수 있습니다. 이처럼 접수 건수와 실제 결제 완료 건수가 다른 경우, 수동 정산 요청 API를 사용하면 실제로 결제가 완료된 건만 정산할 수 있습니다.

토스페이먼츠 계약 시 매입 방식을 수동으로 설정한 경우에만 사용할 수 있으니 계약 조건을 확인한 뒤 사용하세요.

API를 사용하기 위해 필요한 키 정보와 인증 방식, 보안에 대한 정보는 API 사용하기에서 자세히 알아보세요.

수동 정산 요청 API 호출하기

수동 정산 요청 API는 정산하려는 결제 건을 특정하는 paymentKey를 요청 본문에 포함해야 합니다.

요청
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.tosspayments.com/v1/settlements"))
    .header("Authorization", "Basic dGVzdF9za196WExrS0V5cE5BcldtbzUwblgzbG1lYXhZRzVSOg==")
    .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와 함께 resulttrue인 응답이 돌아옵니다.


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

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

내용이 도움 되셨나요?
  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    디스코드 채팅|이메일 보내기