BootpayUI 4.4.1

BootpayUI 4.4.1

Maintained by SwiftyBootpay.



 
Depends on:
Bootpay~> 4.4.4
SCLAlertView>= 0
CryptoSwift>= 0
Alamofire>= 0
ObjectMapper>= 0
SnapKit>= 0
JGProgressHUD>= 0
SwiftyJSON>= 0
 

BootpayUI 4.4.1

  • By
  • bootpay

BootpayUI

CI Status Version License Platform

BootpayUI iOS

자세한 내용은 부트페이 개발연동 문서를 참고해주세요.

SwiftUI로 앱을 만들때 이 페이지를 참조하시면 됩니다.

Cocoapod을 통한 설치

pod 'Bootpay'

info.plist

<?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> // 사용하고자 하시는 앱의 bundle url name
            <key>CFBundleURLSchemes</key>
            <array>
                <string>bootpaySample</string> // 사용하고자 하시는 앱의 bundle url scheme
            </array>
        </dict>
    </array>

    ...
    <key>NSFaceIDUsageDescription</key>
    <string>생체인증 결제 진행시 권한이 필요합니다</string>
</dict>
</plist>

카드사 앱 실행 후 개발중인 원래 앱으로 돌아오지 않는 경우

상단의 프로젝트 설정의 info.plist에서 CFBundleURLSchemes를 설정해주시면 부트페이 SDK가 해당 값을 읽어 extra.appScheme 에 값을 채워 결제데이터를 전송합니다.

결제창 띄우는 iOS 코드

import SwiftUI

@main
struct BootpayUIApp: App {
    var body: some Scene {
        WindowGroup {
            BootpayUIView()
//            BootpayBioView()
        }
    }
}
import SwiftUI
import WebKit
import Bootpay
import BootpayUI

struct BootpayUIView: View {
//    @State private var showModal = false
    @State private var showingBootpay = false
    private var payload = Payload()
       
    var body: some View {
        GeometryReader { geometry in
            VStack {
                
                if(self.showingBootpay) {
                    BootpayUI(payload: payload)
                        .onCancel { data in
                            print("-- cancel: \(data)")
                        }
                        .onIssued { data in
                            print("-- ready: \(data)")
                        }
                        .onConfirm { data in
                            print("-- confirm: \(data)")
                            return true //재고가 있어서 결제를 최종 승인하려 할 경우
//                            return true //재고가 없어서 결제를 승인하지 않을때
//                            return false
                        }
                        .onDone { data in
                            print("-- done: \(data)")
                        }
                        .onError { data in
                            print("-- error: \(data)")
                            self.showingBootpay = false
                        }
                        .onClose {
                            print("-- close")
                            self.showingBootpay = false
                        }
                } else {
                    Button("부트페이 결제테스트") {
                        showingBootpay = true

                        #if os(macOS)
                        payload.applicationId = "5b8f6a4d396fa665fdc2b5e7" //web application id
                        #elseif os(iOS)
                        payload.applicationId = "5b8f6a4d396fa665fdc2b5e9" //ios application id
                        #endif

                        payload.pg = "나이스페이"
                        payload.method = "네이버페이"

                        payload.price = 1000
                        payload.orderId = String(NSTimeIntervalSince1970)
                        payload.orderName = "테스트 아이템"

                        payload.extra = BootExtra()
//                        payload.extra?.cardQuota = "6"

                        let user = BootUser()
                        user.username = "테스트 유저"
                        user.phone = "01012345678"
                        payload.user = user
                    }.sheet(isPresented: self.$showingBootpay) {
                    }
                }
            }.frame(width: geometry.size.width, height: geometry.size.height)
        }
    }
}

생체인증 결제시

bootpay_bio_400 bootpay_bio_400

import SwiftUI
import Alamofire
import Bootpay
import BootpayUI


let _unique_user_id = "123456abcdffffe2345678901234561324516789122"


struct BootpayBioView: View {
    @ObservedObject private var viewModel = ViewModel()
    private var _payload = BootBioPayload()
    let user = BootUser()
    private var payload = BootBioPayload()
    
    
    
   var body: some View {
       GeometryReader { geometry in
           VStack {
//               if(self.viewModel.showingBootpay == false) {
               Button("생체인증 결제테스트") {
                   
                   user.id = _unique_user_id
                   user.area = "서울"
                   user.gender = 1
                   user.email = "[email protected]"
                   user.phone = "01012344567"
                   user.birth = "1988-06-10"
                   user.username = "홍길동"
                   
                   #if os(macOS)
                   payload.applicationId = "5b8f6a4d396fa665fdc2b5e7" //web application id
                   #elseif os(iOS)
                   payload.applicationId = "5b8f6a4d396fa665fdc2b5e9" //ios application id
                   #endif

                   payload.pg = "nicepay"

                   payload.price = 1000
                   payload.orderId = String(NSTimeIntervalSince1970)
                   //                        payload.name = "테스트 아이템"
                   payload.orderName = "Touch ID 인증 결제 테스트"

                   payload.names = ["플리츠레이어 카라숏원피스", "블랙 (COLOR)", "55 (SIZE)"]
                      
//                        payload.userToken = token
                   payload.user = user

                   payload.extra = BootExtra()
                   payload.extra?.cardQuota = "6"
                   payload.extra?.displaySuccessResult = true

                   let p1 = BootBioPrice()
                   let p2 = BootBioPrice()
                   let p3 = BootBioPrice()

                   p1.name = "상품가격"
                   p1.price = 89000

                   p2.name = "쿠폰적용"
                   p2.price = -2500

                   p3.name = "배송비"
                   p3.price = 2500

                   payload.prices = [p1, p2, p3]
                   viewModel.getUserToken(user: user)
               }
               .sheet(isPresented: self.$viewModel.showingBootpay) {
                   BootpayBioUI(payload: self.payload, userToken: self.viewModel.easyPayUserToken, showBootpay: self.$viewModel.showingBootpay)
                       .onError{ data in
                           print("-- error \(data)")
                       }.onIssued{ data in
                           print("-- ready \(data)")
                       }
                       .onConfirm { data in
                           print("-- confirm  \(data)")
                           return true
//                           BootpayBio.transactionConfirm()
//                           return false
                       }
                       .onCancel { data in
                           print("-- cancel  \(data)")
                       }
                       .onDone { data in
                           print("-- done \(data)")
                       }
                       .onClose {
                           print("-- close")
                       }
                       
               }
           }.frame(width: geometry.size.width, height: geometry.size.height)
       }
   }
}

onError 함수

결제 진행 중 오류가 발생된 경우 호출되는 함수입니다. 진행중 에러가 발생되는 경우는 다음과 같습니다.

  1. 부트페이 관리자에서 활성화 하지 않은 PG, 결제수단을 사용하고자 할 때
  2. PG에서 보내온 결제 정보를 부트페이 관리자에 잘못 입력하거나 입력하지 않은 경우
  3. 결제 진행 도중 한도초과, 카드정지, 휴대폰소액결제 막힘, 계좌이체 불가 등의 사유로 결제가 안되는 경우
  4. PG에서 리턴된 값이 다른 Client에 의해 변조된 경우

에러가 난 경우 해당 함수를 통해 관련 에러 메세지를 사용자에게 보여줄 수 있습니다.

data 포맷은 아래와 같습니다.

{
  action: "BootpayError",
  message: "카드사 거절",
  receipt_id: "5fffab350c20b903e88a2cff"
}

onCancel 함수

결제 진행 중 사용자가 PG 결제창에서 취소 혹은 닫기 버튼을 눌러 나온 경우 입니다. ****

data 포맷은 아래와 같습니다.

{
  action: "BootpayCancel",
  message: "사용자가 결제를 취소하였습니다.",
  receipt_id: "5fffab350c20b903e88a2cff"
}

onIssued 함수

가상계좌 발급이 완료되면 호출되는 함수입니다. 가상계좌는 다른 결제와 다르게 입금할 계좌 번호 발급 이후 입금 후에 Feedback URL을 통해 통지가 됩니다. 발급된 가상계좌 정보를 issued 함수를 통해 확인하실 수 있습니다.

data 포맷은 아래와 같습니다.

{
  account: "T0309260001169"
  accounthodler: "한국사이버결제"
  action: "BootpayBankReady"
  bankcode: "BK03"
  bankname: "기업은행"
  expiredate: "2021-01-17 00:00:00"
  item_name: "테스트 아이템"
  method: "vbank"
  method_name: "가상계좌"
  order_id: "1610591554856"
  params: null
  payment_group: "vbank"
  payment_group_name: "가상계좌"
  payment_name: "가상계좌"
  pg: "kcp"
  pg_name: "KCP"
  price: 3000
  purchased_at: null
  ready_url: "https://dev-app.bootpay.co.kr/bank/7o044QyX7p"
  receipt_id: "5fffad430c20b903e88a2d17"
  requested_at: "2021-01-14 11:32:35"
  status: 2
  tax_free: 0
  url: "https://d-cdn.bootapi.com"
  username: "홍길동"
}

onConfirm 함수

결제 승인이 되기 전 호출되는 함수입니다. 승인 이전 관련 로직을 서버 혹은 클라이언트에서 수행 후 결제를 승인해도 될 경우

BootPay.transactionConfirm(data); 또는 return true;

코드를 실행해주시면 PG에서 결제 승인이 진행이 됩니다.

* 페이앱, 페이레터 PG는 이 함수가 실행되지 않고 바로 결제가 승인되는 PG 입니다. 참고해주시기 바랍니다.

data 포맷은 아래와 같습니다.

{
  receipt_id: "5fffc0460c20b903e88a2d2c",
  action: "BootpayConfirm"
}

onDone 함수

PG에서 거래 승인 이후에 호출 되는 함수입니다. 결제 완료 후 다음 결제 결과를 호출 할 수 있는 함수 입니다.

이 함수가 호출 된 후 반드시 REST API를 통해 결제검증을 수행해야합니다. data 포맷은 아래와 같습니다.

{
  action: "BootpayDone"
  card_code: "CCKM",
  card_name: "KB국민카드",
  card_no: "0000120000000014",
  card_quota: "00",
  item_name: "테스트 아이템",
  method: "card",
  method_name: "카드결제",
  order_id: "1610596422328",
  payment_group: "card",
  payment_group_name: "신용카드",
  payment_name: "카드결제",
  pg: "kcp",
  pg_name: "KCP",
  price: 100,
  purchased_at: "2021-01-14 12:54:53",
  receipt_id: "5fffc0460c20b903e88a2d2c",
  receipt_url: "https://app.bootpay.co.kr/bill/UFMvZzJqSWNDNU9ERWh1YmUycU9hdnBkV29DVlJqdzUxRzZyNXRXbkNVZW81%0AQT09LS1XYlNJN1VoMDI4Q1hRdDh1LS10MEtZVmE4c1dyWHNHTXpZTVVLUk1R%0APT0%3D%0A",
  requested_at: "2021-01-14 12:53:42",
  status: 1,
  tax_free: 0,
  url: "https://d-cdn.bootapi.com"
}

기타 문의사항이 있으시다면

  1. 부트페이 개발연동 문서 참고
  2. 부트페이 홈페이지 참고 - 사이트 우측 하단에 채팅으로 기술문의 주시면 됩니다.