API Meetup #12

1. PayPal Reference Transaction APIを
お財布ケータイぽく使ってみる

2. Who am I?
©2015 PayPal Inc. Confidential and proprietary. 2
岡村 純一 Junichi Okamura
PayPal Integration
Manager/Evangelist
Scala/Java/Ruby/Python/Node.js/PHP/../Mobile/../ppt
Rock/Wine/DQ/JOJO/I18N/Marketing/Payment
API Lover/Midnight Creator
@benzookapi
jokamura@paypal.com

3. 今日お話ししたいこと
PayPal Reference Transaction APIの
画期的な使い方！
©2016 PayPal Inc. Confidential and proprietary.

4. PayPal Reference Transaction とは？
• 買い手に一度承認をもらえれば、その承認のIDだけで、任意の金額（通貨）を任意のタイミン
グで買い手から決済できる強力なAPIです。
• 強力なAPIなので実用には審査が要りますが、テスト環境（Sandbox）では、「Upgrade to
Pro」ボタン一発で使えるようになります。
https://developer.paypal.com/docs/classic/express-checkout/integration-guide/ECReferenceTxns/
https://developer.paypal.com/developer/accounts/
©2016 PayPal Inc. Confidential and proprietary.

5. 通常のユースケ−ス
• ゲームや各種プラットフォーム向けの従量課金が一般的
• ２回目以降の支払いを自動化したり、月額定期払いに応用したりすることもできます
• 日本でも導入しているマーチャント（売り手）さんが続々増えています
©2016 PayPal Inc. Confidential and proprietary.
• ペイパルクリップ（https://www.paypal.jp/jp/clip_cp/）の
TOPページ
• ※全てがReference Transactionを導入しているわけでは
ありません。

6. リファレンストランザクション 支払い同意取得
©2016 PayPal Inc. Confidential and proprietary. 6
(支払い同意だけを単独で取得する場合)
マーチャント様プログラム
PayPalサイト
1. SetExpressCheckout
→ 決済金額を０円で送信
→ MerchantInitiatedbillingを指定
← tokenが返却される
決済選択
PayPal
PayPal
ログイン
マーチャント様画面
PayPal画面
Thank you
リファレンス
トランザクション
同意画面
2. CreateBillingAgreement
→ tokenを送信
← BillingAgreementDが返却されるのでシステムに
保存
PayPalサイトにリダイレクト
(パラメタにtokenを付加する)
(1) (2)
PayPalからマーチャントサイトにリダイレクト
(パラメタにtokenが付加される)

7. リファレンストランザクション 支払い同意取得
©2016 PayPal Inc. Confidential and proprietary. 7
(初回の決済と同時に同意を取得する場合)
マーチャント様プログラム
PayPalサイト
1. SetExpressCheckout
→ 決済情報(金額、商品名など)を送信
→ MerchantInitiatedbillingを指定
← tokenが返却される
決済選択
PayPal
PayPal
ログイン
マーチャント様画面
PayPal画面
Thank you
支払い承認画面
2. DoExpressCheckoutPayment
→ 最終決済指示(金額など)を送信
← TRANCTIONID、決済結果、BillingAgreementID
が返却されるので、BillingAgreementIDを保存
PayPalサイトにリダイレクト
(パラメタにtokenを付加する)
(1) (2)
PayPalからマーチャントサイトにリダイレクト
(パラメタにtokenが付加される)

8. リファレンストランザクション 毎回決済時
©2016 PayPal Inc. Confidential and proprietary. 8
マーチャント様プログラム
1. DoReferenceTransaction
→ BillingAgreementID、金額などを送信
← TRANSACTIONID、決済情報などが返却される
マーチャント様画面
決済選択
PayPal
Thank you
マーチャント様プログラム

9. リファレンストランザクション API詳細
• SetExpressCheckout
− AMT = 0 (初回の決済と同時に同意を得る場合は、初回の決済額を指定)
− BILLINGTYPE = ‘MerchantInitiatedBilling’
• CreateBillingAgreement (支払い同意を単独で取得する場合)
− TOKEN = SetExpressCheckoutで返却されたtokenを指定
• DoExpressCheckoutPayment (初回決済と同時に支払い同意を取得の場合)
− TOKEN = SetExpressCheckoutで返却されたtokenを指定
− AMT = 初回決済額を指定
• DoReferenceTransaction
− REFERENCEID = CreateBillingAgreementもしくはDoExpressCheckoutPaymentで返却された
BillingAgreementIDを指定
− AMT = 決済金額を指定
©2016 PayPal Inc. Confidential and proprietary. 9
リファレンストランザクションを組込む場合は、それぞれのAPIに以下のパラメタを設定します(その他のパラメタについ
てはデベロッパーサイトを参照)。

10. 僕のDemoでも確認できます
https://jo-pp-ruby-demo.herokuapp.com/cl
©2016 PayPal Inc. Confidential and proprietary.

11. Reference Transactionってすごいけど…
なんかもっと便利に面白く使えないか？
©2016 PayPal Inc. Confidential and proprietary.

12. きっかけその①
味しめた
https://thinkit.co.jp/story/2015/11/12/6534
http://togetter.com/li/867390?page=8
©2016 PayPal Inc. Confidential and proprietary.

13. きっかけその②
BitCoin
http://gigazine.net/news/20131224-bitcoin-stolen-on-air/
©2016 PayPal Inc. Confidential and proprietary.

14. 思いつき
Billing Agreement IDをQRコード化すれば
限定的だがハード非依存の
お財布ケータイができるのでは？
©2016 PayPal Inc. Confidential and proprietary.

15. イメージしたユーザー体験
JALさんのタッチアンドゴー
https://www.jal.co.jp/k-tai/appli/touchandgo/
©2016 PayPal Inc. Confidential and proprietary.
1.Billing Agreement 2. Reference Transaction2. Reference Transaction

16. 決済できるIDをQRコード化って危ないのでは？
• クレジットカードとの比較
− そもそも固定の生番号をいつも携帯している=>書き留められたり写されたら終わり
− いろんなところで使える=>万能なゆえの被害拡散
− 止めるまで時間かかる=>カスタマーセンターに電話して…
• BitCoinとの比較
− 口座番号をそもそもQRコード化してるし…
• Billing Agreementは
− 自動生成のテキストデータ=>エンコード（QR化）しやすく再発行もしやすい
− 承認したマーチャントさんでしかつかえない=>盗まれても被害が小さい
− PayPalにログインすればいつでも無効化できる＝＞買い手さんの方でいつでも止めれる
割とありなんではなかろうか…
©2016 PayPal Inc. Confidential and proprietary.

17. エンジニアなんで言うよりやるが易し
Demo作ってきました！
©2016 PayPal Inc. Confidential and proprietary.

18. 構成図
©2016 PayPal Inc. Confidential and proprietary.
①
②
③ ⑧
④
⑤
⑥
⑦

19. 今後の展望
• ①PayPalの支払いボタンのようにガジェット化して事前承認を簡単に組み込めるようする
• ②QRチェックアウトが使えるマーチャントのポータルサイトの構築
• ③POSレジやチックイン・アウトサービスとの連携
• ④TDD（Talk Driven Development=登壇により自らを追い詰め強制的に突貫工事で作るこ
と）で作ったソースコードを誰かに清書してほしい
イノベーションを目指す開発者さんのインスピレーションになれば嬉しいです！
©2016 PayPal Inc. Confidential and proprietary.

20. 最後に…
PayPalの公式ソリューションではなく、
単なるアイディアです！
（実用には審査がいります）
https://www.paypal.jp/merchant/service/reference-transaction/
©2016 PayPal Inc. Confidential and proprietary.

21. 告知①
Qiita、スタックオーバーフローで投稿、質問受付中！
http://qiita.com/tags/PayPal
http://ja.stackoverflow.com/questions/tagged/paypal
©2016 PayPal Inc. Confidential and proprietary.

22. 告知②
明日パネルディスカッションに登壇します！
http://2016.cross-party.com/program/d4
©2016 PayPal Inc. Confidential and proprietary.

23. Thank You