メインコンテンツへスキップ
Pixはブラジル中央銀行（Banco Central do Brasil）が作成したブラジルの即時決済システムです。週末や祝日を含む24時間リアルタイムでの振込を可能にし、ブラジルで最も人気のある支払い方法となっています。

​
Pixを提供する理由

Dominant in Brazil

Pixはブラジルで最も使用されている支払い方法であり、クレジットカードやボレートを超えています。

Instant Settlement

支払いは数秒で確認され、24/7/365銀行の処理待ち時間はありません。

Low Friction

顧客はQRコードやコピーペーストキーで支払います—カード番号や銀行口座情報は不要です。

​
概要

詳細値
請求通貨BRL
対応国ブラジル
サブスクリプションいいえ
最低額$0.50
決済即時

​
仕組み

​
顧客体験

  1. 顧客がチェックアウト時にPixを選択
  2. QRコードとコピーペーストキーが表示される
  3. 顧客は銀行アプリを開き、QRコードをスキャンするかキーを貼り付ける
  4. 支払いが即時に確認される
  5. 顧客は成功ページにリダイレクトされる
Pix QRコードは通常、設定された期間後に期限切れになります。顧客が支払いを完了しない場合、チェックアウトを再開する必要があります。

​
設定

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['pix', 'credit', 'debit'],
  billing_currency: 'BRL',
  return_url: 'https://example.com/success'
});

​
APIメソッドタイプ

タイプメソッド国
pixPixブラジル

​
テスト

1

Enable test mode

ご自分のDodo PaymentsテストAPIキーを使用してください。
2

Set billing currency to BRL

請求通貨をチェックアウトリクエストでBRLに設定してください。
3

Enter test CPF and scan the QR code

Pix CPFを求められたら、1234567890を入力します。テストQRコードが生成されます—通常の携帯カメラでスキャンしてください（Pixアプリは必要ありません）。Stripeのテストページにリダイレクトされ、トランザクションを成功または失敗としてシミュレートできます。

​
ベストプラクティス

PixはBRLでのみ機能します。ブラジル市場向けに、価格設定がブラジルレアルの取引をサポートしていることを確認してください。
すべてのブラジルの顧客がPixを好むわけではないかもしれません。常にインラインコードPLACEHOLDER_0a28ad3c4a720a34_ENDとインラインコードPLACEHOLDER_5bcf2e9635db1396_ENDを代替オプションとして含めます。
Pix QRコードは一定期間後に期限切れになります。お客様のチェックアウトで有効期限を上手に処理し、コードを再生成できるようにしてください。

​
トラブルシューティング

確認点:
  1. 請求通貨がBRLに設定されていますか？
  2. pixがallowed_payment_method_typesに含まれていますか？
  3. 顧客の請求国はブラジルですか？
解決策: PixはBRL取引でのみ利用可能です。APIリクエストでの通貨と請求住所を確認してください。
原因: 顧客が有効期限内に支払いを完了しませんでした。解決策: 顧客はチェックアウトを再開して新しいQRコードを生成する必要があります。
原因: Pixの支払いは通常即時に確認されますが、銀行側の遅延が時折発生することがあります。解決策: 支払い確認のためのWebhookを監視してください。支払いが数分以内に確認されない場合は、失敗として処理します。

​
関連ページ

Payment Methods Overview

サポートされているすべての支払い方法をご覧ください。

Adaptive Currency

通貨サポートと自動変換。

Checkout Guide

完全なチェックアウト実装ガイド。

Webhooks

非同期での支払い確認を扱います。
Last modified on April 1, 2026