등록창으로 카드 등록

{
  "return_url": "https://shop.example.com/membership",
  "item_name": "월 회비",
  "amount": 29900,
  "billing_day": 10,
  "cycle": "MONTHLY",
  "term_months": 12,
  "merchant_ref": "member-1024",
  "customer_name": "홍길동",
  "customer_phone": "01012345678"
}

{
  "id": 341,
  "status": "OPEN",
  "merchant_ref": "member-1024",
  "item_name": "월 회비",
  "amount": 29900,
  "cycle": "MONTHLY",
  "billing_day": 10,
  "term_months": 12,
  "return_url": "https://shop.example.com/membership",
  "customer_id": null,
  "subscription_id": null,
  "contract_no": null,
  "billing_mode": "RECURRING",
  "limit_once": null,
  "limit_month": null,
  "charge_consent_id": null,
  "charge_consent_no": null,
  "expires_at": "2026-10-28T14:30:00+09:00",
  "opened_at": null,
  "used_at": null,
  "created_at": "2026-10-28T14:00:00+09:00",
  "window_url": "https://…/window/Q2xv…bmU/",
  "window_url_reissued": false
}

// 가맹점 웹페이지(브라우저) — 버튼을 누른 그 자리에서 빈 팝업을 먼저 엽니다(팝업 차단 방지).
document.getElementById('register-card').addEventListener('click', async () => {
  const popup = window.open('about:blank', 'billingplus_register', 'width=480,height=760');

  // 가맹점 서버가 POST /register-windows 를 부르고 window_url 과 id 만 돌려주는 내 API
  const res = await fetch('/my-server/register-window', { method: 'POST' });
  if (!res.ok) { popup.close(); showError('잠시 후 다시 시도해 주세요.'); return; }   // showError: 내 화면의 오류 표시
  const { windowId, windowUrl } = await res.json();

  const expectedOrigin = new URL(windowUrl).origin;
  window.addEventListener('message', function onMessage(event) {
    if (event.origin !== expectedOrigin) return;                  // 다른 출처의 메시지는 무시
    if (!event.data || event.data.type !== 'billingplus:register') return;
    window.removeEventListener('message', onMessage);
    // 화면 전환용 신호입니다. 확정은 서버에서 다시 확인합니다(아래).
    location.href = `/my-page/card-registered?window=${windowId}`;
  });

  popup.location.href = windowUrl;
});

{
  "type": "billingplus:register",
  "ok": true,
  "data": {
    "billingMode": "RECURRING",
    "contractNo": "C-2026-0001",
    "customerCode": "M-0001",
    "merchantRef": "member-1024",
    "itemName": "월 회비",
    "amount": 29900,
    "billingDay": 10,
    "nextBillingDate": "2026-11-10"
  }
}

{
  "type": "billingplus:register",
  "ok": true,
  "data": {
    "billingMode": "ON_DEMAND",
    "chargeConsentId": 77,
    "chargeConsentNo": "Q26100001",
    "customerCode": "M-0001",
    "merchantRef": "member-1024",
    "itemName": "이용 요금",
    "limitOnce": 50000,
    "limitMonth": 200000
  }
}

{
  "return_url": "https://shop.example.com/membership",
  "item_name": "이용 요금",
  "billing_mode": "ON_DEMAND",
  "limit_once": 50000,
  "limit_month": 200000,
  "customer_id": 1024
}