개발 기술 · 더 알아보기 · 직접 체험형

앱에서 포인트를 쓰면, 잔액과 사용 내역은 서버에 어떻게 함께 저장될까요?

서버가 잔액·사용 내역·예약을 한 묶음으로 저장합니다. 실패하면 이번 변경을 취소하고, 앱은 저장된 결과를 다시 읽습니다.

회원·예약·잔액 확인잔액·사용 내역 함께 저장별도 조회로 결과 확인
앱의 300포인트 사용 요청을 서버가 확인해 잔액과 사용 내역을 함께 저장하고, 잔액 900포인트와 사용 내역 한 건을 확인하는 세 단계

작동으로 살펴보는 개발 과정

앱의 요청과 서버의 저장을 나란히 확인하세요

300P 사용을 요청한 뒤 잔액·사용 내역·예약 상태를 비교해 보세요. 잔액 부족과 저장 실패도 함께 확인할 수 있습니다.

사용 요청 → 회원·예약·잔액 확인 → 함께 저장 → 잔액·내역 재조회

시연만 크게 보기 ↗

앱에서 요청하고, 서버에 저장된 내용을 다시 읽습니다.

300P 사용, 잔액과 내역을 함께 저장합니다.

서버 연결 중
확인할 조건

1,200P 중 300P를 사용하는 흐름입니다.

01

회원 앱

사용 요청
9:41● ▰
모아 활동

포인트로 예약

내 포인트—P
체험 클래스나만의 도자기 만들기
예약 번호
R-031
사용 포인트
300P

서버 연결 후 시작할 수 있습니다.

사용 결과를 저장된 내용으로 확인합니다.

사용 요청
결과 조회
대기
02

서버 확인

조건과 저장
포인트 처리요청 대기
  1. 1
    회원·예약 확인

    현재 회원과 예약 가격을 확인합니다.

    대기
  2. 2
    서버 잔액 확인

    저장된 잔액으로 300P 사용이 가능한지 확인합니다.

    대기
  3. 3
    변경 내용을 함께 저장

    잔액·사용 내역·예약을 한 묶음으로 반영합니다.

    대기

일부만 저장된 상태로 완료하지 않습니다.

함께 저장
다시 읽기
03

저장된 내용

별도 재조회
회원 잔액M-001
—P

서버에서 잔액을 읽는 중입니다.

포인트 사용 내역0건

아직 사용 내역이 없습니다.

예약 R-031미확정
조회 전
300P로 예약하기를 눌러 보세요.

앱 요청 뒤 서버가 어떤 내용을 함께 저장하는지 확인합니다.

서버 요청·재조회 기록 보기 0회
    응답을 놓친 경우에도 기존 요청을 다시 확인할 수 있습니다.

    잔액·사용 목록·사용 상세는 사용 요청 응답과 따로 읽습니다.

    앱과 서버를 연결하는 구현 과정

    300P 사용이 잔액과 내역에 함께 남기까지

    서버는 요청한 회원과 예약에 필요한 포인트, 현재 잔액을 다시 확인한 뒤 잔액 차감·사용 내역·예약 연결을 한 묶음으로 저장합니다. 중간에 하나라도 실패하면 이번 변경을 모두 취소해야 잔액만 줄거나 사용 내역만 남는 문제를 막을 수 있습니다.

    이 글에서는 앱의 포인트 사용 요청이 서버의 확인과 저장을 거쳐 화면에 돌아오는 과정을 직접 살펴봅니다. 정상 처리·잔액 부족·저장 실패를 비교하고, 저장 결과를 다시 조회해 개발 결과를 확인하는 기준까지 알 수 있습니다.

    구현 과정 01

    앱은 어떤 예약에 포인트를 쓸지 요청합니다

    ‘모아 활동’ 시연의 회원은 이전 잔액 1,100P에 출석 A-018의 적립 내역 P-018로 100P를 더해 1,200P를 보유하고 있습니다. 여기서 체험 예약 R-031에 300P를 사용해 보겠습니다.

    앱은 예약 번호와 요청 번호를 붙여 서버로 보냅니다. 서버는 요청과 함께 전달된 회원 연결 정보로 현재 회원을 구분합니다. 화면의 잔액 숫자를 바꾸기 전에 서버에서 처리 결과를 받아야 합니다. 요청이 오가는 동안에는 처리 중인 상태를 보여 주어 회원이 기다리고 있다는 사실을 알 수 있게 합니다.

    시연에서는 앱 화면과 서버의 처리 단계를 함께 볼 수 있습니다. 어떤 요청이 전달됐는지, 서버가 어디까지 확인했는지, 저장 결과가 언제 돌아왔는지를 같은 흐름에서 확인해 보세요.

    앱에서 연결하는 일

    예약 번호와 요청 번호를 보내고, 처리 중에는 잔액을 먼저 바꾸지 않습니다.

    서버에서 구현하는 일

    현재 시연 회원의 요청으로 연결해 받고, 예약에 필요한 포인트는 서버의 정보로 확인합니다.

    요청 값과 구현 기준 자세히 보기
    // 앱이 보내는 요청 값의 구성
    const request = {
      scenario: "normal",
      reservationId: "R-031",
      requestId: crypto.randomUUID()
    };
    // POST /api/demos/point-use/use
    // 사용 포인트나 화면의 잔액을 요청 값으로 보내지 않습니다.
    앱이 예약 R-031과 요청 번호를 전송하면 서버가 회원·예약·잔액과 300포인트 사용 조건을 확인해 잔액 900포인트와 사용 P-019를 함께 저장하고 다시 조회하는 흐름
    앱은 예약과 요청 번호를 보냅니다. 서버는 사용 포인트를 확인해 잔액·사용 내역·예약을 함께 저장하고, 앱은 저장된 결과를 다시 읽습니다. 이미지를 눌러 크게 볼 수 있습니다.

    구현 과정 02

    서버는 회원·예약·잔액을 다시 확인합니다

    서버는 현재 회원을 확인하고, 해당 회원이 처리할 수 있는 예약인지 살펴봅니다. 로그인을 사용하는 앱에서는 로그인한 회원과 예약의 소유자를 맞춰 확인하는 단계입니다. 이어 예약 R-031에 필요한 포인트를 서버의 예약 정보에서 읽고, 회원의 현재 잔액도 저장된 기록에서 확인합니다.

    앱 화면에 300P가 표시돼 있어도 요청에 담긴 숫자만 믿고 차감하면 안 됩니다. 서버가 확인한 예약의 필요 포인트와 실제 잔액을 기준으로 사용 가능 여부를 판단해야 합니다. 이번 조건에서는 필요한 300P보다 잔액 1,200P가 많으므로 다음 저장 단계로 넘어갑니다.

    이 확인이 실패하면 사용 내역을 만들거나 예약을 확정하지 않습니다. 회원에게는 잔액 부족 등 처리할 수 없는 이유를 알려 주고 현재 상태를 다시 보여 줍니다.

    앱에서 연결하는 일

    선택한 예약을 요청하고, 서버가 돌려준 사용 가능 여부와 실패 이유를 표시합니다.

    서버에서 구현하는 일

    현재 회원에게 연결된 예약의 필요 포인트와 저장된 잔액을 읽어 사용 가능 여부를 판단합니다.

    요청 값과 구현 기준 자세히 보기
    -- 현재 회원·선택 조건·예약 번호를 조건으로 조회
    SELECT cost, status, ledger_id
    FROM demo_reservations
    WHERE session_id = ? AND scenario = ? AND id = ?;
    
    SELECT balance FROM demo_scenarios
    WHERE session_id = ? AND scenario = ?;
    -- 요청에 임의의 amount를 추가하면 거절합니다.

    구현 과정 03

    차감·사용 내역·예약 연결을 함께 확정합니다

    서버는 저장을 시작한 뒤 잔액을 1,200P에서 900P로 변경하고, 사용 내역 P-019에 300P 사용(-300P)과 예약 R-031의 연결을 기록합니다. 이어 이 포인트 사용으로 예약을 확정하는 변경도 같은 묶음에 넣습니다.

    세 변경이 모두 성공했을 때 한꺼번에 저장을 확정합니다. 회원은 잔액 900P, 사용 내역 P-019, 포인트로 확정된 예약 R-031을 함께 확인할 수 있어야 합니다.

    잔액을 수정한 다음 사용 내역을 남기다가 실패했다면 어떻게 될까요? 이번에 바꾸려던 잔액과 내역·예약 상태를 모두 되돌립니다. 잔액은 1,200P로 유지하고, 이번 사용 내역은 남기지 않으며 예약도 확정하지 않습니다. 저장 단계에서 잠시 바꾸던 값과 최종 확정된 기록을 구분하는 이유입니다.

    앱에서 연결하는 일

    저장 응답을 기다린 뒤 잔액·사용 내역·예약 상태를 별도로 다시 조회합니다.

    서버에서 구현하는 일

    잔액 차감·사용 내역·예약 연결과 요청 기록을 같은 트랜잭션에서 확정하거나 취소합니다.

    요청 값과 구현 기준 자세히 보기
    // 같은 트랜잭션 안에서 이어지는 처리 순서
    BEGIN IMMEDIATE
      잔액 1,200P → 900P
      사용 내역 P-019에 -300P와 예약 R-031 기록
      예약 R-031을 확정하고 P-019에 연결
      같은 요청 번호로 확인할 응답 기록
    COMMIT
    // 중간 저장에 실패하면 COMMIT 대신 ROLLBACK
    정상 저장의 잔액 900포인트·사용 1건·예약 확정과 저장 실패의 잔액 1200포인트·사용 0건·예약 미확정을 같은 행으로 비교한 이미지
    정상 저장은 잔액·사용 내역·예약을 함께 확정합니다. 저장 중 오류가 나면 변경을 모두 취소해 사용 전 상태를 유지합니다. 이미지를 눌러 크게 볼 수 있습니다.

    구현 과정 04

    정상·잔액 부족·저장 실패를 나눠 확인하세요

    시연의 세 조건은 각각의 시작 상태에서 따로 확인합니다. 잔액 부족은 200P로 시작하고, 저장 실패는 1,200P에서 잔액을 수정한 뒤 사용 내역 기록에 오류를 일으켜 결과를 살펴봅니다.

    선택한 조건서버에서 일어난 일최종 잔액이번 사용 내역·예약
    정상 · 시작 1,200P300P 차감·사용 내역·예약 연결을 함께 확정900PP-019 한 건, R-031 확정
    잔액 부족 · 시작 200P필요한 300P보다 적어 저장 전에 중단200P사용 내역 0건, 예약 미확정
    저장 실패 · 시작 1,200P잔액 수정 후 사용 내역 기록에 실패해 이번 변경 취소1,200P사용 내역 0건, 예약 미확정

    실패 안내 문구가 나타났는지만 보지 말고 실제 기록도 확인해야 합니다. 특히 저장 실패에서는 차감을 시도했더라도 최종 잔액과 사용 내역이 시작 상태로 유지되는지 살펴보세요.

    앱에서 연결하는 일

    정상·잔액 부족·저장 실패를 구분하고, 안내와 별도로 읽은 최종 값을 함께 보여줍니다.

    서버에서 구현하는 일

    부족하면 변경 전에 중단하고, 중간 실패에서는 시도한 변경을 모두 취소합니다.

    요청 값과 구현 기준 자세히 보기
    사용 요청 응답 → 별도 조회로 확인한 결과
    
    HTTP 200 · POINT_USE_CONFIRMED
    → 900P / 사용 1건 / 예약 확정
    
    HTTP 409 · INSUFFICIENT_POINTS
    → 200P / 사용 0건 / 예약 미확정
    
    HTTP 503 · LEDGER_SAVE_FAILED
    → 1,200P / 사용 0건 / 예약 미확정

    구현 과정 05

    잔액·사용 목록·사용 내역 상세를 각각 다시 읽습니다

    서버의 처리 응답이 돌아오면 앱은 잔액 조회, 사용 내역 목록 조회, 사용 내역 상세 조회를 각각 별도로 요청합니다. 통신 기록에서는 이 세 번의 조회 요청을 GET으로 확인할 수 있습니다.

    • 잔액 조회: 정상 처리 후 900P가 저장돼 있는지 확인합니다. 이 조회에서 예약 R-031의 확정 상태도 함께 확인합니다.
    • 사용 내역 목록 조회: P-019의 300P 사용이 한 건만 있고 예약 R-031에 연결돼 있는지 확인합니다.
    • 사용 내역 상세 조회: P-019를 따로 열어 사용 포인트와 연결된 예약 R-031의 정보를 확인합니다.

    세 조회는 앞서 저장한 같은 결과를 서로 다른 관점에서 읽습니다. 처리 완료 응답을 받았다는 사실과, 저장된 기록을 다시 읽어 보여 주는 것은 확인 범위가 다릅니다. 시연에서도 저장 응답과 이후 조회 응답을 구분해 보세요.

    잔액 부족과 저장 실패에서도 같은 조회를 해 보면 잔액이 유지되고 이번 사용 내역과 예약 확정이 생기지 않았는지 확인할 수 있습니다.

    앱에서 연결하는 일

    잔액·사용 목록·사용 상세를 각각 읽어 같은 예약의 저장 결과인지 맞춰 보여줍니다.

    서버에서 구현하는 일

    현재 회원의 잔액·사용 목록·P-019 상세를 각각 조회하고, 사용 내역이 없으면 404로 응답합니다.

    요청 값과 구현 기준 자세히 보기
    GET /api/demos/point-use/state?scenario=normal
    GET /api/demos/point-use/ledger?scenario=normal
    GET /api/demos/point-use/ledger/P-019?scenario=normal
    
    // POST의 처리 완료 응답과 별도로 위 세 요청을 보냅니다.
    // 아직 저장된 P-019가 없으면 상세 조회는 HTTP 404입니다.

    구현 과정 06

    다시 요청해도 같은 예약에서 두 번 차감하지 않아야 합니다

    서버 처리는 끝났는데 앱이 응답을 받지 못하면 회원이 다시 시도할 수 있습니다. 이때 같은 요청 번호(requestId)를 보내 앞선 처리 결과를 확인합니다. 이미 성공한 요청이라면 서버는 이전 결과를 돌려주고 다시 차감하지 않아야 합니다.

    같은 예약에 새 요청 번호로 접근하는 경우도 확인해야 합니다. 요청 번호만 달라졌다고 다시 차감하지 않도록 예약 R-031의 포인트 사용 완료 여부를 함께 확인합니다. 정상 처리 후 다시 요청해도 잔액은 900P, 이번 사용 내역은 한 건으로 유지돼야 합니다.

    개발을 맡길 때는 정상 처리, 잔액 부족, 중간 저장 실패, 재요청 후의 결과를 검수 범위에 함께 적으세요. 각 조건에서 잔액·사용 목록·사용 내역 상세를 다시 열어 같은 결과가 유지되는지 확인하면, 포인트를 사용하는 기능이 어디까지 연결됐는지 판단할 수 있습니다.

    앱에서 연결하는 일

    앞서 보낸 요청 번호로 다시 확인하거나 같은 예약을 새 요청으로 보내고, 저장된 결과를 다시 읽습니다.

    서버에서 구현하는 일

    성공한 요청의 응답과 예약의 확정 여부를 확인해 같은 예약에서 추가 차감하지 않습니다.

    요청 값과 구현 기준 자세히 보기
    같은 requestId의 성공 응답이 이미 저장돼 있음
    → 앞선 응답을 다시 돌려주고 추가 차감하지 않음
    
    새 requestId여도 같은 회원의 R-031이 이미 확정됨
    → 기존 사용 내역 P-019와 확정 상태를 유지
    
    두 경우 모두 별도 조회로 확인
    → 900P / 사용 1건 / 예약 R-031 확정

    화면과 서버의 연결까지 개발 범위에 담아 보세요.

    회원 앱·데이터 저장·운영 화면을 실제 개발 사례로 확인할 수 있습니다.

    30분 무료 상담 신청
    앱이 만들어지는 방식으로 돌아가기