Skip to main content

​
Stripe

ShanoneのStripe連携は、エージェントに328個のツールを提供します——カタログ中で最大の単一連携であり、基本的な課金処理からStripe TreasuryやIssuingまで幅広くカバーします。
Stripeのツールの多くは実際のお金を動かしたり、実際の金融レコードを作成したりします。読み取り専用のクエリ以外をエージェントに実行させる前には引数を必ず確認し、エージェントに本当に必要な範囲だけに絞った制限付きのAPIキーを接続することも検討してください。

​
はじめに

1

Stripeアカウントを接続する

エージェントにStripe関連の作業を依頼するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

テストモードかライブモードかを選ぶ

Stripeはテスト用とライブ用のAPIキーを、どちらのキーを接続したかだけで区別します——エージェントのワークフローを構築・検証している間はテストモードのキーを接続してください。
3

リクエストを再実行する

接続が完了すると、stripe_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはStripe向けに328個のツールを提供しています——群を抜いて最大の連携です。慣れないStripeツールを実行する前には必ずshanone_get_tool_schemaを使ってください。フィールド名はStripe APIに厳密に準拠しており、書き込み操作で間違えた場合のコストは他の連携より大きくなります。
stripe_create_customer, stripe_get_customer, stripe_update_customer, stripe_list_customers, stripe_search_customers, stripe_create_payment_intent, stripe_confirm_payment_intent, stripe_capture_payment_intent, stripe_cancel_payment_intent, stripe_get_payment_intent, stripe_list_payment_intents, stripe_create_checkout_session, stripe_get_checkout_session, stripe_list_checkout_sessions, stripe_expire_checkout_session, stripe_create_payment_link, stripe_update_payment_link
stripe_capture_charge, stripe_update_charge, stripe_get_charge, stripe_list_charges, stripe_search_charges, stripe_create_refund, stripe_update_refund, stripe_cancel_refund, stripe_get_refund, stripe_list_refunds
stripe_create_subscription, stripe_update_subscription, stripe_cancel_subscription, stripe_pause_subscription, stripe_resume_subscription, stripe_get_subscription, stripe_list_subscriptions, stripe_create_subscription_item, stripe_delete_subscription_item, stripe_create_invoice, stripe_send_invoice, stripe_void_invoice, stripe_get_invoice, stripe_list_invoices, stripe_create_invoice_item, stripe_delete_invoice_item, stripe_create_credit_note, stripe_void_credit_note
stripe_create_product, stripe_update_product, stripe_delete_product, stripe_list_products, stripe_search_products, stripe_create_price, stripe_update_price, stripe_list_prices, stripe_create_coupon, stripe_update_coupon, stripe_delete_coupon, stripe_list_coupons, stripe_create_promotion_code, stripe_list_promotion_codes, stripe_create_quote, stripe_finalize_quote, stripe_accept_quote
stripe_create_account, stripe_get_account, stripe_update_account, stripe_delete_account, stripe_list_accounts, stripe_create_account_link, stripe_create_account_session, stripe_create_transfer, stripe_get_transfer, stripe_list_transfers, stripe_create_transfer_reversal, stripe_create_payout, stripe_get_payout, stripe_list_payouts, stripe_create_application_fee_refund
stripe_get_dispute, stripe_update_dispute, stripe_close_dispute, stripe_list_disputes, stripe_get_review, stripe_approve_review, stripe_list_reviews, stripe_get_radar_early_fraud_warning, stripe_list_radar_early_fraud_warnings
stripe_create_tax_calculation, stripe_create_tax_id, stripe_delete_tax_id, stripe_create_tax_rate, stripe_update_tax_rate, stripe_create_identity_verification_session, stripe_get_identity_verification_session, stripe_create_file, stripe_create_file_link, stripe_list_files
stripe_create_billing_meter, stripe_update_billing_meter, stripe_deactivate_billing_meter, stripe_reactivate_billing_meter, stripe_create_meter_event, stripe_create_meter_event_adjustment, stripe_list_meter_event_summaries, stripe_create_billing_alert, stripe_activate_billing_alert, stripe_archive_billing_alert
stripe_create_issuing_card, stripe_update_issuing_card, stripe_create_issuing_cardholder, stripe_get_issuing_authorization, stripe_approve_issuing_authorization, stripe_decline_issuing_authorization, stripe_create_issuing_dispute, stripe_submit_issuing_dispute, stripe_create_treasury_financial_account, stripe_create_treasury_outbound_payment, stripe_create_treasury_outbound_transfer, stripe_create_treasury_inbound_transfer
stripe_create_terminal_reader, stripe_create_terminal_location, stripe_create_terminal_configuration, stripe_process_terminal_payment_intent, stripe_process_terminal_setup_intent, stripe_collect_terminal_inputs, stripe_set_terminal_reader_display, stripe_create_terminal_hardware_order
stripe_create_webhook_endpoint, stripe_update_webhook_endpoint, stripe_delete_webhook_endpoint, stripe_list_webhook_endpoints, stripe_test_webhook_endpoint, stripe_get_event, stripe_list_events

​
よくあるユースケース

収益の照合

直近のチャージ・支払いを取得し、別の台帳と突き合わせる

サブスクリプションのライフサイクル管理

サポート業務からサブスクリプションを作成・一時停止・再開・解約する

紛争のトリアージ

未対応の紛争と証拠提出期限を要約する

使用量ベースの請求

メーターイベントを報告し、使用量サマリーを確認する

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

ダッシュボードで見ているのがテストモードかライブモードかを確認してください——接続しているAPIキーのモードと一致している必要があります。
リスクの高いStripeツール(例: Issuingカードの操作、大口の返金)はreason: "confirmation_required"を返す場合があります。内容に問題がないことを確認してから、同じ引数に"confirm": trueを加えて再実行してください。
StripeのIDはモードごとに異なります——テストモードで作成されたcus_...やpi_...のIDはライブモードには存在せず、逆も同様です。