AI 비서 연결 안내

· 회원이 쓰는 AI 비서(클로드, ChatGPT, 뮤즈 등)가 회원 대신 애프터스윔에서 견적을 내고 주문하고 배송을 조회할 수 있어요. 결제는 회원이 미리 등록한 카드로 결제창 없이 이뤄집니다.

· 비서는 회원이 정한 한도 안에서만 주문할 수 있고, 한도를 넘으면 서버가 거부합니다. 회원은 언제든 연결을 끊을 수 있어요.

1. 마이페이지 › 결제수단에서 카드를 등록하고 AI 비서 주문 허용을 켜고, 1회·월 한도를 정합니다. (등록은 휴대폰 권장)

2. 마이페이지 › AI 비서 연결에서 연결 키를 발급합니다. 키는 발급 때 한 번만 보이니 비서에게 바로 전달하세요.

3. 비서에게 "애프터스윔 연결 키는 ask_live_… 이고, 사용법은 https://afterswim.kr/agent 를 읽어"라고 알려 주면 됩니다.

· 모든 요청에 Authorization: Bearer ask_live_… 헤더를 붙입니다. 스펙: /agent/openapi.json

· 상품과 가격은 /feeds/acp.json(SKU 포함)에서 읽고, POST /api/agent/quote로 재고·배송비를 확인한 뒤 POST /api/agent/orders로 주문합니다.

· 주문 전 GET /api/agent/me로 기본 배송지와 허용 결제수단·한도를 확인하세요. 주문 응답의 order.id로 GET /api/agent/orders/{id}에서 배송 상태를 봅니다.

· 재시도 시 같은 idempotency_key를 쓰면 중복 주문이 생기지 않아요. 키 1개당 하루 10건까지 주문할 수 있습니다.

· 주문하기 전에 회원에게 상품·수량·금액을 한 번 보여 주고 확인받는 것을 권장합니다. 한도 거부(403)는 회원 확인이 필요하다는 뜻이니 회원에게 그대로 전달하세요.

· 카드 정보는 비서에게 전달되지 않습니다. 비서는 주문 지시만 하고 결제는 애프터스윔 서버가 등록 카드로 처리합니다.

· 비서가 주문하면 결제 직전에 회원 휴대폰으로 품목·금액·카드와 1탭 취소 링크가 문자로 갑니다. 원치 않는 주문은 링크에서 바로 취소(출고 전 전액 승인취소)할 수 있어요.

· 모든 주문은 회원에게 주문 완료 문자·메일로 통지되며, 출고 전이면 마이페이지에서도 즉시 취소할 수 있어요. 회원 전용 상품·선착순 상품은 비서로 주문할 수 없습니다.

· 자세한 결제 규정은 자동결제 안내를 따릅니다.