Skip to main content

​
PayPal

ShanoneのPayPal連携は、決済の全ライフサイクルをカバーする105個のツールをエージェントに提供します。注文・決済、請求書発行、サブスクリプション/課金プラン、紛争解決、ペイアウト、Webhook管理まで対応しています。

​
はじめに

1

OAuthで接続する

エージェントにPayPal関連の作業を依頼(例: 「今月の未払い請求書を一覧表示して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

PayPalアカウントを許可する

Shanoneに操作させたいビジネスアカウントについて、PayPalのOAuth同意画面を承認します。
3

リクエストを再実行する

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

​
利用可能なツール

ShanoneはPayPal向けに105個のツールを、以下のカテゴリに整理して提供しています。
paypal_create_order, paypal_get_order, paypal_authorize_order, paypal_capture_order, paypal_update_order, paypal_confirm_order, paypal_add_order_tracking, paypal_update_order_tracking, paypal_get_authorization, paypal_capture_authorization, paypal_void_authorization, paypal_get_capture, paypal_refund_capture, paypal_get_refund
paypal_create_draft_invoice, paypal_get_invoice, paypal_list_invoices, paypal_send_invoice, paypal_cancel_invoice, paypal_delete_invoice, paypal_record_payment_for_invoice, paypal_update_invoice, paypal_send_invoice_reminder, paypal_generate_invoice_number, paypal_search_invoices, paypal_generate_invoice_qr_code, paypal_record_refund_for_invoice, paypal_delete_invoice_external_payment, paypal_create_invoice_template, paypal_list_invoice_templates, paypal_get_invoice_template, paypal_update_invoice_template, paypal_delete_invoice_template
paypal_create_plan, paypal_get_plan, paypal_list_plans, paypal_activate_plan, paypal_deactivate_plan, paypal_update_plan_pricing, paypal_update_plan, paypal_get_subscription, paypal_cancel_subscription, paypal_suspend_subscription, paypal_activate_subscription, paypal_list_subscription_transactions, paypal_update_subscription, paypal_revise_subscription, paypal_capture_subscription_payment
paypal_list_disputes, paypal_get_dispute, paypal_accept_dispute_claim, paypal_send_message_to_dispute, paypal_escalate_dispute, paypal_make_dispute_offer, paypal_provide_dispute_evidence, paypal_appeal_dispute, paypal_acknowledge_dispute_return_item, paypal_accept_dispute_offer, paypal_deny_dispute_offer, paypal_provide_dispute_supporting_info
paypal_create_payout, paypal_get_payout_batch, paypal_get_payout_item, paypal_cancel_payout_item, paypal_create_referenced_payout, paypal_get_referenced_payout, paypal_get_referenced_payout_item, paypal_add_tracking, paypal_update_tracking, paypal_get_tracking, paypal_batch_add_tracking, paypal_list_tracking
paypal_create_product, paypal_get_product, paypal_list_products, paypal_update_product, paypal_create_web_profile, paypal_get_web_profile, paypal_list_web_profiles, paypal_update_web_profile, paypal_patch_web_profile, paypal_delete_web_profile
paypal_list_webhooks, paypal_create_webhook, paypal_delete_webhook, paypal_list_available_events, paypal_verify_webhook_signature, paypal_get_webhook, paypal_update_webhook, paypal_simulate_webhook_event, paypal_list_webhook_events, paypal_get_webhook_event, paypal_resend_webhook_event
paypal_list_transactions, paypal_get_balance, paypal_search_transactions, paypal_get_transaction_details, paypal_list_all_balances, paypal_create_setup_token, paypal_get_setup_token, paypal_create_payment_token, paypal_list_payment_tokens, paypal_get_payment_token, paypal_delete_payment_token, paypal_get_userinfo

​
よくあるユースケース

請求書のフォローアップ

未払いの請求書を見つけ、期限を過ぎる前にリマインダーを送る

サブスクリプション管理

顧客のサブスクリプション状況を確認し、プランの一時停止・キャンセル・変更を行う

紛争への対応

未解決の紛争を取得し、必要な証拠を集めて期限内に回答を提出する

ペイアウトの自動化

複数の受取人へのペイアウトをバッチで作成し、バッチの状態を確認する

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

paypal_capture_orderが成功するには、購入者がPayPalの承認フローを完了している必要があります。まずpaypal_get_orderで注文の現在の状態を確認してください。
WebhookのURLが外部からアクセス可能であること、そしてpaypal_list_available_eventsに登録したいイベントタイプが含まれていることを確認してください。paypal_simulate_webhook_eventでエンドポイントを直接テストすることもできます。
shanone_get_tool_schemaで正確な証拠ペイロードの形式を確認してください——PayPalは自由記述のテキストや任意の添付ファイルではなく、特定の証拠タイプ(例: PROOF_OF_FULFILLMENT)を要求します。