税務連携

​

本章で得られること

• 商品の価格設定方式と、自分で計算した税額を申告する必要があるかに基づいて、税抜価格設定、両価格の指定、税込価格設定のいずれかを選択できます。
• どの税項目を Waffo が設定する必要があるか、連携前にどの業務ルールを確認すべきかを把握できます。
• 支払いと返金のリクエストを正しく構築し、照会と Webhook における金額の変化、空値、エラーを処理できます。

​

金額の指定方法を選ぶ

​

Waffo が設定する税項目

​

税サービスオプションの違い

• Calculation Only：Waffo は税額を計算し、支払い時にユーザーから徴収し、Settlement を通じて徴収した税をあなたに送金します。税務当局への納付はあなたが担当します。税の分離完了後、各税額は注文照会 APIの orderTaxAmount と対応する Webhook から読み取ることができます。
• Full Tax Service：Waffo が税額の計算、税の徴収および納付を担当します。連携前に、適用範囲と分担を Waffo に確認してください。

​

自社で計算した税額の検証

​

連携の詳細

​

連携の準備

​

注文作成時のパラメータ指定

{
  "orderCurrency": "USD",
  "orderAmount": "100.00"
}

{
  "orderCurrency": "USD",
  "orderAmount": "100.00",
  "taxInfo": {
    "taxCountry": "PHL",
    "orderAmountInclTax": "110.00"
  }
}

{
  "orderCurrency": "USD",
  "taxInfo": {
    "orderAmountInclTax": "110.00"
  }
}

​

支払い結果を読み取る

​

返金時の指定方法

{
  "refundAmount": "50.00"
}

{
  "refundAmount": "50.00",
  "taxInfo": {
    "refundAmountInclTax": "55.00"
  }
}

{
  "taxInfo": {
    "refundAmountInclTax": "55.00"
  }
}

​

よくあるエラー

​

連携チェックリスト

• 対象環境で Waffo に税契約、商品情報、請求情報の要件を確認します。
• 1 つの価格設定方式でリクエストを構築し、非課税、課税、郵便番号不足、および申告が一致しない場合の各有効ポリシーの結果を検証します。
• リクエストの元の値、注文通貨の金額、ユーザー支払い通貨の金額をそれぞれ保存します。
• 税込価格設定の作成途中状態と支払い完了後で項目がどう変化するかを検証します。
• 元の支払い注文タイプごとに全額返金と一部返金を検証し、照会と Webhook を確認します。