결제위젯

// Xcode -> File -> Add Package Dependencies
// Package URL: https://github.com/bootpay/ios_swift.git
// Dependency Rule: Up to Next Major
//
// 또는 Package.swift에 직접 추가:
dependencies: [
    .package(url: "https://github.com/bootpay/ios_swift.git", from: "5.1.1")
]swift

// app/build.gradle (Module: app)
dependencies {
    implementation 'io.github.bootpay:android:5.1.1'
}

flutter pub add bootpay
# pubspec.yaml의 dependencies에 bootpay: ^5.1.2가 추가된다bash

npm install react-native-bootpay-api
# iOS는 pod install까지 실행
cd ios && pod installbash

let payload = Payload()
// iOS는 Payload 객체에 widgetKey를 채워요.
payload.clientKey = "YOUR_CLIENT_KEY"
payload.price = 1000
payload.orderName = "테스트 상품"
payload.orderId = String(Int(Date().timeIntervalSince1970 * 1000))
payload.widgetKey = "default-widget"
payload.widgetSandbox = true
payload.widgetUseTerms = true

let widgetController = BootpayWidgetController()
widgetController.onResize = { height in
    // 위젯 높이 변경 이벤트. AutoLayout 높이 제약을 같이 갱신한다.
    widgetHeightConstraint.constant = height
}
widgetController.onChangePayment = { data in
    // 결제수단 변경 이벤트. 선택된 pg/method 정보를 payload에 병합한다.
    payload.mergeWidgetData(data)
}
widgetController.onChangeAgreeTerm = { data in
    // 약관 변경 이벤트. payload.widgetIsCompleted 판정에 필요한 상태를 병합한다.
    payload.mergeWidgetData(data)
}

let widgetView = BootpayWidgetView()
widgetView.controller = widgetController
widgetView.payload = payload
widgetView.startWidget()swift

Payload payload = new Payload();
// Android는 Payload setter로 widgetKey를 채워요.
payload.setClientKey("YOUR_CLIENT_KEY")
        .setOrderName("테스트 상품")
        .setOrderId("order_" + System.currentTimeMillis())
        .setPrice(1000d)
        .setWidgetKey("default-widget")
        .setWidgetSandbox(true)
        .setWidgetUseTerms(true);

BootpayWidget.bindViewUpdate(this, getSupportFragmentManager(), webViewContainer);
BootpayWidget.renderWidget(this, payload, new BootpayWidgetEventListener() {
    @Override
    public void onWidgetResize(double height) {
        // 위젯 높이 변경 이벤트. 컨테이너 높이를 같이 갱신한다.
    }

    @Override
    public void onWidgetReady() {
        // 위젯 준비 완료 이벤트.
    }

    @Override
    public void onWidgetChangePayment(WidgetData data) {
        // 결제수단 변경 이벤트. 선택된 pg/method 정보를 payload에 병합한다.
        payload.mergeWidgetData(data);
    }

    @Override
    public void onWidgetChangeAgreeTerm(WidgetData data) {
        // 약관 변경 이벤트. payload.getWidgetIsCompleted() 판정에 필요한 상태를 병합한다.
        payload.mergeWidgetData(data);
    }

    @Override
    public void needReloadWidget() {
        // 에러·취소 후 위젯 재렌더링이 필요할 때 호출된다.
    }
});java

// Flutter는 Payload 객체에 widgetKey를 채워요.
final payload = Payload()
    ..webApplicationId = BootpayEnvConfig.webApplicationId
    ..androidApplicationId = BootpayEnvConfig.androidApplicationId
    ..iosApplicationId = BootpayEnvConfig.iosApplicationId
    ..price = 1000
    ..orderName = '테스트 상품'
    ..orderId = DateTime.now().millisecondsSinceEpoch.toString()
    ..widgetKey = 'default-widget'
    ..widgetSandbox = true
    ..widgetUseTerms = true;

final controller = BootpayWidgetController()
  // 위젯 높이 변경 이벤트. SizedBox 등 위젯 컨테이너 높이를 같이 갱신한다.
  ..onWidgetResize = (height) => setState(() => widgetHeight = height)
  // 결제수단 변경 이벤트. 선택된 pg/method 정보를 payload에 병합한다.
  ..onWidgetChangePayment = (data) => setState(() => payload.mergeWidgetData(data))
  // 약관 변경 이벤트. payload.widgetIsCompleted 판정에 필요한 상태를 병합한다.
  ..onWidgetChangeAgreeTerm = (data) => setState(() => payload.mergeWidgetData(data));

return BootpayWidget(payload: payload, controller: controller);dart

const bootpayWidget = useRef(null)

const payload = {
    // React Native는 WidgetPayload에 widget_key를 채워요.
    widget_key: 'default-widget',
    widget_sandbox: true,
    widget_use_terms: true,
    order_name: '테스트 상품',
    order_id: `order_${Date.now()}`,
    price: 1000,
}

const onWidgetReady = () => {
    // RN은 위젯 준비 완료 후 renderWidget(payload)를 명시적으로 호출한다.
    bootpayWidget.current?.renderWidget(payload)
}
const onWidgetResize = (height) => {
    // 위젯 높이 변경 이벤트. placeholder 높이를 같이 갱신한다.
    setWidgetHeight(height)
}
const onWidgetChangePayment = (data) => {
    // 결제수단 변경 이벤트. data.completed 값으로 결제 가능 여부를 확인한다.
    setWidgetData(data)
}
const onWidgetChangeTerms = (data) => {
    // 약관 변경 이벤트. data.term_passed 값으로 필수 약관 통과 여부를 확인한다.
    setWidgetData(data)
}

<BootpayWidget
    ref={bootpayWidget}
    client_key={CLIENT_KEY}
    onWidgetReady={onWidgetReady}
    onWidgetResize={onWidgetResize}
    onWidgetChangePayment={onWidgetChangePayment}
    onWidgetChangeTerms={onWidgetChangeTerms}
/>javascript

{
  "event": "confirm",
  "receipt_id": "6244f60c1fc19202e42e8c4e",
  "order_id": "order_20260428_001",
  "price": 1000,
  "method": "card"
}json

{
  "event": "issued",
  "receipt_id": "6244f60c1fc19202e42e8c4e",
  "order_id": "order_20260428_001",
  "method": "vbank",
  "status": 5
}json

{
  "event": "error",
  "error_code": "RC_REQUEST_FAILED",
  "message": "결제 요청이 실패했다."
}json

guard payload.widgetIsCompleted else { return }
widgetController.onDone = { data in
    // 결제 완료 이벤트. receipt_id를 백엔드로 보내 결제 조회를 진행한다.
    self.verifyPayment(receiptId: data["receipt_id"] as? String ?? "")
}
widgetController.onIssued = { data in
    // 가상계좌 발급 이벤트. 입금 완료는 웹훅으로 최종 확정한다.
}
widgetController.onError = { data in
    // 결제 실패 이벤트. 실패 사유를 기록하고 위젯 재로드 여부를 결정한다.
}
widgetController.onCancel = { data in
    // 구매자 취소 이벤트. 주문은 미결제 상태로 유지한다.
}
widgetController.requestPayment(payload: payload)swift

if (!payload.getWidgetIsCompleted()) return;

BootpayWidget.requestPayment(
    this,
    getSupportFragmentManager(),
    payload,
    new BootpayEventListener() {
        @Override
        public void onDone(String data) {
            // 결제 완료 이벤트. receipt_id를 백엔드로 보내 결제 조회를 진행한다.
            verifyPayment(data);
        }

        @Override public void onIssued(String data) {
            // 가상계좌 발급 이벤트. 입금 완료는 웹훅으로 최종 확정한다.
        }
        @Override public void onCancel(String data) {
            // 구매자 취소 이벤트. 주문은 미결제 상태로 유지한다.
        }
        @Override public void onError(String data) {
            // 결제 실패 이벤트. 실패 사유를 기록하고 위젯 재로드 여부를 결정한다.
        }
        @Override public void onClose() {
            // 결제창 닫힘 이벤트. UI를 정리한다.
            BootpayWidget.removePaymentWindow();
        }
        @Override public boolean onConfirm(String data) {
            // 승인 전 확인 이벤트. 필요하면 서버 사전 검증 후 true를 반환한다.
            return true;
        }
    }
);java

// 위젯 컨트롤러로 위젯 결과를 그대로 결제 요청에 사용
controller.requestPaymentDirect(
  payload: payload,
  onDone: (data) {
    // 결제 완료 이벤트. receipt_id를 백엔드 결제 조회 API로 전송한다.
    verifyPayment(data);
  },
  // 결제 실패 이벤트. 실패 사유를 기록하고 위젯 재로드 여부를 결정한다.
  onError: (data) => debugPrint('error: $data'),
  // 구매자 취소 이벤트. 주문은 미결제 상태로 유지한다.
  onCancel: (data) => debugPrint('cancel: $data'),
  // 결제창 닫힘 이벤트. UI를 정리한다.
  onClose: () {},
  // 승인 전 확인 이벤트. 필요하면 서버 사전 검증 후 true를 반환한다.
  onConfirm: (data) => true,
  // 가상계좌 발급 이벤트. 입금 완료는 웹훅으로 최종 확정한다.
  onIssued: (data) => debugPrint('issued: $data'),
);dart

const isCompleted = widgetData?.term_passed && widgetData?.completed

function requestPayment() {
    if (!isCompleted) return
    bootpayWidget.current?.requestPayment()
}

function onConfirm(data) {
    // 승인 전 확인 이벤트. 필요하면 서버 사전 검증 후 승인한다.
    return true
}

function onDone(data) {
    // 결제 완료 이벤트. receipt_id를 백엔드로 보내 결제 조회를 진행한다.
    verifyPayment(data.receipt_id)
}

function onIssued(data) {
    // 가상계좌 발급 이벤트. 입금 완료는 웹훅으로 최종 확정한다.
    savePendingVbankOrder(data)
}

function onError(data) {
    // 결제 실패 이벤트. 실패 사유를 기록하고 위젯 재로드 여부를 결정한다.
    logPaymentError(data)
}

function onCancel(data) {
    // 구매자 취소 이벤트. 주문은 미결제 상태로 유지한다.
    keepOrderUnpaid(data)
}

<BootpayWidget
    ref={bootpayWidget}
    onConfirm={onConfirm}
    onDone={onDone}
    onIssued={onIssued}
    onError={onError}
    onCancel={onCancel}
    onClose={resetPaymentUi}
/>javascript

# Flask·Django 핸들러 안에서
receipt = bootpay.receipt_payment(receipt_id)
if receipt['status'] == 1 and receipt['price'] == 1000:
    # DB 저장
    pass
else:
    bootpay.cancel_payment(
        receipt_id=receipt_id,
        cancel_price=receipt['price'],
        cancel_message='검증 실패',
    )python

// Laravel·Slim 컨트롤러 안에서
$receipt = BootpayApi::receiptPayment($receipt_id);
if ($receipt['status'] === 1 && $receipt['price'] === 1000) {
    // DB 저장
} else {
    BootpayApi::cancelPayment([
        'receipt_id' => $receipt_id,
        'cancel_price' => $receipt['price'],
        'cancel_message' => '검증 실패',
    ]);
}php

// Spring 컨트롤러 안에서
var receipt = bootpay.getReceipt(receiptId);
if (((Number) receipt.get("status")).intValue() == 1 && ((Number) receipt.get("price")).intValue() == 1000) {
    // DB 저장
} else {
    Cancel cancel = new Cancel();
    cancel.receiptId = receiptId;
    cancel.cancelPrice = ((Number) receipt.get("price")).doubleValue();
    cancel.cancelUsername = "시스템";
    cancel.cancelMessage = "검증 실패";
    bootpay.receiptCancel(cancel);
}java

# Rails 컨트롤러 안에서
receipt = bootpay.verify(receipt_id).data
if receipt['status'] == 1 && receipt['price'] == 1000
  # DB 저장
else
  bootpay.cancel_payment(
    receipt_id: receipt_id,
    cancel_price: receipt['price'],
    cancel_message: '검증 실패',
  )
endruby

// net/http·Gin 핸들러 안에서
receipt, err := api.GetReceipt(receiptID)
if err != nil { return }

status := int(receipt["status"].(float64))
price := receipt["price"].(float64)

if status == 1 && price == 1000 {
    // DB 저장
} else {
    _, _ = api.ReceiptCancel(bootpay.CancelData{
        ReceiptId: receiptID, CancelPrice: price, CancelUsername: "시스템", CancelMessage: "검증 실패",
    })
}go

// ASP.NET Core 컨트롤러 안에서
var response = await bootpay.GetReceipt(receiptId);
var body = await response.Content.ReadAsStringAsync();
var receipt = JsonConvert.DeserializeObject<Dictionary<string, object>>(body);

var status = Convert.ToInt32(receipt["status"]);
var price = Convert.ToDouble(receipt["price"]);

if (status == 1 && price == 1000) {
    // DB 저장
} else {
    await bootpay.ReceiptCancel(new Cancel {
        receiptId = receiptId, cancelPrice = price, cancelUsername = "시스템", cancelMessage = "검증 실패",
    });
}csharp