API에 필요한 내용 요청 받습니다.

[GentleDot]

api
https://www.notion.so/API-165d5beeb0c0812cabd6d577244a31e0?pvs=4

api end-point 세부 내용
https://www.notion.so/0864ab7482ae4919b0b4e0a5d6e216be?v=e5106eddcd544c7396f1ae54bc9b7679&pvs=4

[GentleDot]

질문에 대한 부분을 코멘트 드리면 24시간 이내로 답변 드릴 수 있도록 하겠습니다.

[hyoungqu23]

@GentleDot

/api/v1/payments

CREATE TABLE "payment_requests" (
  "order_id" varchar(255) PRIMARY KEY,
  "order_name" varchar(300),
  "order_status" varchar(20),
  "user_id" int,
  "merchant_id" ULID NOT NULL,
  "payment_key" VARCHAR(255) UNIQUE NOT NULL,
  "amount" DECIMAL(10,2) NOT NULL,
  "request_time" TIMESTAMP,
  "approval_time" TIMESTAMP,
  "created_at" TIMESTAMP DEFAULT (CURRENT_TIMESTAMP)
);

위 API /api/v1/payments Notion 문서와 디스코드에 공유해주신 pay200.sql을 확인했을 때 의문점이 있습니다.
/api/v1/payments API를 요청했을 때 payment_requests 테이블에 추가되는 것이 맞나요?

그렇다면 /api/v1/payments API가 요청되었을 때, payment_requests 테이블에 NOT NULL인 payment_key를 가지게 되니까, 이를 응답값으로 반환하고, 반환된 payment_key를 기반으로 QR Code를 설정하면 해당 QR Code에 대해 확인하고 검증할 수 있지 않을까요?

[GentleDot]

@hyoungqu23
cc: @H-Genie

1. 특정 고유 주문번호 (order_id)로 요청이 왔을 때 대상 요청을 저장해둘 예정입니다.

• 즉, order_id 단위로 관리
• 변동된 금액 결제는 새 주문으로 (새로운 고유 주문번호 생성) 넣어야 동작

2. 결제 요청 시 order_id, 상점측 고객 ID, 요청 금액은 not_null로 처리하고 변동되지 않도록 구상하고 있습니다.
3. 결제 승인에 필요한 데이터 설정 시에는 저장되어 있는 order_id, 주문서의 금액 을 사용할 예정입니다.

• request 값으로 사용하지 않고
• 최초 요청 시 요청금액과의 비교 처리 용도로만 사용

[hyoungqu23]

@GentleDot

그렇다면, order_id가 동일하고 amount(요청 금액)이 달라지면 payment_requests 테이블에 다른 데이터로 저장되는 것인가요?

제가 우려한 부분은 커머스, OTO 등에서 금액이 변동되어도 order_id를 변경하지 않을 수 있기 때문입니다.

그래서 리더님과 멘토님에게 받은 조언을 정리해서 저희가 생각하는 흐름은 다음과 같아요.(참고)

payment_request 테이블에 기본키가 order_id가 아니라 식별 가능하고 유니크한 id생성한다.

1. order_id, order_name 등 데이터를 서버에 요청한다.
2. 서버에서 payment_requests 테이블에 해당 데이터를 저장하고, 식별 가능하고 유니크한 id를 암호화해서 응답한다.
3. SDK는 응답받은 암호화된 식별 가능하고 유니크한 id로 QR 코드를 생성한다.
4. 모바일 앱은 QR 코드를 스캔하여 얻은 암호화된 식별 가능하고 유니크한 id를 통해 서버에 조회를 요청한다.
5. 서버는 클라이언트에서 전달한 암호화된 식별 가능하고 유니크한 id를 복호화하여 payment_requests 테이블에 저장된 데이터를 응답한다

이런식으로 하면 되지 않을까요?

[GentleDot]

@hyoungqu23

1. " 커머스, OTO 등에서 금액이 변동되어도 order_id를 변경하지 않을 수 있음 <-
   이 부분은 상점 측 developer가 결제 취소 -> 새로운 주문서를 생성해서 새로운 고유 주문번호 (order_id)를 넣는 플로우는 어려울까요?

• 결제 요청 시의 order_id / 유효한 결제수단으로 확인된 이후 설정되는 payment_key / 요청금액 ---> 3가지로 결제 승인에 들어갑니다.
• order_id로 요청한 정보가 수정 변경되면 새로운 order_id로 요청되어야 요청 시점과 인증 시점, 승인 시점에서 관리가 될 것 같습니다.

2. 식별 가능하고 유니크한 id <- 이 부분은 변경되지 않을 것 같은데
   요청 -> 인증 -> 승인 요걸 생성할 때 부가적인 id (sessonId 등)를 생성해서 관리해드릴 수 있을 것 같습니다.
   2번은 조금 더 논의해서 보완해볼께요

[hyoungqu23]

@GentleDot

2번에 대해서는 이해했습니다. 보완된 내용이 있으면 추가적으로 알려주세요!!

1번은 상점 측 개발자의 행동을 제약하는 부분이라 거의 불가능할 것으로 판단됩니다. 해당 플로우에 따르면 이미 데이터베이스에 생성된 order의 금액만 변경하면 되는데, 굳이 이전 order를 제거하고, 새로 생성하는 번거로운 과정이 필요하기 때문에요. 그러면 Pay200 결제 서비스를 사용할 필요가 없다고 느끼지 않을까요? 그래서 그냥 저희가 식별가능하고 유니크한 id인 payment_request_id를 말씀드린거에요!

[GentleDot]

포인트는 이해했습니다.
다만, sdk에서 식별가능하고 유니크한 id <- 요 부분은 조금 고민이 필요해보이네요.

https://docs.tosspayments.com/guides/v2/payment-widget/integration
https://docs.tosspayments.com/guides/v2/get-started/payment-flow#%EA%B2%B0%EC%A0%9C-%EC%9A%94%EC%B2%AD-%EC%A0%84%EC%97%90-%EA%B2%B0%EC%A0%9C%ED%95%A0-%EB%8D%B0%EC%9D%B4%ED%84%B0-%EC%A0%80%EC%9E%A5%ED%95%98%EA%B8%B0

결제 요청, 승인 전 검증에 대한 내용이라 도움이 되실까 싶어
토스쪽 문서 공유드려볼께요.

[GentleDot]

해당 문서 종료하겠습니다!