부트페이에서 생체결제, 비밀번호 간편결제 공식 Flutter 라이브러리 입니다. (클라이언트 용)
- PG 결제창 연동은 클라이언트 라이브러리에서 수행됩니다. (Javascript, Android, iOS, React Native, Flutter 등)
- 결제 검증 및 취소, 빌링키 발급, 본인인증 등의 수행은 서버사이드에서 진행됩니다. (Java, PHP, Python, Ruby, Node.js, Go, ASP.NET 등)
이 모듈은 android, ios를 지원합니다. android os 23, ios os 14 부터 사용 가능합니다.
이 모듈은 Bootpay V2 입니다.
- ios/android 지원
- 카드정기결제(REST) 를 지원하는 PG사에 한해서 지원
pubspec.yaml 파일에 아래 모듈을 추가해주세요
...
dependencies:
...
bootpay_bio: last_version
...MainActivity.java를 아래와 같이 변경합니다. (FlutterActivity 대신 FlutterFragmentActivity을 사용해야 합니다)
import android.os.Bundle;
import io.flutter.embedding.android.FlutterFragmentActivity;
import androidx.annotation.NonNull;
import io.flutter.embedding.engine.FlutterEngine;
import io.flutter.plugins.GeneratedPluginRegistrant;
public class MainActivity extends FlutterFragmentActivity {
public void configureFlutterEngine(@NonNull FlutterEngine flutterEngine)
{
GeneratedPluginRegistrant.registerWith(flutterEngine);
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
}
}또는
코틀린일 경우 아래와 같이 MainActivity.kt 파일을 수정합니다
import io.flutter.embedding.android.FlutterFragmentActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugins.GeneratedPluginRegistrant
class MainActivity: FlutterFragmentActivity() {
override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
GeneratedPluginRegistrant.registerWith(flutterEngine)
}
}AndroidManifest.xml 파일에 아래 2개의 권한을 추가해줍니다.
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.app">
<uses-permission android:name="android.permission.USE_BIOMETRIC"/>
<uses-permission android:name="android.permission.VIBRATE"/>
<manifest>** {your project root}/ios/Runner/Info.plist **
CFBundleURLName과 CFBundleURLSchemes의 값은 개발사에서 고유값으로 지정해주셔야 합니다. 외부앱(카드사앱)에서 다시 기존 앱으로 앱투앱 호출시 필요한 스키마 값입니다.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
...
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLName</key>
<string>kr.co.bootpaySample</string>
<key>CFBundleURLSchemes</key>
<array>
<string>bootpaySample</string>
</array>
</dict>
</array>
...
<key>NSFaceIDUsageDescription</key>
<string>생체인증 결제 진행시 권한이 필요합니다</string>
</dict>
</plist>
import 'package:bootpay_bio/bootpay_bio.dart';
import 'package:bootpay_bio/config/bio_config.dart';
import 'package:bootpay_bio/constants/bio_constants.dart';
import 'package:bootpay_bio/models/bio_payload.dart';
import 'package:bootpay_bio/models/bio_price.dart';
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:bootpay/model/stat_item.dart';
import 'package:bootpay/model/user.dart';
import 'package:bootpay/model/item.dart';
import 'package:bootpay/model/extra.dart';
import 'deprecated/api_provider.dart';
import 'package:bootpay/bootpay.dart';
import 'package:flutter/foundation.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatefulWidget {
@override
_MyAppState createState() => _MyAppState();
}
class _MyAppState extends State<MyApp> {
ApiProvider _provider = ApiProvider();
BioPayload bioPayload = BioPayload();
final String PAY_TYPE_BIO = "bio";
final String PAY_TYPE_PASSWORD = "password";
String get applicationId {
if(BioConstants.DEBUG) {
return Bootpay().applicationId(
'5b8f6a4d396fa665fdc2b5eb',
'5b9f51264457636ab9a07cdc',
'5b9f51264457636ab9a07cdd'
);
} else {
return Bootpay().applicationId(
'5b8f6a4d396fa665fdc2b5e7',
'5b8f6a4d396fa665fdc2b5e8',
'5b8f6a4d396fa665fdc2b5e9'
);
}
}
@override
void initState() {
// TODO: implement initState
super.initState();
bioDataInit(); //결제용 데이터 init
}
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
body: Builder(builder: (BuildContext context) {
return Column(
mainAxisAlignment: MainAxisAlignment.center,
crossAxisAlignment: CrossAxisAlignment.center,
children: [
Center(
child: TextButton(
onPressed: () => goBootpayTest(context, PAY_TYPE_BIO),
child: Text('생체인식 결제 테스트'),
),
),
Center(
child: TextButton(
onPressed: () => goBootpayTest(context, PAY_TYPE_PASSWORD),
child: Text('비밀번호 간편결제 테스트'),
),
),
],
);
}),
),
);
}
//통계용 함수
bootpayAnalyticsUserTrace() async {
// String? ver;
// if(kIsWeb) ver = '1.0'; //web 일 경우 버전 지정, 웹이 아닌 android, ios일 경우 package_info 통해 자동으로 생성
await Bootpay().userTrace(
id: 'user_1234',
email: '[email protected]',
gender: -1,
birth: '19941014',
area: '서울',
applicationId: applicationId,
);
}
//통계용 함수
bootpayAnalyticsPageTrace() async {
// String? ver;
// if(kIsWeb) ver = '1.0'; //web 일 경우 버전 지정, 웹이 아닌 android, ios일 경우 package_info 통해 자동으로 생성
StatItem item1 = StatItem();
item1.itemName = "미키 마우스"; // 주문정보에 담길 상품명
item1.unique = "ITEM_CODE_MOUSE"; // 해당 상품의 고유 키
item1.price = 500; // 상품의 가격
item1.cat1 = '컴퓨터';
item1.cat2 = '주변기기';
StatItem item2 = StatItem();
item2.itemName = "키보드"; // 주문정보에 담길 상품명
item2.unique = "ITEM_CODE_KEYBOARD"; // 해당 상품의 고유 키
item2.price = 500; // 상품의 가격
item2.cat1 = '컴퓨터';
item2.cat2 = '주변기기';
List<StatItem> items = [item1, item2];
await Bootpay().pageTrace(
url: 'main_1234',
pageType: 'sub_page_1234',
applicationId: applicationId,
userId: 'user_1234',
items: items
);
}
//결제용 데이터 init
bioDataInit() {
Item item1 = Item();
item1.name = "미키 마우스"; // 주문정보에 담길 상품명
item1.qty = 1; // 해당 상품의 주문 수량
item1.id = "ITEM_CODE_MOUSE"; // 해당 상품의 고유 키
item1.price = 500; // 상품의 가격
Item item2 = Item();
item2.name = "키보드"; // 주문정보에 담길 상품명
item2.qty = 1; // 해당 상import 'package:bootpay_bio/bootpay_bio.dart';
import 'package:bootpay_bio/config/bio_config.dart';
import 'package:bootpay_bio/constants/bio_constants.dart';
import 'package:bootpay_bio/models/bio_extra.dart';
import 'package:bootpay_bio/models/bio_payload.dart';
import 'package:bootpay_bio/models/bio_price.dart';
import 'package:bootpay_bio/models/bio_theme_data.dart';
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:bootpay/model/stat_item.dart';
import 'package:bootpay/model/user.dart';
import 'package:bootpay/model/item.dart';
import 'package:bootpay/model/extra.dart';
import 'deprecated/api_provider.dart';
import 'package:bootpay/bootpay.dart';
import 'package:flutter/foundation.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatefulWidget {
@override
_MyAppState createState() => _MyAppState();
}
class _MyAppState extends State<MyApp> {
ApiProvider _provider = ApiProvider();
BioPayload bioPayload = BioPayload();
final String PAY_TYPE_BIO = "bio";
final String PAY_TYPE_PASSWORD = "password";
String get applicationId {
if(BioConstants.DEBUG) {
return Bootpay().applicationId(
'5b8f6a4d396fa665fdc2b5eb',
'5b9f51264457636ab9a07cdc',
'5b9f51264457636ab9a07cdd'
);
} else {
return Bootpay().applicationId(
'5b8f6a4d396fa665fdc2b5e7',
'5b8f6a4d396fa665fdc2b5e8',
'5b8f6a4d396fa665fdc2b5e9'
);
}
}
@override
void initState() {
// TODO: implement initState
super.initState();
bioDataInit(); //결제용 데이터 init
}
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
body: Builder(builder: (BuildContext context) {
return Column(
mainAxisAlignment: MainAxisAlignment.center,
crossAxisAlignment: CrossAxisAlignment.center,
children: [
Center(
child: TextButton(
onPressed: () => goBootpayTest(context, PAY_TYPE_BIO),
child: Text('생체인식 결제 테스트'),
),
),
Center(
child: TextButton(
onPressed: () => goBootpayTest(context, PAY_TYPE_PASSWORD),
child: Text('비밀번호 간편결제 테스트'),
),
),
Center(
child: TextButton(
onPressed: () => goBootpayEdit(context),
child: Text('등록된 결제수단 편집'),
),
),
],
);
}),
),
);
}
//통계용 함수
bootpayAnalyticsUserTrace() async {
// String? ver;
// if(kIsWeb) ver = '1.0'; //web 일 경우 버전 지정, 웹이 아닌 android, ios일 경우 package_info 통해 자동으로 생성
await Bootpay().userTrace(
id: 'user_1234',
email: '[email protected]',
gender: -1,
birth: '19941014',
area: '서울',
applicationId: applicationId,
);
}
//통계용 함수
bootpayAnalyticsPageTrace() async {
// String? ver;
// if(kIsWeb) ver = '1.0'; //web 일 경우 버전 지정, 웹이 아닌 android, ios일 경우 package_info 통해 자동으로 생성
StatItem item1 = StatItem();
item1.itemName = "미키 마우스"; // 주문정보에 담길 상품명
item1.unique = "ITEM_CODE_MOUSE"; // 해당 상품의 고유 키
item1.price = 500; // 상품의 가격
item1.cat1 = '컴퓨터';
item1.cat2 = '주변기기';
StatItem item2 = StatItem();
item2.itemName = "키보드"; // 주문정보에 담길 상품명
item2.unique = "ITEM_CODE_KEYBOARD"; // 해당 상품의 고유 키
item2.price = 500; // 상품의 가격
item2.cat1 = '컴퓨터';
item2.cat2 = '주변기기';
List<StatItem> items = [item1, item2];
await Bootpay().pageTrace(
url: 'main_1234',
pageType: 'sub_page_1234',
applicationId: applicationId,
userId: 'user_1234',
items: items
);
}
//결제용 데이터 init
bioDataInit() {
Item item1 = Item();
item1.name = "미키 마우스"; // 주문정보에 담길 상품명
item1.qty = 1; // 해당 상품의 주문 수량
item1.id = "ITEM_CODE_MOUSE"; // 해당 상품의 고유 키
item1.price = 500; // 상품의 가격
Item item2 = Item();
item2.name = "키보드"; // 주문정보에 담길 상품명
item2.qty = 1; // 해당 상품의 주문 수량
item2.id = "ITEM_CODE_KEYBOARD"; // 해당 상품의 고유 키
item2.price = 500; // 상품의 가격
List<Item> itemList = [item1, item2];
if(BioConstants.DEBUG) {
bioPayload.webApplicationId = '5b9f51264457636ab9a07cdb'; // web application id
bioPayload.androidApplicationId = '5b9f51264457636ab9a07cdc'; // android application id
bioPayload.iosApplicationId = '5b9f51264457636ab9a07cdd'; // ios application id
} else {
bioPayload.webApplicationId = '5b8f6a4d396fa665fdc2b5e7'; // web application id
bioPayload.androidApplicationId = '5b8f6a4d396fa665fdc2b5e8'; // android application id
bioPayload.iosApplicationId = '5b8f6a4d396fa665fdc2b5e9'; // ios application id
}
bioPayload.pg = '나이스페이';
bioPayload.method = '카드';
// payload.methods = ['card', 'phone', 'vbank', 'bank', 'kakao'];
bioPayload.orderName = '테스트 상품'; //결제할 상품명
bioPayload.price = 1000.0; //정기결제시 0 혹은 주석
bioPayload.orderId = DateTime.now().millisecondsSinceEpoch.toString(); //주문번호, 개발사에서 고유값으로 지정해야함
bioPayload.metadata = {
"callbackParam1" : "value12",
"callbackParam2" : "value34",
"callbackParam3" : "value56",
"callbackParam4" : "value78",
}; // 전달할 파라미터, 결제 후 되돌려 주는 값
bioPayload.items = itemList; // 상품정보 배열
User user = User(); // 구매자 정보
user.username = "사용자 이름";
user.email = "[email protected]";
user.area = "서울";
user.phone = "010-1234-5678";
user.addr = '서울시 동작구 상도로 222';
BioExtra extra = BioExtra(); // 결제 옵션
extra.appScheme = 'bootpayFlutterExample';
extra.cardQuota = "3";
// extra.clo
// extra.carrier = "SKT,KT,LGT"; //본인인증 시 고정할 통신사명
// extra.ageLimit = 20; // 본인인증시 제한할 최소 나이 ex) 20 -> 20살 이상만 인증이 가능
bioPayload.user = user;
bioPayload.extra = extra;
}
Future<void> goBootpayEdit(BuildContext context) async {
String restApplicationId = "";
String pk = "";
if(BioConstants.DEBUG) {
restApplicationId = "5b9f51264457636ab9a07cde";
pk = "sfilSOSVakw+PZA+PRux4Iuwm7a//9CXXudCq9TMDHk=";
} else {
restApplicationId = "5b8f6a4d396fa665fdc2b5ea";
pk = "rm6EYECr6aroQVG2ntW0A6LpWnkTgP4uQ3H18sDDUYw=";
}
var res = await _provider.getRestToken(restApplicationId, pk);
res = await _provider.getEasyPayUserToken(res.body['access_token'], getUser());
String token = res.body["user_token"];
// BioPayload payload = BioPayload();
// payload.userToken = token;
BootpayBio().requestEditPayment(
context: context,
userToken: token,
themeData: BioThemeData(
titleWidget: Image.asset("images/title_widget.png", height: 22),
),
onCancel: (String data) {
print('------- onCancel: $data');
},
onError: (String data) {
print('------- onError: $data');
},
onClose: () {
print('------- onClose');
// BootpayBio().dismiss(context); //명시적으로 부트페이 뷰 종료 호출
//TODO - 원하시는 라우터로 페이지 이동
if(mounted) {
BootpayBio().dismiss(context); //명시적으로 부트페이 뷰 종료 호출
}
// print('------- onClose22');
// Navigator.of(context).pop();
},
onDone: (String data) {
print('------- onDone: $data');
},
);
}
User getUser() {
User user = User();
user.id = '123411aaaaaaaaaa1aabd4ss121567821125221253145678';
user.gender = 1;
user.email = '[email protected]';
user.phone = '01012345678';
user.birth = '19880610';
user.username = '홍길동';
user.area = '서울';
return user;
}
//버튼클릭시 부트페이 결제요청 실행
Future<void> goBootpayTest(BuildContext context, String payType) async {
String restApplicationId = "";
String pk = "";
if(BioConstants.DEBUG) {
restApplicationId = "5b9f51264457636ab9a07cde";
pk = "sfilSOSVakw+PZA+PRux4Iuwm7a//9CXXudCq9TMDHk=";
} else {
restApplicationId = "5b8f6a4d396fa665fdc2b5ea";
pk = "rm6EYECr6aroQVG2ntW0A6LpWnkTgP4uQ3H18sDDUYw=";
}
var res = await _provider.getRestToken(restApplicationId, pk);
// BootpayPrint("getRestToken: ${res.body}");
var user = getUser();
res = await _provider.getEasyPayUserToken(res.body['access_token'], user);
// BootpayPrint("getEasyPayUserToken: ${res.body}");
goBootpayRequest(context, res.body["user_token"], user, payType);
}
void goBootpayRequest(BuildContext context, String easyUserToken, User user, String payType) {
Item item1 = Item();
item1.name = "미키 마우스"; // 주문정보에 담길 상품명
item1.qty = 1; // 해당 상품의 주문 수량
item1.id = "ITEM_CODE_MOUSE"; // 해당 상품의 고유 키
item1.price = 500; // 상품의 가격
Item item2 = Item();
item2.name = "키보드"; // 주문정보에 담길 상품명
item2.qty = 1; // 해당 상품의 주문 수량
item2.id = "ITEM_CODE_KEYBOARD"; // 해당 상품의 고유 키
item2.price = 500; // 상품의 가격
List<Item> itemList = [item1, item2];
var bioPayload = BioPayload();
bioPayload.userToken = easyUserToken;
if(BioConstants.DEBUG) {
bioPayload.webApplicationId = '5b9f51264457636ab9a07cdb'; // web application id
bioPayload.androidApplicationId = '5b9f51264457636ab9a07cdc'; // android application id
bioPayload.iosApplicationId = '5b9f51264457636ab9a07cdd'; // ios application id
} else {
bioPayload.webApplicationId = '5b8f6a4d396fa665fdc2b5e7'; // web application id
bioPayload.androidApplicationId = '5b8f6a4d396fa665fdc2b5e8'; // android application id
bioPayload.iosApplicationId = '5b8f6a4d396fa665fdc2b5e9'; // ios application id
}
bioPayload.pg = '나이스페이';
// bioPayload.method = 'card';
// payload.methods = ['card', 'phone', 'vbank', 'bank', 'kakao'];
bioPayload.orderName = '플리츠레이어 카라숏원피스'; //결제할 상품명
bioPayload.price = 1000.0; //정기결제시 0 혹은 주석
bioPayload.orderId = DateTime.now().millisecondsSinceEpoch.toString(); //주문번호, 개발사에서 고유값으로 지정해야함
bioPayload.metadata = {
"callbackParam1" : "value12",
"callbackParam2" : "value34",
"callbackParam3" : "value56",
"callbackParam4" : "value78",
}; // 전달할 파라미터, 결제 후 되돌려 주는 값
bioPayload.items = itemList; // 상품정보 배열
BioExtra extra = BioExtra(); // 결제 옵션
extra.appScheme = 'bootpayFlutterExample';
extra.cardQuota = "3";
extra.separatelyConfirmedBio = true;
bioPayload.user = user;
bioPayload.extra = extra;
bioPayload.names = ["블랙 (COLOR)", "55 (SIZE)"];
bioPayload.prices = [
BioPrice(name: '상품가격', price: 89000),
BioPrice(name: '쿠폰적용', price: -25000),
BioPrice(name: '배송비', price: 2500),
];
// BootpayPrint(bioPayload.toString());
if(payType == PAY_TYPE_BIO) {
requestPaymentBio(context, bioPayload);
} else {
requestPaymentPassword(context, bioPayload);
}
}
requestPaymentBio(BuildContext context, BioPayload payload) {
// BootpayPrint(bioPayload.toString());
BootpayBio().requestPaymentBio(
context: context,
payload: payload,
showCloseButton: false,
themeData: BioThemeData(
titleWidget: Image.asset("images/title_widget.png", height: 22),
),
onCancel: (String data) {
print('------- onCancel: $data');
},
onError: (String data) {
print('------- onError: $data');
},
onClose: () {
print('------- onClose');
// BootpayBio().dismiss(context); //명시적으로 부트페이 뷰 종료 호출
//TODO - 원하시는 라우터로 페이지 이동
BootpayBio().dismiss(context); //명시적으로 부트페이 뷰 종료 호출
// print('------- onClose22');
// Navigator.of(context).pop();
},
// onCloseHardware: () {
// print('------- onCloseHardware');
// },
onIssued: (String data) {
print('------- onIssued: $data');
},
onConfirm: (String data) {
print('------- onConfirm: $data');
// return true; //결제를 최종 승인하고자 할때 return true
// return false;
//서버승인을 위한 로직 시작
// _data = data;
// Future.delayed(const Duration(milliseconds: 100), () {
// Bootpay().transactionConfirm(_data); // 서버승인 이용시 해당 함수 호출
// });
return true;
//서버 승인을 위한 로직 끝
},
onDone: (String data) {
print('------- onDone: $data');
},
);
}
requestPaymentPassword(BuildContext context, BioPayload payload) {
BootpayBio().requestPaymentPassword(
context: context,
payload: payload,
showCloseButton: false,
// closeButton: Icon(Icons.close, size: 35.0, color: Colors.black54),
onCancel: (String data) {
print('------- onCancel: $data');
},
onError: (String data) {
print('------- onError: $data');
},
onClose: () {
print('------- onClose');
BootpayBio().dismiss(context); //명시적으로 부트페이 뷰 종료 호출
//TODO - 원하시는 라우터로 페이지 이동
},
// onCloseHardware: () {
// print('------- onCloseHardware');
// },
onIssued: (String data) {
print('------- onIssued: $data');
},
onConfirm: (String data) {
print('------- onConfirm: $data');
return true; //결제를 최종 승인하고자 할때 return true
//서버승인을 위한 로직 시작
// _data = data;
// Future.delayed(const Duration(milliseconds: 100), () {
// Bootpay().transactionConfirm(_data); // 서버승인 이용시 해당 함수 호출
// });
// return false;
//서버 승인을 위한 로직 끝
},
onDone: (String data) {
print('------- onDone: $data');
},
);
}
}
부트페이 개발매뉴얼을 참조해주세요
채팅으로 문의