コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments
決済手段
支払いインターフェイス
決済シナリオ
店頭支払い
他の Stripe プロダクト

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

OXXO での支払いを受け付ける

メキシコで一般的な支払い方法である OXXO を受け付ける方法をご紹介します。

ページをコピー

注意

Stripe は、顧客の通貨、決済手段の制限、その他のパラメーターを評価して、決済手段オプションを自動的に提示します。決済を受け付けるの手順を使用して、Stripe ダッシュボードから決済手段を設定することをお勧めします。

引き続き、Checkout で顧客に提示する決済手段を手動で設定する場合は、このガイドを使用します。それ以外の場合は、ダッシュボードで決済手段を設定できるように、構築済みのシステムを更新してください。

OXXO は 1 回限りの使用の支払い方法であり、顧客が支払いを完了するには、追加の手順を実行する必要があります。顧客は、OXXO コンビニエンスストアで、生成された番号が記載された OXXO の支払いコードを提示し、現金で支払います。

互換性を判断する

OXXO での支払いに対応するには、Checkout セッションが次の条件をすべて満たしている必要があります。

  • すべてのラインアイテムの価格が、同じ通貨である必要があります。異なる通貨のラインアイテムが存在する場合は、通貨ごとに別の Checkout セッションを作成します。
  • 使用できるのは単一の項目だけです (継続的なサブスクリプションプランには対応していません)。

決済を受け付ける

注

このガイドを使用する前に、まず Checkout で決済を受け付けるための実装を構築します。

このガイドでは、OXXO を有効にする方法を紹介し、カード支払いを受け付ける場合と、OXXO を使用する場合の違いも説明します。

支払い方法として OXXO を有効にする

新しい Checkout Session (セッション) を作成する際は、以下を行う必要があります。

  1. oxxo を payment_method_types のリストに追加する
  2. すべての line_items が mxn 通貨を使用していることを確認します。
Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'oxxo'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    oxxo: {
      expires_after_days: 2
    }
  },
  line_items: [{
    price_data: {
      # To accept `oxxo`, all line items must have currency: mxn
      currency: 'mxn',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

支払い方法のその他のオプション

Session の支払い方法オプションでオプションの expires_after_days パラメーターを指定すると、OXXO 支払いの有効期限が切れるまでの日数を設定できます。たとえば、月曜日に OXXO の取引の詳細を作成し、expires_after_days を 2 に設定した場合、OXXO の支払いは、America/Mexico_City (UTC-6) 時間で水曜日の 23:59 に有効期限が切れます。expires_after_days パラメーターは 1 日から 7 日までの範囲で設定できます。デフォルトは 3 日です。

Stripe がオンラインで提供する取引の詳細ページにリダイレクトする

Checkout フォームの送信に成功すると、顧客は hosted_voucher_url にリダイレクトされます。顧客はオンラインで提供される取引の詳細ページからバーコードを見つけたり、OXXO を印刷したりできます。hosted_voucher_url はpayment_intent.next_action.oxxo_display_details にあります。

Stripe では、ブランディング設定 ページで顧客に表示される UI をカスタマイズすることができます。取引の詳細には、以下のブランド設定を適用できます。

  • アイコン: ブランド画像と公開ビジネス名
  • アクセント: 印刷ボタンの色として使用されます
  • ブランドカラー: 背景色として使用されます

注文のフルフィルメントを実行する

OXXO は通知遅延型の支払い方法であるため、Webhook などの方法を使用して支払いステータスを監視し、注文のフルフィルメントを履行する必要があります。Webhook の設定と注文のフルフィルメントの履行で詳細をご覧ください。

支払いステータスに変化があると、以下のイベントが送信されます。

イベント名説明次のステップ

checkout.session.completed

顧客が Checkout フォームの送信を完了しました。Stripe は OXXO 支払い向けに取引の詳細を作成しました。

顧客が OXXO の支払いコードを失くした場合、顧客に hosted_voucher_url をメールで送信することもできます。

顧客が OXXO で支払うのを待ちます。

checkout.session.async_payment_succeeded顧客は OXXO の支払いを完了しました。PaymentIntent は succeeded に変わります。顧客が購入した商品またはサービスのフルフィルメントを行います。
checkout.session.async_payment_failedOXXO の支払いコードの有効期限が切れたか、その他の理由で支払いが失敗しました。PaymentIntent のステータスは requires_payment_method に戻ります。Contact the customer through email and request that they place a new order.

導入をテストする

Checkout の組み込みをテストする際は、支払い方法として OXXO を選択して、支払うボタンをクリックします。

メールアドレス説明

{any_prefix}@{any_domain}

顧客が 3 分後に支払い、約 3 分後に payment_intent.succeeded Webhook を受信する OXXO 支払いをシミュレーションします。本番環境では、この Webhook は 1 営業日後に受信します。

例: fulano@test.com

{any_prefix}succeed_immediately@{any_domain}

顧客が即座に支払う OXXO をシミュレーションし、payment_intent.succeeded Webhook を数秒以内に受信します。本番環境では、この Webhook は 1 営業日後に受信します。

例: succeed_immediately@test.com

{any_prefix}expire_immediately@{any_domain}

顧客が支払う前に期限切れになり、payment_intent.payment_failed Webhook を数秒以内に受信する OXXO をシミュレーションします。

支払い方法オプションで expires_after_days パラメーターに設定された値に関係なく、next_action.oxxo_display_details の expires_after フィールドには、現在時刻が設定されます。

例: expire_immediately@test.com

{any_prefix}expire_with_delay@{any_domain}

顧客が支払う前に期限切れになり、payment_intent.payment_failed Webhook を約 3 分後に受信する OXXO をシミュレーションします。

支払い方法オプションで expires_after_days パラメーターに設定された値に関係なく、next_action.oxxo_display_details の expires_after フィールドが 3 分後に設定されます。

例: expire_with_delay@test.com

{any_prefix}fill_never@{any_domain}

顧客が支払う前に期限切れになり、payment_intent.payment_failed Webhook を 1 営業日と 2 日後に受信する OXXO をシミュレーションします。本番環境では、この Webhook をテスト環境と同じタイミングで受信します。

例: fill_never@test.com

参照情報

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか？llms.txt を読んでください。
Powered by Markdoc