Back4App와 Stripe 통합 가이드: 클라우드 코드 활용하기

클라우드 기능을 사용한 스트라이프 통합 소개 이 가이드에서는 back4app에서 호스팅된 백엔드를 스트라이프 api와 통합하는 방법을 보여줍니다 back4app에서 이를 구축하기 위한 최상의 아키텍처 선택은 https //www back4app com/docs/get started/cloud functions 스트라이프와의 클라우드 기능 통합을 완료하면 모든 프론트엔드 프로젝트(웹, ios, 안드로이드)에서 이 통합을 사용할 수 있습니다 이 가이드는 웹 예제를 사용한 완전한 스트라이프 통합을 제공합니다 전제 조건 이 튜토리얼을 완료하려면 다음이 필요합니다 back4app에서 생성된 앱 https //www back4app com/docs/get started/new parse app 을 따라 back4app에서 앱을 만드는 방법을 배우십시오 https //stripe com/br 에 계정이 생성되어야 합니다 목표 back4app 클라우드 기능을 사용하여 웹 프로젝트에 스트라이프 통합 스트라이프란 무엇인가? https //stripe com/ 는 25개국 이상에서 운영되는 기술 회사로, 개인과 기업이 인터넷을 통해 결제를 받을 수 있도록 합니다 스트라이프는 온라인 결제 시스템을 운영하는 데 필요한 기술, 사기 방지 및 은행 인프라를 제공하는 데 중점을 둡니다 이 튜토리얼에서는 웹 앱에 parse server에 stripe api를 통합하고 기능을 생성하는 단계를 안내합니다 보다 구체적으로, 이 가이드에서는 사용자가 로그인하거나 가입하고, 신용 카드를 등록하고, stripe payments를 통해 예제 구매를 생성할 수 있는 환경을 만들 것입니다 또한 서버와 stripe api의 연결이 제대로 작동하는지 테스트하는 방법도 안내합니다 1 stripe 계정 만들기 stripe에 가서 https //dashboard stripe com/register 를 클릭하세요 거기서 개인 정보를 제공하고 계정이 속한 국가를 선택하기만 하면 됩니다 다음으로, stripe 계정을 확인하세요(stripe에서 확인 링크가 포함된 이메일을 받게 됩니다) 해당 링크를 클릭한 후, stripe 이메일 주소를 확인하는 단계를 따르세요 2 데이터베이스 클래스 설정 1단계에서 stripe 환경을 구성한 후, 데이터베이스를 설정할 수 있도록 back4app 앱 대시보드로 이동하세요 이 단계는 필수는 아니지만, parse가 클라우드 함수가 새 객체를 생성하려고 할 때 자동으로 클래스를 생성하므로, 어떤 필드가 생성될지와 그 이유를 설명하기 위해 진행하겠습니다 앱의 stripe 관련 데이터를 보유할 두 개의 클래스가 있습니다 paymentmethod paymentmethod 및 payment payment 클래스가 배치되는 방식은 다음과 같습니다 paymentmethod paymentmethod type type (string) 값은 항상 “card”입니다; card card (object) 등록된 카드에 대한 전체 stripe 데이터를 보유합니다; stripeid stripeid (string) stripe 백엔드에서 이 paymentmethod를 참조하는 id입니다; user user (pointer to parse user) 이 paymentmethod가 속한 user에 대한 직접 참조입니다 payment payment data data (object) 결제에 대한 전체 stripe 데이터를 보유합니다; user user (pointer to parse user) 이 payment가 속한 user에 대한 직접 참조입니다 또한 앱 기본 string string 값 열을 두 개 추가할 것입니다 user user 클래스에 setupsecret setupsecret 및 customerid customerid 가 포함되어 stripe id를 포함하여 user user 를 stripe 상대방과 연결합니다 3 클라우드 코드 구현 앱에서 https //docs parseplatform org/cloudcode/guide/#cloud functions 를 구성하고, stripe 모듈을 설치한 후 코드를 배포합시다 클라우드 코드 환경을 더 잘 이해하고 싶다면, https //www back4app com/docs/get started/cloud functions 3 1 stripe 키 가져오기 이제 stripe 대시보드를 열고, 상단의 개발자 개발자 페이지로 이동한 후 왼쪽 메뉴에서 api 키 api 키 를 선택하세요 해당 섹션에서 발행 가능 키 발행 가능 키 와 비밀 키 비밀 키 를 확인할 수 있습니다 이 키들을 적어두세요 나중에 필요할 것입니다 3 2 클라우드 코드 파일 컴퓨터에서 다음 파일을 생성하세요 이 파일들은 모듈을 설치하고 cloud code 기능을 back4app에 추가하는 역할을 합니다 1 { 2 "dependencies" { 3 "stripe" " " 4 } 5 } 아래 코드를 새 파일에 추가하고 stripe 비밀 키를 맨 위에 붙여넣는 것을 잊지 마세요 main js 1 const stripe secret key = 2 "your stripe secret key"; 3 const stripe = require("stripe")(stripe secret key); 4 5 // stripe needs an unique customer id to create payments, so after 6 // signing up, this function should be called to do this operation 7 parse cloud define("createstripecustomer", async (request) => { 8 // get parse user object 9 const userquery = new parse query(parse user); 10 userquery equalto("objectid", request params userid); 11 let user = await userquery first(); 12 13 const customer = await stripe customers create({ email user get("email") }); 14 // creates an stripe setupintent, that will enable the stripe lib to perform 15 // a singel operation related to payments 16 const intent = await stripe setupintents create({ 17 customer customer id, 18 }); 19 // set and save the stripe ids to the parse user object 20 user set({ 21 customerid customer id, 22 setupsecret intent client secret, 23 }); 24 return await user save(null, { usemasterkey true }); 25 }); 26 27 // creates new payment method for a registered customer 28 parse cloud define("addnewpaymentmethod", async (request) => { 29 // get parse user object 30 const userquery = new parse query(parse user); 31 userquery equalto("objectid", request params userid); 32 let user = await userquery first(); 33 34 // retrieve complete stripe payment method by its id 35 const stripepaymentmethod = await stripe paymentmethods retrieve( 36 request params paymentmethodid 37 ); 38 39 // create a new setupintent so the customer can add a new method next time 40 const intent = await stripe setupintents create({ 41 customer `${stripepaymentmethod customer}`, 42 }); 43 user set("setupsecret", intent client secret); 44 user = await user save(null, { usemasterkey true }); 45 46 // creates a new parse object in the paymentmethod class 47 let paymentmethod = new parse object("paymentmethod"); 48 paymentmethod set({ 49 user user, 50 type "card", 51 stripeid stripepaymentmethod id, 52 card stripepaymentmethod card, 53 }); 54 paymentmethod save(); 55 return true; 56 }); 57 58 // creates a new payment using a valid payment method 59 parse cloud define("createnewpayment", async (request) => { 60 // get parse user object 61 const userquery = new parse query(parse user); 62 userquery equalto("objectid", request params userid); 63 let user = await userquery first(); 64 65 const { amount, currency, payment method } = request params paymentdata; 66 67 // look up the stripe customer id 68 const customer = user get("customerid"); 69 70 // create a charge using an unique idempotency key 71 // to protect against double charges 72 const idempotencykey = new date() gettime(); 73 const payment = await stripe paymentintents create( 74 { 75 amount, 76 currency, 77 customer, 78 payment method, 79 off session false, 80 confirm true, 81 confirmation method "manual", 82 }, 83 { idempotencykey } 84 ); 85 // if the result is successful, write it back to the database 86 let payment = new parse object("payment"); 87 payment set({ 88 user user, 89 data payment, 90 }); 91 await payment save(); 92 93 return true; 94 }); 4 클라우드 코드에 함수 업로드 back4app 웹사이트로 이동하여 로그인한 후 앱을 찾으세요 그 후 대시보드 대시보드 링크를 클릭하면 아래에 표시된 페이지로 이동합니다 cloud code를 배포하려면 + 추가 + 추가 버튼을 클릭하고 이전 단계에서 생성한 main js main js 및 package json package json 파일을 찾은 후 배포 배포 버튼을 클릭하세요 방금 모든 플랫폼에서 사용할 수 있는 cloud code 기능을 구성했습니다! https //www back4app com/docs/get started/cloud functions 가이드를 확인하여 호출하는 방법을 배우세요 다음 단계에서는 이들을 호출하는 javascript 프로젝트를 작업할 것입니다 5 cloud code와 javascript 앱 통합 이제 parse에서 사용자를 로그인하거나 가입시키고, 유효한 결제 방법(신용 카드)을 생성하고, 사용자의 결제 방법으로 새로운 결제를 생성하는 세 가지 주요 기능이 있는 간단한 html 페이지의 예를 볼 수 있습니다 계속해서 컴퓨터에 새 디렉토리와 다음 코드를 포함한 새 html 파일을 생성하세요 index html 1 2 3 4 5 6 7 back4app stripe payments 8 9 10 11 12 13 15 react on back4app 16 back4app stripe payments 17 18 19 20 21 22 sign in 23 24 25 26 sign in 27 28 don't have an account yet? sign up instead 29 30 31 sign up 32 33 34 35 sign up 36 37 already have an account? sign in instead 38 39 40 41 42 43 44 45 add new payment method 46 47 use any of the 48 stripe test cards 49 for this demo! 50 51 52 53 54 55 56 save card 57 58 59 60 create new payment 61 62 63 card (payment method) 64 65 66 68 69 currency 70 usd 71 brl 72 eur 73 74 75 charge selected card 76 77 78 79 payments 80 81 82 83 sign out 84 85 86 87 88 89 90 91 92 이 파일에는 두 개의 주요 섹션이 있습니다 첫 번째는 인증 섹션으로, 사용자가 아직 로그인하지 않은 경우 기본적으로 렌더링됩니다 로그인 후에는 결제 섹션이 표시되며, 여기에는 stripe에서 데이터를 생성하고 back4app의 cloud code 함수와 통신하는 모든 양식이 포함됩니다 이제 모든 것을 연결하는 코드를 포함하는 javascript 함수를 만들어야 합니다 그 함수의 이름은 index js index js index js 1 // define and initialize parse and stripe libs 2 const parse app id = "your parse id"; 3 const parse js key = "your parse js key"; 4 parse initialize(parse app id, parse js key); 5 parse serverurl = "https //parseapi back4app com/"; 6 7 const stripe publishable key = "your stripe publishable key"; 8 const stripe = stripe(stripe publishable key); 9 10 // holds the currentuser complete parse object 11 let currentuser = null; 12 const setcompletecurrentuser = async () => { 13 // called when user is already signed in, completing 14 // the currentuser object with the full one 15 currentuser = await new parse query(parse user) 16 equalto("objectid", parse user current() id) 17 first(); 18 // retrieve and render user cards and payments 19 retrievecurrentuserpaymentmethods(); 20 retrievecurrentuserpayments(); 21 }; 22 23 const retrievecurrentuserpaymentmethods = async () => { 24 // query and render user paymentmethods 25 const pmquery = new parse query("paymentmethod"); 26 pmquery equalto("user", parse user current()); 27 paymentmethods = await pmquery find(); 28 renderpaymentmethodoptions(paymentmethods); 29 }; 30 31 const retrievecurrentuserpayments = async () => { 32 // query and render user payments 33 const paymentsquery = new parse query("payment"); 34 paymentsquery equalto("user", parse user current()); 35 payments = await paymentsquery find(); 36 renderpayments(payments); 37 }; 38 39 const renderpaymentmethodoptions = async (paymentmethods) => { 40 for (let paymentmethod of paymentmethods) { 41 const optionid = `card ${paymentmethod get("stripeid")}`; 42 let optionelement = document getelementbyid(optionid); 43 44 // add a new option if one doesn't exist yet 45 if (!optionelement) { 46 optionelement = document createelement("option"); 47 optionelement id = optionid; 48 document 49 queryselector("select\[name=payment method]") 50 appendchild(optionelement); 51 } 52 53 optionelement value = paymentmethod get("stripeid"); 54 optionelement text = `${paymentmethod get("card") brand} •••• ${ 55 paymentmethod get("card") last4 56 } | expires ${paymentmethod get("card") exp month}/${ 57 paymentmethod get("card") exp year 58 }`; 59 } 60 }; 61 62 const renderpayments = (payments) => { 63 for (let payment of payments) { 64 let lielement = document getelementbyid(`payment ${payment id}`); 65 if (!lielement) { 66 lielement = document createelement("li"); 67 lielement id = `payment ${payment id}`; 68 } 69 70 const paymentdata = payment get("data"); 71 let content = ""; 72 if ( 73 paymentdata status === "new" || 74 paymentdata status === "requires confirmation" 75 ) { 76 content = `creating payment for ${formatamount( 77 paymentdata amount, 78 paymentdata currency 79 )}`; 80 } else if (paymentdata status === "succeeded") { 81 const card = paymentdata charges data\[0] payment method details card; 82 content = `payment for ${formatamount( 83 paymentdata amount, 84 paymentdata currency 85 )} on ${card brand} card •••• ${card last4} ${paymentdata status}!`; 86 } else { 87 content = `payment for ${formatamount( 88 paymentdata amount, 89 paymentdata currency 90 )} ${paymentdata status}`; 91 } 92 lielement innertext = content; 93 document queryselector("#payments list") appendchild(lielement); 94 } 95 }; 96 97 // checks if user is already signed in on parse 98 if (parse user current() !== null) { 99 setcompletecurrentuser(); 100 // hide auth screen and show payment fields 101 document getelementbyid("auth") style display = "none"; 102 document getelementbyid("content") style display = "block"; 103 } 104 105 // toggle signin and signup forms 106 document 107 queryselector("#signup toggle") 108 addeventlistener("click", async ( event) => { 109 document getelementbyid("auth signin form") style display = "none"; 110 document getelementbyid("auth signup form") style display = "block"; 111 clearauthformfields(); 112 }); 113 document 114 queryselector("#signin toggle") 115 addeventlistener("click", async ( event) => { 116 document getelementbyid("auth signup form") style display = "none"; 117 document getelementbyid("auth signin form") style display = "block"; 118 clearauthformfields(); 119 }); 120 121 // clear auth form fields 122 const clearauthformfields = () => { 123 document 124 queryselector("#auth") 125 queryselectorall("input") 126 foreach((input) => (input value = "")); 127 }; 128 129 // handle auth forms 130 document 131 queryselector("#auth signin form") 132 addeventlistener("submit", async (event) => { 133 event preventdefault(); 134 toggleallbuttonsenabled(false); 135 const form = new formdata(event target); 136 const email = form get("email"); 137 const password = form get("password"); 138 139 // try to signin on parse 140 try { 141 let user = await parse user login(email, password); 142 if (user !== null) { 143 currentuser = user; 144 // hide auth screen and show payment fields 145 document getelementbyid("auth") style display = "none"; 146 document getelementbyid("content") style display = "block"; 147 clearauthformfields(); 148 } 149 } catch (error) { 150 alert(error); 151 } 152 toggleallbuttonsenabled(true); 153 }); 154 155 document 156 queryselector("#auth signup form") 157 addeventlistener("submit", async (event) => { 158 event preventdefault(); 159 toggleallbuttonsenabled(false); 160 const form = new formdata(event target); 161 const email = form get("email"); 162 const password = form get("password"); 163 164 // try to signup on parse 165 try { 166 let user = await parse user signup(email, password, { email email }); 167 // cloud code to create stripe user and intent 168 user = await parse cloud run("createstripecustomer", { userid user id }); 169 if (user !== null) { 170 currentuser = user; 171 // hide auth screen and show payment fields 172 document getelementbyid("auth") style display = "none"; 173 document getelementbyid("content") style display = "block"; 174 clearauthformfields(); 175 } 176 } catch (error) { 177 alert(error); 178 } 179 toggleallbuttonsenabled(true); 180 }); 181 182 // signout from parse 183 document queryselector("#signout") addeventlistener("click", async ( event) => { 184 await parse user logout(); 185 currentuser = null; 186 // show auth screen and hide payment fields 187 document getelementbyid("auth") style display = "block"; 188 document getelementbyid("content") style display = "none"; 189 }); 190 191 // creates stripe card ui element 192 const elements = stripe elements(); 193 const cardelement = elements create("card"); 194 cardelement mount("#card element"); 195 196 // handle add new card form 197 document 198 queryselector("#payment method form") 199 addeventlistener("submit", async (event) => { 200 event preventdefault(); 201 toggleallbuttonsenabled(false); 202 if (!event target reportvalidity()) { 203 return; 204 } 205 const form = new formdata(event target); 206 const cardholdername = form get("name"); 207 208 const result = await stripe confirmcardsetup( 209 currentuser get("setupsecret"), 210 { 211 payment method { 212 card cardelement, 213 billing details { 214 name cardholdername, 215 }, 216 }, 217 } 218 ); 219 220 if (result error) { 221 alert(result error message); 222 toggleallbuttonsenabled(true); 223 return null; 224 } 225 226 let setupintent = result setupintent; 227 228 // cloud code to add new payment method 229 let cloudcoderesult = await parse cloud run("addnewpaymentmethod", { 230 userid currentuser id, 231 paymentmethodid setupintent payment method, 232 }); 233 234 toggleallbuttonsenabled(true); 235 alert("success on creating a new payment method!"); 236 237 // update payment method options 238 retrievecurrentuserpaymentmethods(); 239 }); 240 241 // handles new payment form 242 document 243 queryselector("#payment form") 244 addeventlistener("submit", async (event) => { 245 event preventdefault(); 246 toggleallbuttonsenabled(false); 247 const form = new formdata(event target); 248 const amount = number(form get("amount")); 249 const currency = form get("currency"); 250 // gets selected card option id 251 const paymentmethod = form get("payment method"); 252 const paymentdata = { 253 payment method paymentmethod, 254 currency, 255 amount formatamountforstripe(amount, currency), 256 status "new", 257 }; 258 // cloud code to create new payment 259 let cloudcoderesult = await parse cloud run("createnewpayment", { 260 userid currentuser id, 261 paymentdata paymentdata, 262 }); 263 264 toggleallbuttonsenabled(true); 265 alert("success on creating a new payment!"); 266 267 retrievecurrentuserpayments(); 268 }); 269 270 // helper functions 271 const toggleallbuttonsenabled = (enabledvalue) => { 272 document 273 queryselectorall("button") 274 foreach((button) => (button disabled = !enabledvalue)); 275 }; 276 277 const formatamount = (amount, currency) => { 278 amount = zerodecimalcurrency(amount, currency) 279 ? amount 280 (amount / 100) tofixed(2); 281 return new intl numberformat("en us", { 282 style "currency", 283 currency, 284 }) format(amount); 285 }; 286 287 // format amount for stripe 288 const formatamountforstripe = (amount, currency) => { 289 return zerodecimalcurrency(amount, currency) 290 ? amount 291 math round(amount 100); 292 }; 293 294 // check if we have a zero decimal currency 295 // https //stripe com/docs/currencies#zero decimal 296 const zerodecimalcurrency = (amount, currency) => { 297 let numberformat = new intl numberformat(\["en us"], { 298 style "currency", 299 currency currency, 300 currencydisplay "symbol", 301 }); 302 const parts = numberformat formattoparts(amount); 303 let zerodecimalcurrency = true; 304 for (let part of parts) { 305 if (part type === "decimal") { 306 zerodecimalcurrency = false; 307 } 308 } 309 return zerodecimalcurrency; 310 }; 파일 상단에 stripe 공개 키와 parse 앱 id 및 js 키를 추가해야 합니다 이 스크립트에서 확인하고 이해해야 할 주요 요소 중 일부입니다 페이지의 올바른 부분을 렌더링하기 위해 스크립트를 처음 로드할 때 parse user current parse user current 메서드의 사용을 확인하십시오; parse에서 작업을 수행할 폼 제출 액션 리스너, 예를 들어 로그인 또는 회원가입 및 stripe 관련 객체를 생성하고 back4app 데이터베이스에 저장하기 위해 cloud code 함수를 호출하는 것; 현재 사용자의 payment payment 및 paymentmethod paymentmethod 객체를 검색하기 위해 parse에서 쿼리를 수행하는 “retrieve” 및 “return” 메서드 앱을 테스트하기 전에 같은 디렉토리에 app css app css 라는 css 파일에 다음 스타일시트를 추가하십시오 1 / back4app guide / 2 3 , 4 before, 5 after { 6 margin 0; 7 padding 0; 8 box sizing inherit; 9 } 10 11 html { 12 font family sans serif; 13 box sizing border box; 14 outline none; 15 overflow auto; 16 } 17 18 body { 19 margin 0; 20 background color #fff; 21 } 22 23 h1, 24 h2, 25 h3, 26 h4, 27 h5, 28 h6 { 29 margin 0; 30 } 31 32 p { 33 margin 0; 34 } 35 36 container { 37 width 100%; 38 max width 600px; 39 margin auto; 40 padding 20px 0; 41 } 42 43 wrapper { 44 width '90%'; 45 align self 'center'; 46 } 47 48 header { 49 display flex; 50 flex direction column; 51 align items center; 52 padding 25px 0; 53 background color #208aec; 54 } 55 56 header logo { 57 height 55px; 58 margin bottom 20px; 59 object fit contain; 60 } 61 62 header text bold { 63 margin bottom 3px; 64 color rgba(255, 255, 255, 0 9); 65 font size 16px; 66 font weight bold; 67 } 68 69 header text { 70 color rgba(255, 255, 255, 0 9); 71 font size 15px; 72 } 73 74 flex row { 75 display flex; 76 } 77 78 flex between { 79 display flex; 80 align items center; 81 justify content space between; 82 } 83 84 form wrapper { 85 margin top 20px; 86 margin bottom 10px; 87 } 88 89 form heading { 90 margin bottom 10px; 91 } 92 93 form { 94 padding bottom 25px; 95 margin 25px 0; 96 border bottom 1px solid rgba(0, 0, 0, 0 12); 97 } 98 99 form input { 100 display block; 101 width 100%; 102 height 46px; 103 padding 0 15px; 104 background color #e6e6e6; 105 border 1px solid #ccc; 106 border radius 999px; 107 margin bottom 20px; 108 font size 16px; 109 } 110 111 form button { 112 display block; 113 width 100%; 114 height 42px; 115 padding 0 15px; 116 background color #208aec; 117 border 1px solid #208aec; 118 border radius 999px; 119 color #fff; 120 font size 16px; 121 cursor pointer; 122 } 123 124 form hint { 125 display block; 126 margin top 20px; 127 color rgba(0, 0, 0, 0 5); 128 font size 16px; 129 text align center; 130 text decoration color rgba(0, 0, 0, 0 4); 131 } 132 133 card element wrapper { 134 padding 13px 15px; 135 margin bottom 20px; 136 background color #e6e6e6; 137 border 1px solid #ccc; 138 border radius 999px; 139 } 앱을 테스트하려면 https //github com/http party/http server 와 같은 로컬 http 서버를 사용하세요 가입 후, 앱은 다음과 같아야 합니다 결론 위에서 설명한 가이드를 통해, back4app에서 cloud code 기능을 사용하여 stripe를 사용하고 간단한 javascript 앱에 결제를 통합할 수 있었습니다! stripe 통합 중 문제가 발생하거나 기능이 작동하지 않는 경우, 채팅을 통해 저희 팀에 문의해 주세요!