【snake】 Section: 16 Accepting Recurring Payments ①

Signing up with Stripe

なぜstripeを使うのか。

以下の３社があるがStripeが良い。
Stripe　PayPal　SPIKE
Paypalはアカウント持ってないといけない。
APIが優れている。

IDを作る

Going over the requirements.txt Changes

新しく以下の2つを導入する。　
mock==1.3.0　mockでリアルAPIを使う前にAPIのテストをすることができる。
stripe==1.32.0　stripeのAPIを使えるようになる。

Configuring the App to Handle Payments

config/setting.pyの４９行目からBillingが追記される。 instance/setting.pyにAPIキーを登録する。

Adding the Billing Blueprint

app.pyファイルをセットする。

１６行目から２１行目でインポートする。
７８行目と７９行目でAPIを読みこむ。
８９行目から９１行目でblueprintをregisterする。

Visualizing the Data Model Relationships

データベースのモデルに関して

Creating Subscription Plans

データベースをリセットするには以下のコマンド

$ docker-compose exec website snakeeyes db reset --with-testdb
$ docker-compose exec website snakeeyes add all

プランが記載されている。
metadataの部分をtrueにするとオススメになる。
cmd_stripe.pyでコマンドを登録する。
プランをシンクさせる。
プランをdaleateする
プランのリストを記載する

for _,　これはキーは関係ないということ。
キーはプランなので０、１、２のどれかになる。
２８行目以降でPlanはupdateかcreateの２択である。

stripecom.pyでプランを検索する(retrieve plan）
もしエラーが発生した際はprint(e)する。

gateways/stripe.pyのupdateメソッドに関して、
２６３行目からはupdate functionである。
２８２行目でプランを検索する。
２８７行目でsaveする。かなりシンプルである。

gateways/stripe.pyのcreateメソッドに関して、
２４９行目のidでプランを読み込んで、stripe APIを送る。

それでは実際にシンクさせてみる。コマンドは以下。

$ docker-compose exec website snakeeyes stripe sync_plans

次にリスト表示をさせる。シンクしたプランを表示する。

$ docker-compose exec website snakeeyes stripe list_plans

cmd_stripe.pyに list_plansが記載されている。 stripecom.pyでclsが記載されている。

次にdeleteをさせる。

$ docker-compose exec website snakeeyes stripe delete_plans bronze

cmd_stripe.pyにlelete_plansが記載されている。
nargs=-1はなに？
５２行目のdelete(plan_id)でデリートする。
stripecom.pyで記載されている。
これも同じで簡単である、
retrieveして、deleteするるだけ。

Rendering Pricing Tables

ログインしてない状態でプライステーブルをみるとsign in表示で出る ログインしてからみるをcontinueになる。 ちなみmain.cssの４７行目でtransformで若干大きくしている。

template/billing/pricing.htmlでページが構成され、
ブロンズ、ゴールド、シルバーが設定されている。
また、call billing.planとマクロが設定されている。

次にマクロフォルダーのbilling.htmlでマクロをみる。
以下で振り分けが構成されている。
if current_user.is_authenticated　→　Sign up
if current_user.subscription　→　Continue
if plan == active_plan　→　Change plan
また、５０行目の{ plan.amount | format_currency }は、
カレンシーを変更するようになっている。
app.pyでformat_currencyがインポートされている。

template_processors.pyでformat_currency functionをみる。
少数２位以下を切り捨てる。また、セントをドルに変換して表示する。

cents_to_dollars funcはlibフォルダーのmoney.pyに記載されている。

Subscribing to a Plan (Front-End) Java Scripに関して

base.htmlに以下をセットする。

script src="https://js.stripe.com/v2/"

４行目から１４行目はpayment処理に関して、

２１行目は、payment formに関して？
３４行目は、アラートセットする。
６０行目から７５行目はセレクトボックスになっていてカード情報を登録できる。 { '%04d' % year }であれば４桁の数字
current_year()+15) %であれば、現在から15年先まで。

spinnerクラスにgifがあって、hiddenになっているが、
javascrioptよくわからん。この講座の８０％がjsに関して。。
jsよくわからん

Subscribing to a Plan (Back-End)

billing.pyに関して
@handle_stripe_exceptionsに関して
500エラーのみをただ表示しないように設定をする。
例えば、４２行目はAPIキーが正しいか確認する。
４５行目はコネクションエラーが発生したときにflashメッセを表示する。
CardError、InvalidRequestError、StripeErrorなどはSTRIPE側で設定されている。

５７行目はsubscriptionをチェックして、ダメならredirectさせる。
６３行目のget_plan_by_idに関して、
もし、id と　planがマッチしたらreturnする。

６４行目は、無いプランを選択したり、POSTではなくGETで送信された場合はエラーメッセージを表示するようにした。
もし、問題なければ６９行目でPublic Keyを取得して、formを確認する。

７２行目でもしformが有効であればcreate new subscriptionを実行する。
もし成功すれば８０行目でthanksメッセージで処理する。
失敗したら８３行目でメッセージを表示させる。


creatメソッドをみる前にsubscriptionメソッドでdata modelとuser modelを確認する。

テーブルsubscriptionsにはprimarykeyでid登録があり。またuser idもある。
ForeignKeyで設定しているのでunique keyである。
ForeignKeyとは外部キーである。すでにある番号でここから選べよって意味。
ON DELETE CASCADE オプションは、親表で行が削除されたときに、
子表の対応する行を削除する場合に使用します。
planとcouponのデータベースもある。

subscription.pyに関して、 ８３行目でno tokenの場合はfalseにする。 ８５行目でcouponを大文字で表記する。 ８８行目でgateway/stripcom.pyのSubscriptionFuncを呼ぶ。 gateway/stripcom.pyに関して

customerが定義されていて、customerがそのままdbに保存される。 また、updateする際は、nameとかも定義してある。

１０３行目は、もしクーポンがあった場合はそのように処理をする。 １０８行目はcustomer functionを使う。 CreditCard を使うには、user_idを渡す。 また、extract_card_params　パラメータも使う。

CreditCard modelを確認する。 データベースが'credit_cards' user_idはsubscriptionと同じでforeignKeyとcascadeを使う。 そして、brand,last4number,expdateなどを格納できるようにする。

extract_card_paramsに関して、 ７０行目と７１行目からstripからカードデータを取得する。 ７３行目でデータを辞書に格納する。

Updating Your Payment Method

payment_method.htmlに関して、
今回はis_createでは無いので１１行目から１３行目で処理する。
また、同じように３０行目で処理をする。
related modelって何や？
billing.pyに関して
１５２行目でif not current_user.credit_cardを確認する。
１５６行目から１６１行目でクレカ情報を取得する。
１６５行目で有効な場合はupdateする。update内容はform.getで取得。
１７４行目でupdateが成功したらflashメッセージ表示
１７７行目ではダメだった場合はseting.ページへ飛ばす。
１８２行目でカードの４桁をpayment_method.htmlへ渡す。

１６５行目のupdate_payment_methodに関して
１９０行目でトークンを確認する。
あれば必要情報を入力してsessionをcommitする。

updateメソッドに関して、

Informing Users of Expiring Credit Cards

クレジットカードの有効期限が切れそうになった場合はwarningメッセを出す。
このメッセージはどのページに行っても表示される。

２行目はmacroを呼び出している。 htmlのbody欄の一番上がbilling.card_expiring_warning担っている。 実際にどのようなマクロが仕込まれているかを確認する。
billing/macro/billing.htmlの一番上を確認すると、
もし、is_authenticatedでsubscriptionがis_expiringだった場合、
card_expiring_warning()発動するようになっている。

is_expiringはクレジットカードモデルフォルダーの
credit_card.pyで定義されている。
CreditCard Classがあって、データベースに情報が格納されるようになっている。

extract_card_paramsメソッドで格納できるようパラメータ設定される。
このメソッドを使ってカード情報を読み取る。

ではどのように、有効期限が近いかを判断する。
最初にカードの有効期限が２ヶ月か設定されている。

次に期限月とtimedelta_monthsを比較する。<=で残りの数字がわかる。
returnはbool値でTrueまたはFalseで結果が出る。

ちなみに、timedelta_monthsは、lib/uti_datetime.pyで現在時刻を表示する。

ページをロードするたびにこれをチェックししすると莫大なエネルギーがかかる。そこで毎日決まった時間に確認タスクを実行するようにする。
mark_old_credit_cardsメソッドで期限切れを確認する。
次にtask.pyでceleryを使ってtaskを登録する。

config/setting.pyでCeleryを登録する。
登録方法は、名前をつけて、実行するtaskを設定して、スケジュールを決める。
crontabを使って00時に実行するように設定する。hour=23はpm11時。

Docker Compose fileも変更する
celery worker -b　ハートビートのb

Updating Your Subscription Plan

プラン変更に関して

どのようなマクロが設定されているか？ pricing.htmlを確認する。 ユーザーがsubscriptionならYou're about to change plans

次にbilling.htmlを見る もし、active_planだったらcurrent plant もし違う場合はchange plan

次にviews/billing.pyを確認する。

次に@subscription_requiredをdecorator.pyで確認する。
このデコレーターでエラー起こさないようにプロテクトする。
16行目でsubscriptionじゃなければテーブルプランにリダイレクトする。
サブスククリプションないとbilling.pyのupdateに進めないようになっている。

そして、billing.pyへ戻る。以下を順に確認する。
current_plan　→　現在プランに加入しているか
active_plan　→　get_plan_by_idメソッドで現在のプラン
new_plan　→　get_new_planメソッドで

get_new_planメソッドとは、
最初にマクロは以下のようになっている。
submitをクリックするとplan.idが飛ぶ？
plan.id →goldとか

billing.pyのrequest.form.keys()には全プランが入っている。
次にsubscription.pyのget_new_planメソッドである。
submitをsplitで区切る。
keyって何入ってるの?どこで入った？
60行目から６２行目がよくわからん。

splitメソッドとは、
区切る文字も区切る回数も自由
一行ずつ分割したいならsplitlinesを使用

この時点でactive_planとnew_planが決まった。
billing.pyへ戻る。
１０２行目から１０６行目は、
もし同じプランだった場合、プランが存在しない場合
billing.updateでリダイレクトさせる。

１１０行目でsubmitionに問題あるか確認する。

108行目でクーポンあるかformで確認する。

subscription.pyを確認する。

stripecom.pyを確認する。