위젯 플랫폼별 API

// 금액 변경
BootpayWidget.update({
    price: 2000,
    tax_free: 0,
    extra: {
        card_quota: '0,2,3'
    }
})

// 렌더링 없이 데이터만 업데이트
BootpayWidget.update({ price: 3000 }, false)javascript

const params = BootpayWidget.currentPaymentParameters()
// {
//   pg: 'danal',
//   method: 'card',
//   wallet_id: null,
//   terms: [...],
//   widget_key: 'default-widget',
//   widget_sandbox: true,
//   extra: { card_quota: '0,2,3' }
// }javascript

// 카드 결제 선택
BootpayWidget.selectPayment({ payment_type: 'card' })

// 특정 간편결제 선택
BootpayWidget.selectPayment({
    payment_type: 'easy',
    method_alias: 'kakaopay' // naverpay, payco, samsungpay 등
})javascript

const terms = BootpayWidget.currentTermsCondition()
// [
//   { pk: 'term1', title: '이용약관', agree: true },
//   { pk: 'term2', title: '개인정보 처리방침', agree: false }
// ]

const allAgreed = terms.every(term => term.agree)javascript

if (BootpayWidget.isRendered()) {
    BootpayWidget.requestPayment({
        order_id: 'order_' + Date.now(), // 테스트용. 실제로는 서버에서 생성한 주문번호 사용
        order_name: '테스트 결제'
    })
}

function navigateToOtherPage() {
    if (BootpayWidget.isRendered()) {
        BootpayWidget.destroy()
    }
}javascript

controller = BootpayWidgetController()
    .setCloseAction(WidgetCloseAction.NONE) // 직접 처리 (권장)kotlin

// 결제 완료 시 — 축소 후 결과 페이지로 이동
.setOnDone { data ->
    BootpayWidget.collapseAndFinish(this)
    runOnUiThread { finish() }
}

// 결제 에러/취소 시 — 축소 후 위젯 재로드 (재시도 가능)
.setOnError { data ->
    BootpayWidget.collapseAndReload(this)
}kotlin

override fun onBackPressed() {
    val webView = BootpayWidget.getView(this, supportFragmentManager)
    if (webView?.isExpanded == true) {
        BootpayWidget.collapseAndReload(this)
    } else {
        super.onBackPressed()
    }
}kotlin

payload.extra = BootExtra().apply {
    appScheme = "yourAppScheme"
    displaySuccessResult = true
    displayErrorResult = true
}kotlin

<activity
    android:name=".WidgetActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="yourAppScheme" />
    </intent-filter>
</activity>xml

// NavigationController 사용 시
widgetController.closeAction = .popViewController

// Modal 사용 시
widgetController.closeAction = .dismissViewController

// 직접 처리 (권장)
widgetController.closeAction = .none
widgetController.onClose = { [weak self] in
    self?.navigationController?.popToRootViewController(animated: true)
}swift

widgetHeightConstraint = widgetView.heightAnchor.constraint(equalToConstant: 516)
widgetHeightConstraint.isActive = true

widgetController.onResize = { [weak self] height in
    DispatchQueue.main.async {
        self?.widgetHeightConstraint.constant = height
        self?.view.layoutIfNeeded()
    }
}swift

// 기본값: 앱에서 직접 결과 화면 구현 (권장)
payload.extra = BootExtra()
payload.extra?.appScheme = "yourAppScheme"

// 빠른 연동: 웹뷰에서 결과 화면 표시
payload.extra?.displaySuccessResult = true
payload.extra?.displayErrorResult = trueswift

widgetController.onError = { [weak self] data in
    DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
        self?.widgetView.reloadWidget()
    }
}swift

class WidgetData {
    var pg: String?
    var method: String?
    var termPassed: Bool
    var completed: Bool
    var cardQuota: String?
    var methodSymbol: String?
    var easyPay: String?
}swift

_controller.reloadWidget();dart

// 기본값: 앱에서 직접 결과 화면 구현 (권장)
_payload.extra = Extra()..appScheme = 'yourAppScheme';

// 빠른 연동: 웹뷰에서 결과 화면 표시
_payload.extra = Extra()
    ..appScheme = 'yourAppScheme'
    ..displaySuccessResult = true
    ..displayErrorResult = true;dart

class WidgetData {
    String? pg;
    String? method;
    String? walletId;
    List<WidgetTerm>? selectTerms;
    String? currency;
    bool? termPassed;
    bool? completed;
    WidgetExtra? extra;
    String? methodSymbol;
    String? easyPay;
    String? cardQuota;
}dart

<activity android:name=".MainActivity" android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="yourAppScheme" />
    </intent-filter>
</activity>xml

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>yourAppScheme</string>
        </array>
    </dict>
</array>xml

const [widgetData, setWidgetData] = useState<WidgetData | null>(null);

const isCompleted =
    (widgetData?.term_passed ?? false) && (widgetData?.completed ?? false);

<TouchableOpacity
    onPress={goPayment}
    disabled={!isCompleted}
    style={[styles.payButton, !isCompleted && styles.disabled]}>
    <Text>결제하기</Text>
</TouchableOpacity>tsx

const updatePrice = (newPrice: number) => {
    const payload = getWidgetPayload();
    payload.price = newPrice;
    bootpayWidget.current?.updateWidget(payload);
};

// 전체 새로고침
bootpayWidget.current?.updateWidget(payload, true);

// 에러/취소 후 위젯 재로드
setTimeout(() => bootpayWidget.current?.reloadWidget(), 500);tsx

interface WidgetData {
    pg?: string;
    method?: string;
    wallet_id?: string;
    select_terms?: WidgetTerm[];
    currency?: string;
    term_passed?: boolean;
    completed?: boolean;
    extra?: WidgetExtra;
    method_symbol?: string;
    easy_pay?: string;
    card_quota?: string;
}typescript

<activity android:name=".MainActivity" android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="yourAppScheme" />
    </intent-filter>
</activity>xml

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>yourAppScheme</string>
        </array>
    </dict>
</array>xml