Payment Manager とコネクタを作成する

ステップ 1: 支払いページを開く

ステップ 2: Payment Manager の詳細を設定する

ステップ 3: アクセス許可を設定する

アクセス許可セクションでは、この Payment Manager のアクセス許可と、支払いがアクセスできる AWS リソースを指定します。

IAM アクセス許可 では、次のいずれかのオプションを選択します。

ステップ 4: インバウンド認可を設定する

インバウンド認可は、この Payment Manager にアクセスできるユーザーを制御します。Inbound Auth セクションの Inbound Auth タイプで、次のいずれかのオプションを選択します。

IAM 認可を使用するには:

Amazon Cognito で JWT 認可を使用するには:

既存の ID プロバイダーで JWT 認可を使用するには:

ステップ 5: 支払いコネクタを追加する (オプション)

Payment Connector は、支払いサービスプロバイダーとの接続に必要な認証情報と設定を保存します。作成時にコネクタを追加することはオプションですが、サービスが支払いを処理するにはコネクタが必要です。

支払い認証を作成する

コネクタの Payment auth セクションで新しいものを作成すると、Create payment auth パネルが開きます。このパネルでは、新しい支払い認証を設定します 。 これは AgentCore Identity に保存されている支払い認証情報プロバイダーです。

Coinbase を選択した場合は、支払い認証の認証情報を指定する方法を選択します。

クイック作成を使用する

クイック作成設定 - 推奨を選択すると、Coinbase を介したアクセスを許可した後に AgentCore 支払いによって支払い認証が作成されます。以下のステップを実行します。

既存の設定を使用する

既存の設定を使用する を選択した場合は、「支払いプロバイダー設定」の次のフィールドに入力し、「支払い認証の作成」を選択します。

Stripe (Privy) を選択した場合は、「支払いプロバイダー設定」の次のフィールドに入力し、「支払い認証の作成」を選択します。

ステップ 6: Payment Manager を作成する

Payment Manager の作成を選択すると、コンソールは Payment Manager の詳細ページに移動します。成功バナーは Payment Manager が作成されたことを確認し、次のステップを提供します。

Payment Manager の詳細ページには、 Payment コネクタ、統合コードテンプレート、インバウンド認証、オブザーバビリティメトリクス、ログ配信とトレース設定のセクションが含まれています。

AgentCore CLI は、プロジェクトディレクトリから認証情報プロバイダー、 Payment Manager、 Payment Connector を一緒に作成します。CLI v0.19.0 以降が必要です。

インタラクティブウィザード:

agentcore add payment-manager

ウィザードは、マネージャー名、パターン、自動支払いトグル、使用制限をプロンプトし、オプションでプロバイダー認証情報を含むコネクタを追加する手順を説明します。

Coinbase — クイック作成 (推奨):

クイック作成は Coinbase 認証情報プロバイダーをプロビジョニングするため、API キーを渡しません。コネクタに --provision-mode QUICK_CREATEフラグを追加し、以下をデプロイします。

agentcore add payment-connector \
  --manager MyPaymentManager \
  --name CoinbaseConnector \
  --provider CoinbaseCDP \
  --provision-mode QUICK_CREATE

agentcore deploy

CLI は Coinbase 認可フローを開きます。認可すると、サービスは認証情報をプロビジョニングし、コネクタは に到達しますREADY。

Coinbase CDP — 手動フロー (非インタラクティブ):

agentcore add payment-manager \
  --name MyPaymentManager \
  --auto-payment \
  --default-spend-limit 10.00

agentcore add payment-connector \
  --manager MyPaymentManager \
  --name CoinbaseConnector \
  --provider CoinbaseCDP \
  --api-key-id <YOUR_API_KEY_ID> \
  --api-key-secret <YOUR_API_KEY_SECRET> \
  --wallet-secret <YOUR_WALLET_SECRET>

agentcore deploy

ストライプ (プライベート） — 手動フロー (非インタラクティブ):

agentcore add payment-manager \
  --name MyPaymentManager \
  --auto-payment \
  --default-spend-limit 10.00

agentcore add payment-connector \
  --manager MyPaymentManager \
  --name StripePrivyConnector \
  --provider StripePrivy \
  --app-id <YOUR_APP_ID> \
  --app-secret <YOUR_APP_SECRET> \
  --authorization-id <YOUR_AUTHORIZATION_ID> \
  --authorization-private-key <YOUR_PRIVATE_KEY_BASE64>

agentcore deploy

を実行すると、IAM ロールがagentcore deployプロビジョニングされ、認証情報が AgentCore Identity に保存され、 Payment Manager と Connector が作成されます。

AgentCore SDK は、Coinbase クイック作成 (最初に表示) と手動プロビジョニングをサポートしています。プロバイダーの認証情報を直接渡す手動の例。便利な方法 を使用してcreate_payment_manager_with_connector、1 回の呼び出しで Payment Manager、認証情報プロバイダー、コネクタを作成します。

Coinbase — クイック作成 (推奨):

クイック作成では、空のcredential_provider_configurationsリストと を使用してコネクタを作成しますprovision_mode="QUICK_CREATE"。コネクタはステータスPENDING_AUTHENTICATIONと認可 URL を返します。Coinbase を通じて を承認すると、サービスは認証情報プロバイダーをプロビジョニングし、コネクタは に到達しますREADY。

import time
import webbrowser

from bedrock_agentcore.payments.client import PaymentClient

payment_client = PaymentClient(region_name="us-east-1")

connector = payment_client.create_payment_connector(
    payment_manager_id="<paymentManagerId>",
    name="CoinbaseConnector",
    connector_type="CoinbaseCDP",
    credential_provider_configurations=[],
    provision_mode="QUICK_CREATE",
)

# Authorize through Coinbase using the returned URL.
webbrowser.open(connector["authorizationUrl"])

# Terminal states that mean provisioning did not succeed.
TERMINAL_FAILURES = {
    "AUTHENTICATION_EXPIRED",
    "AUTHENTICATION_FAILED",
    "AWS_MARKETPLACE_SUBSCRIPTION_REQUIRED",
    "CREATE_FAILED",
}

# Poll until the connector reaches READY or fails.
while True:
    response = payment_client.get_payment_connector(
        payment_connector_id=connector["paymentConnectorId"]
    )
    status = response["status"]
    if status == "READY":
        break
    if status in TERMINAL_FAILURES:
        raise RuntimeError(f"Connector provisioning failed: {status}")
    time.sleep(5)

認可 URL は約 10 分間有効です。有効期限が切れると、コネクタは に移行AUTHENTICATION_EXPIREDし、再作成します。

IAM 認可を持つ Coinbase CDP:

from bedrock_agentcore.payments.client import PaymentClient

payment_client = PaymentClient(region_name="us-east-1")

response = payment_client.create_payment_manager_with_connector(
    payment_manager_name="MyPaymentManager",
    payment_manager_description="Payment manager for my agent.",
    authorizer_type="AWS_IAM",
    role_arn="arn:aws:iam::123456789012:role/MyPaymentRole",
    payment_connector_config={
        "name": "CoinbaseConnector",
        "description": "Coinbase CDP connector",
        "payment_credential_provider_config": {
            "name": "MyCoinbaseProvider",
            "credential_provider_vendor": "CoinbaseCDP",
            "credentials": {
                "api_key_id": "your-api-key-id",
                "api_key_secret": "your-api-key-secret",
                "wallet_secret": "your-wallet-secret",
            },
        },
    },
    wait_for_ready=True,
    max_wait=300,
    poll_interval=5,
)

payment_manager = response.get("paymentManager", {})
payment_connector = response.get("paymentConnector", {})
credential_provider = response.get("credentialProvider", {})

payment_manager_arn = payment_manager.get("paymentManagerArn")
payment_connector_id = payment_connector.get("paymentConnectorId")

print(f"Payment Manager ARN: {payment_manager_arn}")
print(f"Connector ID: {payment_connector_id}")

JWT 認可の Coinbase CDP:

from bedrock_agentcore.payments.client import PaymentClient

payment_client = PaymentClient(region_name="us-east-1")

response = payment_client.create_payment_manager_with_connector(
    payment_manager_name="CoinbasePaymentManagerJWT",
    payment_manager_description="Coinbase Payment Manager (JWT auth)",
    authorizer_type="CUSTOM_JWT",
    role_arn="arn:aws:iam::123456789012:role/BedrockAgentCoreFullAccess",
    payment_connector_config={
        "name": "coinbase-connector-jwt",
        "description": "Coinbase Connector (JWT)",
        "payment_credential_provider_config": {
            "name": "my-coinbase-provider-jwt",
            "credential_provider_vendor": "CoinbaseCDP",
            "credentials": {
                "api_key_id": "your-api-key-id",
                "api_key_secret": "your-api-key-secret",
                "wallet_secret": "your-wallet-secret",
            },
        },
    },
    wait_for_ready=True,
)

manager_arn = response["paymentManager"]["paymentManagerArn"]
connector_id = response["paymentConnector"]["paymentConnectorId"]
provider_arn = response["credentialProvider"]["credentialProviderArn"]

IAM 認可による Stripe (Privy):

from bedrock_agentcore.payments.client import PaymentClient

payment_client = PaymentClient(region_name="us-east-1")

response = payment_client.create_payment_manager_with_connector(
    payment_manager_name="StripePaymentManager",
    payment_manager_description="Stripe + Privy Payment Manager (IAM auth)",
    authorizer_type="AWS_IAM",
    role_arn="arn:aws:iam::123456789012:role/BedrockAgentCoreFullAccess",
    payment_connector_config={
        "name": "stripe-privy-connector",
        "description": "Stripe + Privy Connector",
        "payment_credential_provider_config": {
            "name": "my-stripe-privy-provider",
            "credential_provider_vendor": "StripePrivy",
            "credentials": {
                "app_id": "your-privy-app-id",
                "app_secret": "your-privy-app-secret",
                "authorization_private_key": "your-authorization-private-key",
                "authorization_id": "your-authorization-id",
            },
        },
    },
    wait_for_ready=True,
)

manager_arn = response["paymentManager"]["paymentManagerArn"]
connector_id = response["paymentConnector"]["paymentConnectorId"]
provider_arn = response["credentialProvider"]["credentialProviderArn"]

JWT 認可によるストライプ (プライベート):

from bedrock_agentcore.payments.client import PaymentClient

payment_client = PaymentClient(region_name="us-east-1")

response = payment_client.create_payment_manager_with_connector(
    payment_manager_name="StripePaymentManagerJWT",
    payment_manager_description="Stripe + Privy Payment Manager (JWT auth)",
    authorizer_type="CUSTOM_JWT",
    role_arn="arn:aws:iam::123456789012:role/BedrockAgentCoreFullAccess",
    payment_connector_config={
        "name": "stripe-privy-connector-jwt",
        "description": "Stripe + Privy Connector (JWT)",
        "payment_credential_provider_config": {
            "name": "my-stripe-privy-provider-jwt",
            "credential_provider_vendor": "StripePrivy",
            "credentials": {
                "app_id": "your-privy-app-id",
                "app_secret": "your-privy-app-secret",
                "authorization_private_key": "your-authorization-private-key",
                "authorization_id": "your-authorization-id",
            },
        },
    },
    wait_for_ready=True,
)

manager_arn = response["paymentManager"]["paymentManagerArn"]
connector_id = response["paymentConnector"]["paymentConnectorId"]
provider_arn = response["credentialProvider"]["credentialProviderArn"]

IAM 認可を持つ Payment Manager を作成します。

aws bedrock-agentcore-control create-payment-manager \
  --name "MyPaymentManager" \
  --authorizer-type AWS_IAM \
  --role-arn "arn:aws:iam::123456789012:role/AgentCorePaymentsResourceRetrievalRole" \
  --region us-east-1

JWT 認可を使用して Payment Manager を作成します。

aws bedrock-agentcore-control create-payment-manager \
  --name "MyPaymentManager" \
  --authorizer-type CUSTOM_JWT \
  --role-arn "arn:aws:iam::123456789012:role/AgentCorePaymentsResourceRetrievalRole" \
  --custom-jwt-authorizer-configuration '{
    "discoveryUrl": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_EXAMPLE/.well-known/openid-configuration",
    "allowedAudience": ["your-client-id"],
    "allowedClients": ["your-client-id"]
  }' \
  --region us-east-1

Payment Manager のステータスは として始まりCREATING、READYプロビジョニングが完了すると に移行します。

Coinbase — クイック作成 (推奨):

クイック作成では、空の credential-provider-configurations リストと を使用してコネクタを作成します--provision-mode QUICK_CREATE。認証情報プロバイダーは最初に作成しません。

aws bedrock-agentcore-control create-payment-connector \
  --payment-manager-id <paymentManagerId> \
  --name "CoinbaseConnector" \
  --type CoinbaseCDP \
  --credential-provider-configurations '[]' \
  --provision-mode QUICK_CREATE \
  --region us-east-1

レスポンスにはステータスPENDING_AUTHENTICATIONと がありますauthorizationUrl。URL を開き、Coinbase を介して認可してから、ステータスが get-payment-connectorになるまでポーリングしますREADY。URL は約 10 分間有効です。有効期限が切れると、コネクタは に移行AUTHENTICATION_EXPIREDし、再作成します。

手動フロー: 手動フローでは、支払い認証情報プロバイダーを作成し、コネクタの作成時にその ARN を参照します。これは Stripe (Privy) の唯一のフローです。

Payment Manager の準備ができたら、支払い認証情報プロバイダーを作成します。

次の例では、Coinbase CDP の支払い認証情報プロバイダーを作成します。

aws bedrock-agentcore-control create-payment-credential-provider \
  --name "coinbase-provider" \
  --credential-provider-vendor CoinbaseCDP \
  --provider-configuration-input '{
    "coinbaseCdpConfiguration": {
      "apiKeyId": "your-coinbase-api-key-id",
      "apiKeySecret": "your-coinbase-api-key-secret",
      "walletSecret": "your-coinbase-wallet-secret"
    }
  }' \
  --region us-east-1

次の例では、Stripe Privy の支払い認証情報プロバイダーを作成します。

aws bedrock-agentcore-control create-payment-credential-provider \
  --name "stripe-privy-provider" \
  --credential-provider-vendor StripePrivy \
  --provider-configuration-input '{
    "stripePrivyConfiguration": {
      "appId": "your-stripe-privy-app-id",
      "appSecret": "your-stripe-privy-app-secret",
      "authorizationPrivateKey": "your-stripe-privy-authorization-private-key",
      "authorizationId": "your-stripe-privy-authorization-id"
    }
  }' \
  --region us-east-1

認証情報プロバイダーの準備ができたら、コネクタを作成します。

aws bedrock-agentcore-control create-payment-connector \
  --payment-manager-id <paymentManagerId> \
  --name "CoinbaseConnector" \
  --type CoinbaseCDP \
  --credential-provider-configurations '[{
    "coinbaseCDP": {
      "credentialProviderArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:token-vault/default/paymentcredentialprovider/my-cdp-provider"
    }
  }]' \
  --region us-east-1

IAM 認可を持つ Payment Manager を作成します。

import boto3

client = boto3.client("bedrock-agentcore-control", region_name="us-east-1")

# Create PaymentManager with IAM authorization
payment_manager = client.create_payment_manager(
    name="MyPaymentManager",
    authorizerType="AWS_IAM",
    roleArn="arn:aws:iam::123456789012:role/AgentCorePaymentsResourceRetrievalRole"
)

print(f"Payment Manager ID: {payment_manager['paymentManagerId']}")

JWT 認可を使用して Payment Manager を作成します。

payment_manager = client.create_payment_manager(
    name="MyPaymentManager",
    authorizerType="CUSTOM_JWT",
    roleArn="arn:aws:iam::123456789012:role/AgentCorePaymentsResourceRetrievalRole",
    customJWTAuthorizerConfiguration={
        "discoveryUrl": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_EXAMPLE/.well-known/openid-configuration",
        "allowedAudience": ["your-client-id"],
        "allowedClients": ["your-client-id"],
        "allowedScopes": ["payments:write"],
        "customClaims": [
            {
                "claimName": "tenant_id",
                "claimValue": "your-unique-tenant-id",
                "operation": "EQUALS"
            }
        ]
    }
)

Coinbase — クイック作成 (推奨):

クイック作成では、空のcredentialProviderConfigurationsリストと を使用してコネクタを作成しますprovisionMode="QUICK_CREATE"。認証情報プロバイダーは最初に作成しません。

# Create a Coinbase connector with Quick create
connector = client.create_payment_connector(
    paymentManagerId=payment_manager["paymentManagerId"],
    name="CoinbaseConnector",
    type="CoinbaseCDP",
    credentialProviderConfigurations=[],
    provisionMode="QUICK_CREATE"
)

print(f"Status: {connector['status']}")
print(f"Authorization URL: {connector.get('authorizationUrl')}")

コネクタはステータスPENDING_AUTHENTICATIONと を返しますauthorizationUrl。URL を開き、Coinbase を介して認可してから、ステータスが get_payment_connectorになるまでポーリングしますREADY。URL は約 10 分間有効です。有効期限が切れると、コネクタは に移行AUTHENTICATION_EXPIREDし、再作成します。

手動フロー: 手動フローでは、支払い認証情報プロバイダーを作成し、コネクタの作成時にその ARN を参照します。これは Stripe (Privy) の唯一のフローです。

Payment Manager READYのステータスに達したら、支払い認証情報プロバイダーを作成します。

次の例では、Coinbase CDP のプロバイダーを設定します。

import boto3

client = boto3.client("bedrock-agentcore-control", region_name="us-east-1")

coinbase_provider = client.create_payment_credential_provider(
    name="coinbase-provider",
    credentialProviderVendor="CoinbaseCDP",
    providerConfigurationInput={
        "coinbaseCdpConfiguration": {
            "apiKeyId": "your-coinbase-api-key-id",
            "apiKeySecret": "your-coinbase-api-key-secret",
            "walletSecret": "your-coinbase-wallet-secret"
        }
    }
)

次の例では、Stripe Privy のプロバイダーを設定します。

import boto3

client = boto3.client("bedrock-agentcore-control", region_name="us-east-1")

stripe_privy_provider = client.create_payment_credential_provider(
    name="stripe-privy-provider",
    credentialProviderVendor="StripePrivy",
    providerConfigurationInput={
        "stripePrivyConfiguration": {
            "appId": "your-stripe-privy-app-id",
            "appSecret": "your-stripe-privy-app-secret",
            "authorizationPrivateKey": "your-stripe-privy-authorization-private-key",
            "authorizationId": "your-stripe-privy-authorization-id"
        }
    }
)

支払い認証情報プロバイダーを作成したら、コネクタを作成します。

# Create PaymentConnector for Coinbase CDP
payment_connector = client.create_payment_connector(
    paymentManagerId=payment_manager["paymentManagerId"],
    name="CoinbaseConnector",
    type="CoinbaseCDP",
    credentialProviderConfigurations=[
        {
            "coinbaseCDP": {
                "credentialProviderArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:token-vault/default/paymentcredentialprovider/my-cdp-provider"
            }
        }
    ]
)

print(f"Connector ID: {payment_connector['paymentConnectorId']}")

Stripe (Privy) の場合は、stripePrivy設定バリアントを使用します。

# Create PaymentConnector for Stripe (Privy)
payment_connector = client.create_payment_connector(
    paymentManagerId=payment_manager["paymentManagerId"],
    name="StripePrivyConnector",
    type="StripePrivy",
    credentialProviderConfigurations=[
        {
            "stripePrivy": {
                "credentialProviderArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:token-vault/default/paymentcredentialprovider/my-privy-provider"
            }
        }
    ]
)

agentcore status

from bedrock_agentcore.payments.client import PaymentClient

payment_client = PaymentClient(region_name="us-east-1")
response = payment_client.get_payment_manager(
    payment_manager_id="<paymentManagerId>"
)
print(f"Status: {response['status']}")

aws bedrock-agentcore-control get-payment-manager \
  --payment-manager-id <paymentManagerId> \
  --region us-east-1

response = client.get_payment_manager(
    paymentManagerId="<paymentManagerId>"
)
print(f"Status: {response['status']}")

agentcore status

from bedrock_agentcore.payments.client import PaymentClient

payment_client = PaymentClient(region_name="us-east-1")
response = payment_client.list_payment_managers()
for pm in response['paymentManagers']:
    print(f"{pm['name']} - {pm['status']}")

aws bedrock-agentcore-control list-payment-managers \
  --region us-east-1

response = client.list_payment_managers()
for pm in response['paymentManagers']:
    print(f"{pm['name']} - {pm['status']}")

agentcore remove payment-connector --manager MyPaymentManager --name CoinbaseConnector --yes
agentcore remove payment-manager --name MyPaymentManager --yes
agentcore deploy

remove コマンドはローカル設定を更新します。フォローアップにより、アカウントの支払いインフラストラクチャがdeploy破棄されます。

from bedrock_agentcore.payments.client import PaymentClient

payment_client = PaymentClient(region_name="us-east-1")
payment_client.delete_payment_manager(
    payment_manager_id="<paymentManagerId>"
)

aws bedrock-agentcore-control delete-payment-manager \
  --payment-manager-id <paymentManagerId> \
  --region us-east-1

client.delete_payment_manager(
    paymentManagerId="<paymentManagerId>"
)