コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する
対面決済
決済手段
決済シナリオ
決済以外の機能

メモ

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

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

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

注意

Stripe は、通貨、支払い方法の制限、その他のパラメーターを評価することで、適切な支払い方法を顧客に自動的に提示できます。

  • 決済の受け付けガイドに従って、動的な決済手段を使用するチェックアウトの導入を構築します。
  • 動的な決済手段を使用しない場合は、チェックアウトの導入で、決済方法を手動で設定するために以下のステップに従ってください。

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

互換性を判断する

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

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

決済を受け付ける

メモ

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

このガイドでは、OXXO を有効にする方法について手順を追って説明し、動的な支払い方法を使用して決済を受け付ける場合と支払い方法を手動で設定する場合の違いを示します。

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

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

  1. oxxo を payment_method_types のリストに追加します。
  2. すべての line_items が mxn 通貨を使用していることを確認します。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=mxn \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=oxxo \
  --data-urlencode success_url="https://example.com/success"

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

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=mxn \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_options[oxxo][expires_after_days]"=2 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=oxxo \
  --data-urlencode success_url="https://example.com/success"

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 に戻ります。顧客にメールで連絡して、新たに注文を行うようリクエストします。

導入をテストする

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

オプション決済手順メールを送信する

ダッシュボードのメール設定ページで OXXO 決済の手順メールを有効にできます。有効にすると、Stripe は、PaymentIntent の確定時に決済手順メールを送信します。メールには、OXXO 番号と Stripe の店舗支払いページへのリンクが含まれます。

メモ

テスト環境では、手順メールは Stripe アカウントに関連付けられたメールアドレスにのみ送信されます。

参照情報