Thailandご契約加盟店様のみご利用いただけます。その他の国でOmiseをご利用中の加盟店様には誠に恐縮ですが、ご提供開始まで今しばらくお待ちください。分割払いをご利用いただくと、一定期間に少額ずつお支払いただくことが可能になります。Omiseでは、この利便性の高い決済方法をご利用いただけるようAPIを提供しています。現時点では、合計支払金額が3,000THB以上となった場合に、最大36回の分割払いプランをご利用いただけます(利用可能な期間の長さおよび月々の最低支払額は、ご利用のカード毎に異なります)。顧客が分割支払いを選択すると、支払いページがリダイレクトされます。加盟店のウェブサイトから、銀行が運営するページにリダイレクトされた上で、決済金額の確認が行なわれます。完了すると、顧客は加盟店のWebサイトに再度リダイレクトされます。次のスクリーンショットは、この決済フローを説明しています。支払い時に、顧客は分割支払いを選択します。支払い先の銀行を選択した後、銀行が運営するWebページにリダイレクトされます。決済金額ならびに照合番号は、承認ページに既に入力された状態になります。顧客は、決済情報と支払い金額を確認するだけの状態になります。い料金の作成には以下の手順が含まれます。ソースAPIを利用して、新しい決済ソースを作成する。課金APIを利用して、新しい課金を作成し、最初のステップで作成したソースIDを渡す。これは、新しい決済ソースの登録(ステップ1)がパブリックキー(公開鍵)を利用してクライアント側(例:ユーザのブラウザまたは携帯電話上)で行われ、課金の作成(ステップ2)がプライベートキー(秘密鍵)を使用してサーバ側で行われると仮定します。このフローをクライアント側で実装する際は、Omise.jsまたはOmiseのモバイルSDKいずれかを使用することをお勧めします。非推奨ですが、サーバー側でソースの作成と課金の両方が行われる必要がある場合、課金APIを利用してソースの作成と課金を行うことができます。どちらが分割払いの利息を負担するかを設定するソースを作成する前に、どちらが分割払いの利子を負担するかを設定します。この設定は管理画面で設定できます。分割支払の方法は、ソースの種類として実装されています。上記リストにtypeおよびinstallment_termパラメーターの有効値が記されています。installment_termの有効な値は、総額と月々の最低支払い額(amount)によって異なることにご留意ください。新しいソースの作成コードは以下の通りです。OMISE_PUBLIC_KEY環境変数をご自身のパブリックキー(公開鍵)が含まれるように設定しておく必要があります。true}返されたソースオブジェクトは、zero_interest_installments属性に加えて、ソース作成時に渡されたパラメータを反映しています。上記の返されたオブジェクトのid属性の値を使用して、新しい請求用のソースパラメータの値として渡します。この課金には、課金承認のためにサイトを離れる顧客が含まれるため、パラメータreturn_uriも渡す必要があります。課金完了時に顧客がリダイレクトされるサイトのURLはこちらです。OMISE_SECRET_KEY環境変数を設定しておく必要があります。SOURCE_IDには上記のid属性の値を含める必要があります。利用してソースの作成と課金を行うことができます。こちらが、銀行が運営するWebページのURIで、顧客に課金の確認、および承認を依頼します。テストモードではURIにアクセスし、手動で課金を成功または失敗としてマークすることで、この一連の動作をシミュレートできます。ステータスを確認するWebhookを介した自動支払い課金が完了したときに通知を受け取るには、イベントAPIを使用します。設定が完了すると、分割払いの支払いが完了するたびに、イベントキーcharge.completeを含むリクエストが、設定済みのWebhookエンドポイントに送信されます。詳細はWebhooksをご覧ください。課金オブジェクトのステータスには、課金の失敗、期限切れ、保留、または成功という値を設定できます。課金が成功した場合、承認済みおよび支払済みの値はtrueとなります。課金状況が失敗または期限切れとなった場合は、状況の理由を、課金オブジェクトのfailure_codeおよびfailure_message属性からご確認ください。以下はfailure_codeの可能な値と詳細な説明です。アカウントの資金不足、もしくはクレジットカードの限度額が上限に達しています。支払いがキャンセルされました。決済の有効期限前にユーザーからの応答がありませんでした。支払い処理に失敗しました。課金APIで説明されているように、idを使用して取得することで、課金の任意の属性を確認できます。こちらはJSONフィルタツール、jqを使った例です。分割払い手数料の返金方法については、返金APIドキュメントをご参照ください。注:分割払いの手数料は全額払い戻しのみで、部分払い戻しには対応していません。本番モードでの取引でAPIを使用する前に、利用規約をご確認ください。利用を開始するにあたって必要なAPIのバージョンは2017-11-02以降です。更新に関するガイダンスについては、APIバージョンを参照してください。国際タイ日本シンガポール日本語English。