Stripe decline codes

Stripeの44種類の決済拒否コードに対して、人間が読みやすい説明と多言語（英語・日本語）のユーザーメッセージを提供するTypeScriptライブラリ。依存関係ゼロで軽量、完全な型定義付きで、決済エラーのユーザー体験を向上させます。

主な機能

• 完全なカバレッジ: Stripeの44種類すべての決済拒否コードに対応
• 多言語対応: 英語と日本語の翻訳を組み込み
• 型安全: 完全なTypeScript型定義を提供
• 最新: 2024年12月のStripe APIドキュメントに基づく
• 軽量: 外部依存関係ゼロ
• 柔軟: カスタムメッセージフォーマットをサポート

インストール

npm install stripe-decline-codes

主要な関数

getDeclineDescription()

特定の決済拒否コードに関する詳細情報（説明、次のステップ、翻訳）を返します。

import { getDeclineDescription } from 'stripe-decline-codes';

const info = getDeclineDescription('card_declined');
console.log(info.description);
console.log(info.nextSteps);
console.log(info.translations.ja);

getDeclineMessage()

ユーザー向けのローカライズされたメッセージを提供します。言語設定（'en'または'ja'）を指定できます。

import { getDeclineMessage } from 'stripe-decline-codes';

const message = getDeclineMessage('insufficient_funds', 'ja');
console.log(message); // "残高不足のため、カードが拒否されました。"

formatDeclineMessage()

マーチャント名やサポート情報などの変数を使用してカスタムメッセージをフォーマットできます。

import { formatDeclineMessage } from 'stripe-decline-codes';

const message = formatDeclineMessage('card_declined', 'ja', {
  merchantName: 'Example Store',
  supportEmail: 'support@example.com'
});

利点

Stripe決済エラーを処理する際、技術的な拒否コードを顧客に分かりやすい説明に変換することが重要です。このライブラリは、翻訳ワークフローを簡素化し、多言語アプリケーション全体で一貫したユーザー体験を提供します。