Payment Manager 및 커넥터 생성

1단계: 결제 페이지 열기

2단계: Payment Manager 세부 정보 구성

3단계: 권한 구성

권한 섹션에서는이 Payment Manager에 대한 권한과 결제에서 액세스할 수 있는 AWS 리소스를 지정합니다.

IAM 권한에서 다음 옵션 중 하나를 선택합니다.

4단계: 인바운드 권한 부여 구성

인바운드 권한 부여는이 Payment Manager에 액세스할 수 있는 사용자를 제어합니다. 인바운드 인증 섹션의 인바운드 인증 유형에서 다음 옵션 중 하나를 선택합니다.

IAM 권한 부여를 사용하려면:

Amazon Cognito에서 JWT 권한 부여를 사용하려면:

기존 자격 증명 공급자에서 JWT 권한 부여를 사용하려면:

5단계: 결제 커넥터 추가(선택 사항)

결제 커넥터는 결제 서비스 공급자와 연결하는 데 필요한 자격 증명과 구성을 저장합니다. 생성 중에 커넥터를 추가하는 것은 선택 사항이지만 서비스가 결제를 처리하려면 커넥터가 필요합니다.

결제 인증 생성

커넥터의 결제 인증 섹션에서 새 결제 인증 생성을 선택하면 결제 인증 생성 패널이 열립니다. 이 패널에서는 AgentCore 자격 증명에 저장된 결제 자격 증명 공급자  인 새 결제 인증을 구성합니다.

Coinbase를 선택하는 경우 결제 인증에 대한 자격 증명을 제공하는 방법을 선택합니다.

빠른 생성 사용

빠른 구성 생성을 선택하면 Coinbase를 통해 액세스 권한을 부여한 후 AgentCore 결제가 결제 인증을 생성합니다. 다음 단계를 완료합니다.

기존 구성 사용

기존 구성 사용을 선택한 경우 결제 공급자 구성에서 다음 필드를 작성한 다음 결제 인증 생성을 선택합니다.

Stripe(Privy)를 선택한 경우 결제 공급자 구성에서 다음 필드를 입력한 다음 결제 인증 생성을 선택합니다.

6단계: Payment Manager 생성

Payment Manager 생성을 선택하면 콘솔이 Payment Manager 세부 정보 페이지로 이동합니다. 성공 배너는 Payment Manager가 생성되었음을 확인하고 다음 단계를 제공합니다.

Payment Manager 세부 정보 페이지에는 결제 커넥터, 통합 코드 템플릿, 인바운드 인증, 관찰성 지표, 로그 전송 및 추적 구성에 대한 섹션이 포함되어 있습니다.

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

Stripe(프라이비) - 수동 흐름(비대화형):

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 자격 증명에 자격 증명을 저장하고, Payment Manager 및 Connector를 생성합니다.

AgentCore SDK는 Coinbase 빠른 생성(먼저 표시됨) 및 수동 프로비저닝을 지원합니다. 다음 수동 예제는 공급자 자격 증명을 직접 전달합니다. 한 번의 호출로 Payment Managercreate_payment_manager_with_connector, 자격 증명 공급자 및 커넥터를 생성하는 편의 메서드를 사용합니다.

Coinbase - 빠른 생성(권장):

빠른 생성을 사용하면 빈 credential_provider_configurations 목록과를 사용하여 커넥터를 생성합니다provision_mode="QUICK_CREATE". 커넥터는 상태와 권한 부여 URLPENDING_AUTHENTICATION을 반환합니다. 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

프로비저닝이 READY 완료되면 Payment Manager 상태가 로 시작CREATING되고 로 전환됩니다.

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>"
)