For agents and their developers
Shop here with any AI agent
Add https://agentic.payments-playground.com/mcp as a remote MCP connector in your assistant. It asks you to sign in here, you choose the scopes and a spend limit, and it can then search, build a checkout and pay with your saved card.
Endpoints
- Authorization server
- https://agentic.payments-playground.com/.well-known/oauth-authorization-server
How a purchase works
- Sign in: OAuth 2 authorization code with PKCE S256. PAP clients use a client metadata document as client_id and private_key_jwt; other MCP clients can register at /oauth/register.
- Search with search_catalog and pick variant ids (colour and size).
- create_checkout with line items. The store prices everything; amounts are EUR minor units.
- If the status is ready_for_complete, call complete_checkout with the instrument from checkout.payment.instruments. The merchant charges the saved card on Adyen TEST (ContAuth, UnscheduledCardOnFile).
- If the status is requires_escalation, give the shopper continue_url: they review and pay with Drop-in.
Payment handler saved_card
Declared under com.payments-playground.saved_card in the UCP profile. Instruments are aliases of the card the shopper saved with Adyen (shopper reference ogaccountnew); the raw Adyen token never leaves the merchant. It needs the ucp:pay scope and a total within the grant's remaining spend limit. Adyen's own UCP tokenizer can replace it once the account has the role.
Scopes
- ucp:checkout create and update checkouts (changes)
- ucp:pay pay with the saved card within the spend limit (changes)
- ucp:orders read orders (personal data)
- profile name and email (personal data)