Receipts API
Receipts APIは、成功したチャージの公式税務領収書へのアクセスを提供します。領収書は支払済み取引に対して自動的に生成され、会計、税務コンプライアンス、顧客記録のために取得できます。
概要
領収書は以下を提供します:
- 公式税務文書 - タイ取引の完全なVAT領収書
- 会計記録 - 記帳のための完全な取引詳細
- 顧客領収書 - 顧客記録用の共有可能な領収書URL
- コンプライアンスサポート - 税務および規制要件を満たす
- 取引履歴 - すべての成功した決済の詳細記録
領収書の仕組み
- 自動生成 - チャージが支払われると領収書が自動的に作成されます
- 税務コンプライアンス - タイの領収書には完全なVAT詳細と税IDが含まれます
- 永続的な記録 - 領収書は会計目的で永続的に保存されます
- ダウンロード可能 - PDF領収書はAPIまたはダッシュボードからダウンロード可能
- 顧客フレンドリー - 顧客の記録用に領収書URLを共有
領収書情報
各領収書には以下が含まれます:
- 取引詳細 - 金額、通貨、日付、チャージID
- 税務情報 - VAT金額、税ID(タイの販売者の場合)
- 販売者情報 - ビジネス名と詳細
- 顧客情報 - 顧客名とメール(提供されている場合)
- 決済方法 - カードタイプ、末尾桁数、または決済ソース
- 手数料内訳 - 取引手数料と純額
ユースケース
税務コンプライアンス
税務申告とVAT報告要件のための領収書を取得します。
カスタマーサポート
取引記録が必要な顧客に領収書PDFを送信します。
会計統合
領収書データを会計および記帳システムに統合します。
経費管理
ビジネス経費追跡と精算のための領収書を提供します。
記録保管
監査とコンプライアンスのための完全な取引記録を維持します。
利用可能なエンドポイント
- すべての領収書の一覧表示 - GET /receipts
- 領収書の取得 - GET /receipts/:id
領収書の利用可能性
領収書が作成される場合
- チャージステータスが
successfulでpaid: trueの場合に領収書が作成されます - 成功したチャージごとに1つの領収書
- 領収書は決済確認後すぐに利用可能
領収書が作成されない場合
- 保留中のチャージ(決済未完了)
- 失敗したチャージ
- 取り消された事前承認(キャプチャされていない)
- 期限切れのチャージ
領収書へのアクセス
API経由
Receipts APIを使用して、領収書データとダウン ロードURLをプログラムで取得します。
ダッシュボード経由
OmiseダッシュボードのChargesまたはReceipts セクションから領収書にアクセスしてダウンロードします。
顧客アクセス
顧客の記録用に領収書URL (download_uri) を共有します。
ベストプラクティス
✅ 推奨事項
- 領収書IDを保存 - 簡単な取得のために取引記録と一緒に保存
- 領収書URLを含める - 顧客確認メールに含める
- 領収書を定期的にダウンロード - 会計バックアップのため
- 会計ソフトウェアと統合 - 自動記帳のため
- 領収書記録を保持 - 税務コンプライアンスのため(タイでは最低7年)
- 積極的に領収書を提供 - 決済成功後に顧客に提供
❌ 避けるべきこと
- すべてのチャージに領収書があると仮定しない - 成功し支払済みのチャージのみ
- 手動で領収書を作成しない - 自動的に生成されます
- 領収書記録を削除しない - 税務コンプライアンスに必要です
- 領収書データを変更しない - 領収書は公式税務文書です
- 領収書URLを公開で共有しない - 取引詳細が含まれています
タイのVAT領収書
タイに登録されている販売者の場合:
- 領収書には完全なVAT内訳が含まれます
- 販売者の税IDが表示されます
- タイ歳入局の要件に準拠します
- 税額控除とVAT控除請求に有効です
領収書の保持
- 保持期間: 領収書は無期限に保持されます
- アクセス: APIとダッシュボードからいつでも利用可能
- コンプライアンス: タイの税法要件を満たします(7年以上の保持)
関 連リソース
サポートが必要ですか？ support@omise.coまでお問い合わせください