バージョン: 最新版

Receipts API

Receipts APIは、成功した課金の公式税務レシートへのアクセスを提供します。レシートは支払済み取引に対して自動的に生成され、会計、税務コンプライアンス、顧客記録用に取得できます。

概要

レシートが提供するもの:

公式税務書類 - タイの取引の完全なVATレシート
会計記録 - 簿記のための完全な取引詳細
顧客レシート - 顧客記録用の共有可能なレシートURL
コンプライアンスサポート - 税務および規制要件への対応
取引履歴 - すべての成功した支払いの詳細な記録

レシートの仕組み

自動生成 - レシートは課金が支払われると自動的に作成
税務コンプライアンス - タイのレシートには完全なVAT詳細と納税者番号が含まれる
永久記録 - レシートは会計目的で永久に保存
ダウンロード可能 - PDFレシートはAPIまたはダッシュボード経由でダウンロード可能
顧客フレンドリー - レシートURLを顧客と共有して記録保持

レシート情報

各レシートに含まれるもの:

取引詳細 - 金額、通貨、日付、課金ID
税務情報 - VAT金額、納税者番号（タイの加盟店向け）
加盟店情報 - ビジネス名と詳細
顧客情報 - 顧客名とメール（提供された場合）
支払い方法 - カードタイプ、下数桁、または支払いソース
手数料内訳 - 取引手数料と純額

ユースケース

税務コンプライアンス

税務申告と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内訳が含まれる
加盟店の納税者番号が表示
タイ国税局の要件に準拠
税額控除およびVATクレジット請求に有効

レシートの保持

保持期間: レシートは無期限に保持
アクセス: APIおよびダッシュボードからいつでも利用可能
コンプライアンス: タイの税法要件を満たす（7年以上の保持）

概要​

レシートの仕組み​

レシート情報​

ユースケース​

税務コンプライアンス​

カスタマーサポート​

会計統合​

経費管理​

記録保持​

利用可能なエンドポイント​

レシートの利用可能性​

レシートが作成される場合​

レシートが作成されない場合​

レシートへのアクセス​

API経由​

ダッシュボード経由​

顧客アクセス​

ベストプラクティス​

推奨事項​

非推奨事項​

タイのVATレシート​

レシートの保持​

関連リソース​

概要