KORAIL_STORE

1.POST /api/claim
  1) change URL
    - '/api/claim' -> '/api/online_claim'
  2) change comment
    a) API comment: '온라인몰 클레임 신청'
    b) RequestParam field comment
      claim_reason_type : "클레임사유유형코드 (Code: CR)

2.스마트오더 주문 취소 (store order cancel)
  - POST /api/store_order_cancel (NEW)

[API] POST /api/online_order, POST /api/store_order

1.Spec

• Order sheet on #32 - 20230717

2.RequestBody
  1) payment_info object : REMOVE
  2) payment_amount / payment_method / va_due_date : MOVE to fields
  3) apply Integer into amount fields (refer to API spec)
    - currently, String was applied to all fields

3.Response
  1) order_no : set by created order_no

4.Process
  1) INSERT DB (st_order_payment) (Change)
    - order_no / payment_method / payment_amount
    - va_due_date : NOT required (if payment_method = 'PV02', value is set)
    - payment_status = 'PS01'
    - reg_date / reg_user_seq

[API] PG 결제 컨펌 (confirm PG payment)

1.URL / Spec

• URL: POST /api/pay_confirm
• Spec: Order sheet on #32 - 20230717

2.API definition

  1) document: https://docs.tosspayments.com/reference#%EA%B2%B0%EC%A0%9C-%EC%8A%B9%EC%9D%B8
  2) refer to attached java source (OrderController.payment())

  2) Header

• base64("{pg secretKey}:")  // append ":" text
• {pg secretKey} : "test_sk_zXLkKEypNArWmo50nX3lmeaxYG5R" (define as property)
• set 'Authorization: Basic {base64 encode value}'

  3) ReqeustBody

• paymentKey / orderId / amount

3.Logic
  1) if PG pay confirm API is success
    a) if payment_method = 'PV02', set payment_status = 'PS20'
       else, set payment_status = 'PS10'
    b) pg_error_code / pg_error_msg : don't set empty string (set NULL)

[message process]

1.common.error.idNotExist 
  - set variable by user id value (currently, it's set by "id") (apply into other sources)
2.order.error.notExist
  - set variable by order_no value 
3.order.error.notSameAmount
  - set 1st varible by order_no value 
  - set 2nd variable by st_order_payment.payment_amount value
  - set 3th variable by amount parameter value

0.Spec

• Order sheet on #32 - 20230726

1.[API] 주문정보 (GET /api/order)

  1) Response
    a) mall_phone : set by st_mall.mall_phone
    b) payment_method / payment_method_name / payment_status / payment_status_name : set by st_order_payment data

2.[API] 주문 리스트 (GET /api/order_list)

  1) Logic
    a) add condition on SELECT 
      - st_order_payment.payment_status NOT IN ('PS01','PS02')
  2) Response
    a) payment_method / payment_method_name / payment_status / payment_status_name : set by st_order_payment data

3.[API] 스마트오더 진행중인 주문 리스트 (store ongoing order list) (NEW)

  1) URL: GET /api/store_ongoing_order_list
  2) Logic
    a) add condition on SELECT 
      - st_order_payment.payment_status NOT IN ('PS01','PS02')
  3) Response
    a) payment_method / payment_method_name / payment_status / payment_status_name : set by st_order_payment data

4.{API] PG 결제 실패 주문 삭제  (delete order with PG fail) (NEW)

  1) URL: DELETE /api/pg_fail_order

 [API] 스마트오더 진행중인 주문 리스트 (store ongoing order list) - Test Isuse

1.Parameter
    - REMOVE mall_type bcz only store order list is displayed

2.Response
  - REMOVE products.product_review_yn (it's not response field)

[API] POST /api/online_order, POST /api/store_order (Change)

0.Spec : Order sheet on #32 - 20230727

1.RequestBody
  1) paramter (Add)
    - refund_bank_code / refund_account_number / refund_holder_name
2.Logic
  1) INSERT DB (st_order_payment)
    - set refund_bank_code / refund_account_number / refund_holder_name (Add columns)