Bootpay Flutter 공식 예제

지원 플랫폼

의존성

dependencies:
 bootpay: ^5.0.22 # PG 결제
 bootpay_bio: ^5.0.14 # 생체인증 결제
 get: ^4.6.5 # 라우팅

테스트 메뉴

기본 사용법

1. Application ID 설정

String webApplicationId = '발급받은_WEB_APPLICATION_ID';
String androidApplicationId = '발급받은_ANDROID_APPLICATION_ID';
String iosApplicationId = '발급받은_IOS_APPLICATION_ID';

2. PG 일반 결제 (requestPayment)

import 'package:bootpay/bootpay.dart';
import 'package:bootpay/model/extra.dart';
import 'package:bootpay/model/item.dart';
import 'package:bootpay/model/payload.dart';
import 'package:bootpay/model/user.dart';
void bootpayTest(BuildContext context) {
 Payload payload = Payload();
 // Application ID 설정
 payload.webApplicationId = webApplicationId;
 payload.androidApplicationId = androidApplicationId;
 payload.iosApplicationId = iosApplicationId;
 // 결제 정보
 payload.pg = '스마트로'; // PG사 선택
 payload.orderName = "테스트 상품";
 payload.price = 1000.0;
 payload.orderId = DateTime.now().millisecondsSinceEpoch.toString();
 // 상품 정보
 Item item = Item();
 item.name = "상품명";
 item.qty = 1;
 item.id = "ITEM_CODE";
 item.price = 1000;
 payload.items = [item];
 // 구매자 정보
 User user = User();
 user.username = "사용자 이름";
 user.email = "user@example.com";
 user.phone = "010-1234-5678";
 user.addr = "서울시 강남구";
 payload.user = user;
 // 결제 옵션
 Extra extra = Extra();
 extra.appScheme = 'bootpayFlutterExample'; // iOS 앱스킴
 extra.cardQuota = '3'; // 할부 개월수
 payload.extra = extra;
 // 결제 요청
 Bootpay().requestPayment(
 context: context,
 payload: payload,
 showCloseButton: false,
 onCancel: (String data) {
 print('------- onCancel: $data');
 },
 onError: (String data) {
 print('------- onError: $data');
 },
 onClose: () {
 print('------- onClose');
 Bootpay().dismiss(context);
 },
 onIssued: (String data) {
 print('------- onIssued: $data');
 },
 onConfirm: (String data) {
 // 클라이언트 승인
 Bootpay().transactionConfirm();
 return false;
 // 또는 바로 승인: return true;
 // 또는 서버 승인: return false; (서버에서 승인 API 호출)
 },
 onDone: (String data) {
 print('------- onDone: $data');
 },
 );
}

3. 본인인증 (requestAuthentication)

void bootpayAuthentication(BuildContext context) {
 Payload payload = Payload();
 payload.webApplicationId = webApplicationId;
 payload.androidApplicationId = androidApplicationId;
 payload.iosApplicationId = iosApplicationId;
 payload.pg = '다날';
 payload.method = '본인인증';
 payload.orderName = "본인인증";
 payload.authenticationId = DateTime.now().millisecondsSinceEpoch.toString();
 User user = User();
 user.username = "사용자 이름";
 user.phone = "010-1234-5678";
 payload.user = user;
 Extra extra = Extra();
 extra.appScheme = 'bootpayFlutterExample';
 // extra.carrier = "SKT,KT,LGT"; // 통신사 제한
 // extra.ageLimit = 20; // 최소 나이 제한
 payload.extra = extra;
 Bootpay().requestAuthentication(
 context: context,
 payload: payload,
 showCloseButton: false,
 onCancel: (String data) { print('onCancel: $data'); },
 onError: (String data) { print('onError: $data'); },
 onClose: () { Bootpay().dismiss(context); },
 onDone: (String data) { print('onDone: $data'); },
 );
}

4. 정기결제 빌링키 발급 (requestSubscription)

void bootpaySubscription(BuildContext context) {
 Payload payload = Payload();
 payload.webApplicationId = webApplicationId;
 payload.androidApplicationId = androidApplicationId;
 payload.iosApplicationId = iosApplicationId;
 payload.pg = '토스페이먼츠';
 payload.method = '카드자동';
 payload.orderName = "정기결제 등록";
 payload.price = 1000.0; // 0원이면 빌링키만 발급
 payload.subscriptionId = DateTime.now().millisecondsSinceEpoch.toString();
 User user = User();
 user.username = "사용자 이름";
 user.email = "user@example.com";
 user.phone = "010-1234-5678";
 payload.user = user;
 Extra extra = Extra();
 extra.appScheme = 'bootpayFlutterExample';
 extra.subscribeTestPayment = payload.price != 0; // 테스트 결제 여부
 payload.extra = extra;
 Bootpay().requestSubscription(
 context: context,
 payload: payload,
 showCloseButton: false,
 onCancel: (String data) { print('onCancel: $data'); },
 onError: (String data) { print('onError: $data'); },
 onClose: () { Bootpay().dismiss(context); },
 onDone: (String data) { print('onDone: $data'); },
 );
}

콜백 함수 설명

iOS 설정

Info.plist - 앱스킴 등록

<key>CFBundleURLTypes</key>
<array>
 <dict>
 <key>CFBundleURLSchemes</key>
 <array>
 <string>bootpayFlutterExample</string>
 </array>
 </dict>
</array>

Info.plist - 외부 앱 실행 허용

<key>LSApplicationQueriesSchemes</key>
<array>
 <string>itms-apps</string>
 <string>kakao</string>
 <string>kakaokompassauth</string>
 <string>kakaolink</string>
 <!-- 기타 필요한 앱스킴 -->
</array>

Android 설정

AndroidManifest.xml - 인터넷 권한

<uses-permission android:name="android.permission.INTERNET"/>

AndroidManifest.xml - 앱스킴 등록

<activity ...>
 <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="bootpayFlutterExample"/>
 </intent-filter>
</activity>

웹 설정 (Web)

if (kIsWeb) {
 payload.extra?.openType = "popup"; // 또는 "iframe"
}

실행 방법

# 의존성 설치
flutter pub get
# Android
flutter run -d <android_device_id>
# iOS
cd ios && pod install && cd ..
flutter run -d <ios_device_id>
# Web
flutter run -d chrome

문서 및 지원

License