Stripe外からアプリの支払いを受け取った時の対処手順

Stripe外からアプリの支払いを受け取った時の対処手順

Stripe外からアプリの支払いを受け取った時の対処手順

カード決済の失敗理由は基本的に分からない/信用コストは自分で払う必要がある/根本解決は事業者としての信用を高める事

どうも、個人アプリ作家のTAKUYAです。サブスク制のサービスを、カード決済プラットフォーム「Stripe」を使って組んでいます。基本的に支払いはクレジットカードとデビットカードのみ受け付けています。しかしながら、そのカード決済がどうしてもうまく行かないケースがごく稀にあります。その時、例外的にPayPal経由で支払ってもらうようにしています。本稿ではその際の管理手順について、自分用の備忘録も兼ねて解説したいと思います。

カード決済の失敗理由は基本的に分からない

クレジットカード決済は様々な理由でdecline(拒否)されます。体感的には全体の10%ぐらいが失敗しているように見えます。declineされるポイントは2つです:

  • カード登録時
  • 決済実行時

失敗理由は実に様々で、StripeのドキュメントにDecline Code一覧が記されています。

Bank Decline Codes | Stripe
Understand what decline codes mean and how you can resolve them when a charge is declined. If a card issuer declines a…

この中でも最も多いのがdo_not_honorgeneric_declineです。その説明は両方とも:

Description: The card has been declined for an unknown reason.
Next streps: The customer needs to contact their card issuer for more information.

となっており、全く参考になりません。3年間のサービス運営を通じてユーザさんと一緒に調べた結果、以下のケースがありました:

  • デビットカードが継続支払いに対応していなかった
  • 日本からの請求を不審と判断された
  • .info ドメインが不審と判断された
  • Let’s EncryptのSSL証明書が不審と判断された

最初の理由以外はすべてセキュリティ上のfalse positiveです。この場合、カード発行会社に直接連絡してdeclineしないようにお願いするしかありません。それでも必ず許可が下りるとは限りません。別のカードを試したらすんなり通る事も多々あるので、基準はカード会社ごとにバラバラのようです。あと、今まで何ヶ月間も普通に決済できていたのに突然謎の理由で拒否されるケースも多くあります。カード所持者を守るための仕組みですから、一概にカード会社を責められる問題ではないのが難しいところです。

信用コストは自分で払う必要がある

上記の経験から、僕のサービスではもともと inkdrop.info というドメインを使っていたのですが inkdrop.app に変更しました。また、彼らはwhoisも見ているようですので、虚偽の情報を設定しないように注意が必要です。Let’s Encryptは無料で手軽に入手できるSSL証明書である一方、フィッシングサイトなどにも濫用されるらしく全く信用されていないようです。そりゃそうですね、個人や法人の実在確認無しで発行できるんですから。なので自分のサービスが法人化した折に、社会的信用の高い証明書を買うつもりです。

つまり、Stripeは個人でも審査無しでカード決済が導入できる一方で、上記のような信用上のコストがのしかかる事が分かりました。それもなかなか無視できない大きさです。

有料アプリを売る手段の代表例として、AppleのApp Storeがあります。彼らの課金手数料は30%と高いですが、この信用上のコストだと思うと納得できます。アプリのサイズが大きいとCDNの配信コストも馬鹿になりませんが、App Storeでは一切かかりません。うまく行けばApp Storeがアプリをピックアップして宣伝してくれる事もあります。決済トラブルはAppleが対応してくれます。やみくもに課金手数料を忌み嫌うのではなく、こういったコスト面・マーケティング面でのメリットが30%に含まれている事を念頭に置くと良いでしょう。

外部から支払いを受け取った場合の調整方法は2つ

このように、カード決済失敗の問題に対してこちらで対処を尽くしても解決できないケースが稀にあります。その場合は諦めてPayPal経由で支払いを受け付けるようにしています。自分のサービスでは、1年間のライセンス料($49.9)をPayPalから請求しています。その際、Stripe上では以下の2つの場合に分けて支払いステータスを調整します:

  1. 試用期間がまだ残っていて請求がまだ実行されていない
  2. 試用期間がすでに終了して請求が実行された後

それぞれの手順について説明します。

Customer Balanceにクレジットを追加する

試用期間がまだ終了しておらず、Stripe側でまだ請求が実行されていない場合。予定している請求が試用期間終了時に実行されます。この請求が失敗してしまわないように、Customer Balanceを調整します。以下の通りStripeには台帳機能が備わっていて、「借り方(credit)」「貸し方(debit)」の管理ができます。

Customer balance | Stripe Billing
How to use the customer balance ledger Every customer in Stripe Billing has a ledger against which you can issue credit…

まず顧客のアカウントを開いて、Customer Balanceのセクションを確認します。

Customer Balanceのセクション

“Add balance adjustment”をクリックします。

上記のようにCreditを追加します。要するに、あなたはこの顧客に対して「借りがある」と設定する訳です。すると、次回の請求からこのCreditの額面が差し引かれます。以下のようにAdjustmentの項目が追加されます:

これで調整出来ました。

請求ステータスを手動で支払い済みに変更する

試用期間が終了してStripe側から既に請求が実行された場合。Customer Balance Creditを既に実行された請求に対して後から適用する事は出来ません。実行された請求(Invoice)を手動で調整します。該当するInvoiceを開きます:

「…」ボタンをクリックします。

「Change invoice status」を選択します。

「Paid」を選択します。説明にある通り、この操作によって該当の請求がStripeの外で回収された事にします。よく出来てますね。注意欄で表示されているように、この操作は取り消しできないので慎重に操作して下さい。

これで支払いステータスを調整できました。

事業者としての信用を高めていきたい

Stripeはカード決済の「導入」と「運用」の開発コストを大幅に下げてくれますが、信用面は一切サポートしてくれません。トレードオフですね。今回ご紹介した通り、機能面では申し分なく柔軟な対応が出来てとても便利です。しかし、いち事業者としての信用は自分で高めていかなければならない事を常に痛感します。これは僕にとって今後の課題です。今のところは、適宜手動運用で対応していこうと思います。

Read more

ノート駆動AIコーディング術の提案

ノート駆動AIコーディング術の提案

どうもTAKUYAです。みなさんはAIエージェントを普段のコーディングで活用されていますか。ちょっと面白いワークフローを思いついたのでシェアします。それは、ノート駆動のエージェンティック・コーディング・ワークフローです。最近Claude Codeのプランモードを使っていたら、ターミナル内で生成されたプランを読むのが辛かったんです。それで、じゃあMarkdownノートアプリであるInkdropをプランの保存先バックエンドとして使えば解決するんじゃないかと思って、 試してみました。こちらがそのデモです(英語): こちらがClaude Codeの設定ファイル群です: GitHub - inkdropapp/note-driven-agentic-coding-workflow at devas.lifeComplete Claude Code configuration collection - agents, skills, hooks, commands, rules, MCPs. Battle-tested configs from an Anthropic hackathon w

By Takuya Matsuyama
2025年個人開発活動の振り返り

2025年個人開発活動の振り返り

どうもTAKUYAです。もう1月も半ばに差し掛かっているけど、2025年の自分の活動の振り返りをしたい。去年を一言で言うなら、本厄を満喫した年だった。 厄年とは、人生の節目にあたって、体調不良や災難が起こりやすいと経験的に言われる年齢のこと。数え年で42歳、確かにもう若さに任せた事は出来ないなと痛感した年だった。(ところであなたの国ではこのような年はありますか?) 夏に体調を崩して2~3ヶ月動けなくなった 暖かくなり花粉が飛び出した頃に、持病のアトピーが悪化しだして、まともに生活出来なくなってしまった。酷さで言うと、2019年に脱ステした時と同じぐらい。 脱ステに無事成功したから、この地獄は二度と味わうことはないだろうと高を括っていたが、まさか7年後にまた味わうとは思わなかった。当時の独身時代と違い、妻も子供もいる中で、周りに多大な迷惑をかける事となった。夏の子供との思い出が全く無い。悲しい。 現在はQoLもほとんど元の状態まで復活できた。写真を撮って症状の変化を記録したので、機会があればシェアしたい。食事療法など色々試したが、結局歩くのが一番自分に効いた。それ以来、一日一万歩

By Takuya Matsuyama
書いて、歩け!なぜノートアプリはシンプルで充分なのか

書いて、歩け!なぜノートアプリはシンプルで充分なのか

どうもTAKUYAです。今回はノートやメモから新しい発想を生むための考え方についてシェアします。 自分はシンプルさをウリにした開発者向けのMarkdownアプリInkdropを作っています。なので、どうしても「ノートアプリの作者」としてのポジショントークが含まれてしまいますが、逆に言えば、「ノートアプリを約10年間作り続けてきた人間が、どうやってアイデアを生み出しているのか」 という実際的な体験談として読んでもらえれば幸いです。 結論から言うと、僕は「アプリ上でノート同士を連携させる必要はない。繋げるのはあなたの脳だ」と考えています。本稿では、ノートアプリの機能に溺れずユニークなアイデアを考え出すために僕が実践している事をシェアします。 TL;DR * ノート整理に時間をかけるな。グループ化で充分だ * すごい人はアイデアが「降りてくる」のを待つ * プログラミング × 料理動画 という有機的な掛け合わせ * ノートは「忘れる」ために書く * 歩け! ノート整理に時間をかけるな。グループ化で充分だ 巷ではZettelkastenなどが流行っているようですね。これ

By Takuya Matsuyama
貫禄を捨てて愛嬌で生き延びろ!40代オッサンの生存戦略

貫禄を捨てて愛嬌で生き延びろ!40代オッサンの生存戦略

どうもTAKUYAです。 つい先週(11月19日)に誕生日を迎え、41歳になりました。40代と言うのは若い頃には想像もしなかった年代で、どう生きれば良いのかというイメージがあまり具体的に湧かない、曖昧な年齢ではないでしょうか?自分の父親を想像するも、日中はいつも仕事でいなかったのであまり参考になりません。 自分は個人開発で生計を立てていて20代、30代で積み上げて来たものが上手く実を結んだおかげで今の生活があります。育児にも、いわゆるサラリーマンよりかは柔軟に参加できていて、子供との時間も沢山取れています。ママ友も出来ました(迷惑かけっぱなしですが)。 本記事では、そんなライフスタイルを送る自分が40代で大事にしたいことについて書きたいと思います。タイトルにもある通り、結論から言うとそれは「愛嬌」だと思います。以下、中年男性の愛嬌の重要性について説明します。 TL;DR * 「貫禄が出てきたね」と言われたら注意 * 笑顔を作れ。オッサンがムスッとしてたら普通に怖い * 謙虚に振る舞え。実績を積むと周りが萎縮する * ギャップ萌えを活用しろ 「貫禄が出てきたね」と言わ

By Takuya Matsuyama