요기요 자동 주문 구현 정리

입력: session.json 또는 .env 의 refresh_token. Bearer 헤더에 (만료된) access_token 또는 refresh_token 사용 — 형식만 검증.

응답: 새 access_token (RS256, 2시간) + 새 refresh_token (HS512, 60일) → cache + session.json 저장

응답 키: customer_id, user_id, email, phone, nickname, socials, agreement

핵심 발견 (캡처 분석): 이 endpoint 응답에 location_token 과 adiyo_address 의 source 가 모두 포함.

응답 키: address_id, point{lat,lng}, law{sido,sigugun,dongmyun,...}, road, admin, detail, location_token, selected_at

가장 최근 selected_at 의 주소가 활성 배송지. 이 주소의 point.lat/lng 가 cart/submit URL 의 lat/lng 와 정확히 일치해야 함 (frontend 의 라운드된 좌표 35.21 사용 시 거부).

응답: id, name, franchise (null 또는 {id, ...})

submit body 의 vendor 는 단순 {vendor_id, franchise_id} — franchise=None 이면 franchise_id: null 로 키 포함.

{
  "cards": [{
    "token":  "<wpayToken, base64+padding>",    // ygypay_info.token 으로 사용
    "code":   "06",                              // 카드사 코드 (payo_service=YGYPAY_06)
    "name":   "국민카드",
    "number": "4579-73**-****-7048"
  }],
  "registered": true
}

토큰은 카드 1회 등록 + 1회 결제 후 영구 사용 (NOTES.md: "3회 결제에 동일").

Body

{
  "lat": 35.2085501,
  "lng": 126.83933026,
  "yotimedeal_offer_id": null,
  "products": [{
    "vendor_product_id": "1668541520",
    "vendor_category_id": "19185660",
    "quantity": 3,
    "option_sections": []
  }],
  "subscription_type": null,
  "coupon": null,
  "referral": null
}

응답: customer_cart.uuid + customer_cart.signature + order_info.full_price.

핵심: 응답의 order_info.full_price 가 submit body 의 payment.total 과 정확히 일치해야 함. frontend 계산한 order.total_price 가 아닌 cart 응답값 사용 — yogiyo 가 엄격 검증 (payment_price_not_match 400).

Body 전체 (캡처 검증된 정확한 형식)

{
  "customer_id": 708686411,
  "customer": {
    "id": 708686411,
    "authyo-token": "<RS256 = access_token>",         // ⚠ 키 이름에 대시 (-)
    "location_token": "<HS256, lat/lng 인코딩>",         // Step 3 addresses 응답
    "lat": 35.2085501, "lng": 126.83933026,
    "address": { street_name, road_name, alias_type, alias_text, street_number, display_address_long },
    "address_detail": { sido, gugun, admin_dong, dong, bunji, road, building, ri },
    "adiyo_address": { detail, law{...ri:''}, admin{...ri:''}, road{...ri:''}, point, location_token },
    "isLogin": true,
    "email": "...", "phone": "...",
    "phone_uuid": "<= device_id>",
    "advertisement_id": "<uuid4>",
    "subscription_type": null,
    "limit_ad_tracking": false,
    "app_tracking_transparency": null
  },
  "delivery_info": {
    email, street_number, phone,
    "use_safety_number": true,
    "extra_comments": [],                                  // 리스트!
    "comment_to_vendor": "",
    "comment_to_rider": "문 앞에",
    "is_cutlery_requested": false,
    "is_contactless_delivery": true,
    "expected_takeout_time": ""
  },
  "payment": {
    "payo_service": "YGYPAY_06",                       // YGYPAY_{card_code}
    "checkout_method_type": "YGYPAY",
    "service": "ygypay",
    "user_benefits": { subscription, point },
    "total": 14100,                                // ⚠ cart_verify.order_info.full_price 와 일치
    "cash_receipt_info": null,
    "ygypay_info": { "token": "<Step 5 card_token>", installment_plan: 0 }
  },
  "agreements": { efinance_agreement: true, tos: true, ... },
  "serving_type": "vd",
  "cart_uuid": "<Step 6 uuid>-b24b",                  // snake_case (NOT uuid)
  "cart_signature": "<Step 6 signature>",            // snake_case
  "vendor": { "vendor_id": 1525424, "franchise_id": null },
  "configuration": { feature_configuration: { ...7개 boolean: true } },
  "referral": "",
  "build_type": ""
}

응답 — zero payment 성공 (purchase_id 포함)

{
  "purchase_id":  147296710660,
  "order_number": "F2605121430JXXX4B",
  "ygy_order_id": 1459590930
}

응답 — 일반 결제 (purchase_id 누락 → Step 9 진행)

{
  "payment_no":   "20260512162715093276",
  "order_number": "F2605121627JZE4B",
  "payment_url":  "https://payo.yogiyo.co.kr/v2/payments/{payment_no}/checkout"
}

submit 응답에 purchase_id 가 없을 때만 동작. YogiyoZeroPayClient.follow_pg_chain() 가 자동 처리:

payment_url (GET, payo /checkout)
  ↓ HTML 응답의 form A 자동 submit
wpay.inicis.com/ygypay/u/v2/payreqauth (POST)
  ↓ HTML 응답의 form B 자동 submit
wpay.inicis.com/ygypay/u/payreqauthAction (POST)
  ↓ HTTP redirect chain
orderyo.yogiyo.co.kr/callback/payment/result/
  ↓ HTML 응답에서 정규식 추출
{order_number, purchase_id, ygy_order_id}

매 step 에서 <form> 의 action / method / input 필드를 정규식으로 추출 → urlencoded POST. JS 실행 / device fingerprint 검증 없음.

submit 직후 yogiyo 내부 commit 지연으로 404 발생 가능. 백엔드가 자동으로 5번 재시도 (0.5초 → 2.5초 간격).

for attempt in range(5):
    try:
        client.cancel_order(submit['order_number'])
        break
    except YogiyoZeroPayError as e:
        if '404' in str(e):
            time.sleep(0.5 + attempt * 0.5)
            continue
        raise