Swift愛好会合宿で活躍したLINE PayとそのAPIを利用してみる(Node.js) #love_swift

こんにちは、 @n0bisukeです。

Swift愛好会の運営を手伝ったりしてます。Swift愛好会アドベントカレンダーということで、Swift愛好会合宿に関する記事を書こうと思います。

ちなみにこの写真は、奇跡的なベストショットをこの時話題だったEverfilterで加工したものです。

Swift愛好会合宿とは

先日の2016年12月3日~4日で行われたSwift愛好会の一周年記念合宿です。

• 【１周年・合宿】集まれSwift好き！Swift愛好会 vol13

合宿はまさに伝説的な盛り上がりに

この合宿はものすごく参加者満足度が高く、様々な記事が書かれています。

• 2016 年の Swift 愛好会を、自分が談義した話を中心にざっくり振り返ってみる #love_swift

合宿会場は千葉・笹川の 土善旅館 さまでしたけど、Wi-Fi は 22 人を余裕でさばく完璧な性能だったし、大画面スクリーンはあるし、外部ディスプレイはあるし、椅子でなにか疲れを感じた記憶もないし、テーブルの高さはちょうど良いし、猫は来襲するし。それに、電源タップも不足をまったく感じさせないし、なんなら外付けキーボードまで貸してもらえたりするくらい。そんな 設備の充実さが光る土善旅館さま でした。

と@es_kumagaiさんもべた褒めです。

• 22名で開発合宿いったけど土善旅館さん、なんだこれまじで最高か？

運営メンバーの@gotou015さんによる記事ですが 88いいね、31はてぶと普通にバズってます

• Swift愛好会1周年記念合宿に参加してきました！ – 1日目 #love_swift
• Swift愛好会1周年記念合宿に参加してきました！ – 2日目 #love_swift

@ktanaka117さんはまさかのDevelopers.IOに合宿記事を書いてくれました。すごい。

• Swift愛好会合宿 1日目 レポート
• Swift愛好会合宿 2日目 レポート

たまきさんによるレポートたちです。

• 【１周年・合宿】集まれSwift好き！Swift愛好会 vol13 中のツイートまとめ #love_swift

@es_kumagaiさんによるトゥギャッターまとめも。

• Swift愛好会合宿にビールを送り込んだ話

@cozynooksさんは合宿にビールを送り込んで下さいました。めちゃ美味しくいただきました！

帰還してから多方面から合宿問い合わせがくるなど

こんな感じで色々な人から合宿楽しそう！やりたい！という話が来ました笑

こちらGoカンファレンス主催の@tenntennさん。

とまぁ、 めちゃ盛り上がった合宿でした。

合宿を支えた「LINE Pay」

さて、ここまではSwift愛好会合宿がいかに盛り上がったかを書きましたが、実際の裏側の運営話もあったりします。

僕は流れで会計担当をやっていたのですが、集金にLINE Payを採用しました。

LINE Payって?

LINEが提供している個人間送金が可能なプリペードの電子マネーのようなものです。

個人間送金の手数料が無料なので、僕の場合は飲み会やフットサルの割り勘などによく使っています。
お金の貸し借りのログも残るので便利です。

チャージや送金で貯めたお金はLINE PayカードでJCBのクレジットカードとして使うことも可能です。ちなみに今はポイント還元率がなんと4%らしいですね！

なぜLINE Payを採用したのか

イベントをやると必ずと言っていいほど発生するのが ドタキャンです。まぁ仕方ないと思います。
ただ、今回の合宿は一人当たり13000円の参加費用がかかりました。この参加費でドタキャンが発生すると運営側がかなり厳しいので前払いを前提としました。

PayPalのビジネスアカウント用意はけっこう大変

connpassの場合前払いでお金を徴集する場合、PayPalのビジネスアカウントが必要になります。
これはけっこう用意するのが大変で、(僕は持ってましたが)通常はあまり持っていないと思います。

大体の人がPayPalアカウントは持ってないけどLINEアカウントは持ってる

PayPalアカウントはWeb業界の人でも持ってる人と持ってない人が半々くらいの割合な気がしてます。
LINEアカウントはほぼ100%で所持しているのでLINEアプリがあれば使えるという点もLINE Pay採用ポイントでした。

手数料が0円

PayPalだと3.6%+40円～という手数料で130000円の集金だと手数料が500円強かかることになります。20人参加だと10000円を超える金額になるため運営費用で見るとけっこう大きな額です。

LINE Payの個人間送金だと手数料が0円ということもあり、手数料の節約になりました。

実際の合宿時の運用

PayPalとLINE Payの併用

PayPalアカウントを持ってる人もいると思ったのでPayPalでの支払いもできるようにしました。

ただ、PayPal支払いの場合は手数料が発生して運営側が受け取れるお金が減ってしまうため500円多めに集金という強め設定です。

• PayPal支払い -> 13500円
• LINE Pay支払い -> 13000円

という形にしましたが、500円高くてもPayPal払いの人も半数くらいいました。
イベントによく参加する人はPayPal払い慣れてるんですね。

合宿の連絡もLINEグループで展開

LINEは当たり前のように全員が使ってる認識でLINEグループを作成し、そこで連絡しつつお金の集計もしました。

ちなみに振り返りながら書いてますがこのキャプチャは 僕が成田駅で一人はぐれてしまったときの会話です。苦笑

運営側のお金やりとりも

当日発生したお金のやりとりもLINE Pay送金です。

合宿の連絡自体をLINEでしていたので当然運営側もLINE Payのやりとりで成り立ちます。

キャッシュバックもLINE Payで

会が終わった後に、若干お金が余ったのでなんと 一人当たり555円のキャッシュバックを実施。
555円って現金で返すと大変だけど、LINE Payだと数字の移動だけなので楽ですね。

[本題] LINE PayのAPIを触ってみよう

こんな感じでLINE Payはだいぶ役立ってくれました。
LINE PayはAPIもあるのでもっと便利に出来そうです。

ちなみにSwift愛好会にいますが僕はSwiftはほぼ書いてません。ということでNode.jsで実装してみたいと思います。(合宿中に書いていたネタでもあります)

申請が必要

2016年12月時点だとLINE PayのAPIを実際に使う場合は申請が必要で、僕が申請したときに運営しているサイトに独自カートシステムがないという理由でリジェクトされてしまいました。

イベントの集金とかで使えたらって思ったけど現時点だと難しそうですね苦笑
(運営側の人みてないかなぁ)

本当ならAPIを使って合宿の決済を済ませられないかと検討していました。

サンドボックス利用してみる

サンドボックス利用なら試すことはできるので、触ってみた記録を残します。

LINE Pay DevelopersからSandboxを生成しましょう。
ちなみにこのリンクがLINE Payのページのどこから辿れるのかがよく分からないです苦笑

APIの詳細はLINE Pay技術連動ガイドを参照して進めましょう。現時点だとPDFしかないみたいですが、そのうちページが用意される気がします。

利用の流れ

テストフローの通りに進めると実装ができます。この辺りの詳細はまた別記事に書こうと思います。

APIの流れとしては以下の図にあるような流れになります。

払い戻しなどを省いて、シンプルなのは決済reserve API -> paymentUrl / (ユーザー側)ログイン認証&決済処理 -> 決済confirm APIという流れです。今回はこの流れだけで実装してみます。

LINE Pay技術連動ガイドより

Node.jsで実装してみる

エンドポイントや必須のリクエストヘッダ情報を埋めます。

API認証部分

X-LINE-ChannelIdとX-LINE-ChannelSecretのヘッダ情報でLINEのサーバーとの認証をさせ、HTTPリクエストを司る部分です。

httpclient.js

'use strict'

const client = require('https');

const LINE_CHANNEL_ID = `xxxxxxxxxxxxx`;
const LINE_CHANNEL_SECRET = `xxxxxxxxxxxxxxxxxxxxx`;
const HOST = `sandbox-api-pay.line.me`;
const PATH = `/v2/payments/request`;

module.exports = ($requestData, $path, $method = 'POST') => {
    let postDataStr = JSON.stringify($requestData);
    let options = {
        host: HOST,
        port: 443,
        path: $path,
        method: $method,
        headers: {
            'Content-Type': 'application/json; charset=UTF-8',
            'X-LINE-ChannelId': LINE_CHANNEL_ID,
            'X-LINE-ChannelSecret': LINE_CHANNEL_SECRET
        }
    };
    
    return new Promise((resolve, reject) => {        
        let req = client.request(options, (res) => {
            let body = '';
            res.setEncoding('utf8');
            res.on('data', (chunk) => {
                body += chunk;
            });
            res.on('end', () => {
                let response = JSON.parse(body);
                resolve(response);
            });
        });
        req.on('error', (e) => {
            reject(e);
        });
        req.write(postDataStr);
        req.end();
    });
}

メインの処理

説明すると以下の流れになります。

• ユーザーが/にアクセスした際に購入リンクを表示させ、/reserveに飛ばします。
• /reserveでは商品情報などをLINE側に送信し、専用のURL(paymentUrl)を発行してもらいます。
• 発行されたpaymentUrlからユーザーは認証&決済をして/confirmに戻り、決済完了処理を行います。

app.js

'use strict'

const uuid = require('node-uuid');
const app = require('express')();
const http = require('http').Server(app);
const PORT = process.env.PORT || 1337;
const httprequest = require('./httpclient');
const DOMAIN = 'http://localhost:${PORT}';

app.get(`/`, (req, res) => {
  let html = `<h1>LINEで決済</h1>
  <a href="/reserve">購入!</a>`;
  res.send(html);
});

//決済reserve API
app.get(`/reserve`, (req, res) => {
  let requestData = {
    "productName": "募金します。",
    "amount": 1,
    "currency": "JPY",
    "confirmUrl": `${DOMAIN}/confirm`,
    "orderId": uuid.v1()
  };

  httprequest(requestData,'/v2/payments/request')
  .then((responseData)=>{    
    //成功
    if(responseData.returnCode === `0000`){
      res.redirect(responseData.info.paymentUrl.web);
    }

    //失敗
    else if(responseData.returnCode === `1106`){
      console.log(responseData.returnMessage);
    }

  },(e)=>{console.log(e)});
});

//決済confirm API
app.get(`/confirm`, (req, res) => {
    let transactionId = req.query.transactionId;
    let requestData = {
      "amount": 1,
      "currency": "JPY"
    };
    let path = `/v2/payments/${transactionId}/confirm`;
  
    httprequest(requestData, path)
    .then((responseData)=>{
      console.log(responseData);
      let html = `ご購入ありがとうございました。<a href="/">戻る</a>`;
      res.send(html);
    },(e)=>{console.log(e)});

});

http.listen(PORT, () => {
  console.log(`listening on *:${PORT}`);
});

決済reserve API

/reserveの箇所です。

POSTリクエストの情報にproductName(商品名)やamount(金額)などを指定しています。
成功するとLINEのサーバーからpaymentUrlと呼ばれるURLが送られてくるのでそこにリダイレクトさせています。

今回は「募金します。」という商品を「1円」で売っていることにしました。

決済confirm API

/confirmの箇所です。
ユーザーが認証&決済を済ませた後にリダイレクトしてきます。このときにtransactionIdという決済ごとのIDがLINEのサーバーから渡ってくるのでキャッチし、このIDをconfirm apiへのリクエストに渡してます。

このときreserve apiを読んだ時点の情報と違いがあると決済が成功しません。
LINE Pay APIではここで二段階で確認をすることで安全性を担保しているようです。

実際に使って確認

今の実装を試すとこんな感じで動作します。

解説してないですが、実際にはIPのホワイトリスト登録なども必要です。

SandBoxの場合はこちらから決済の内容が確認できます。

取引金額1円がちゃんと履歴に入ってますね！

おわりに

こんな感じでLINE Payでの商品の購入をNode.jsで実装することができました。

この記事の内容をまとめると、

• LINE Payは集金とかに向いてる
• API使って実装もできる

という感じです。みなさんも普段使いLINE Payから始めてみましょう。

最後になりますが、Swift愛好会のアドベントカレンダーでSwift書かずすみません苦笑
(SSSwiftで書いてみようか悩みましたが時間がかかりそうだったのでry)