← LinkedIn demo

AILANG×docs.adyen.com

AI agent-ready generated 2026-05-14

§1 · AI-readiness

agent-ready privacy portable

docs.adyen.com scored 4/10 on agent-ready.

The radar shows AILANG-readiness across three commercial concerns. High means docs.adyen.com is already strong there; low means AILANG could meaningfully help.

Why agent-ready scored 4/10
  • Page references /.well-known/agent.json — the A2A agent card discovery endpoint. Worth only 1pt: it's bleeding-edge (A2A protocol new in 2026), no commercial site has adopted it yet — keep it as a moonshot bonus, not a baseline expectation.
  • Page references /openapi.json, /openapi.yaml, or an OpenAPI schema URL.
  • Page references an MCP endpoint such as /mcp/ or /mcp/sse.
  • Page links to public API documentation, Swagger UI, or ReDoc.
  • Page mentions webhooks, callback URLs, or event subscriptions — the most agent-callable backend pattern.
  • Page documents rate limits, throttling, or 429 handling — agents need to know how to back off.
  • Page references Server-Sent Events, text/event-stream, or a streaming endpoint — agents that read incrementally land here.
  • Page mentions a sandbox, test mode, or test environment — lets agents practise against fake state before touching production.
  • Page documents OAuth, JWT, bearer tokens, API keys, or access tokens — agents can't call the API without knowing how to authenticate.
  • Page mentions idempotency, idempotency-key, or idempotent requests — agents need this to retry safely.
  • Page mentions AG-UI (Agent-User Interaction Protocol) — streams 16 typed lifecycle/text/tool/state events from agent backend to frontend over SSE or WebSocket.
  • Page mentions x402 (Coinbase's signed crypto payment payloads) or Cloudflare's pay-per-crawl (crawler-price header for AI-crawler monetisation). Both revive HTTP 402 for agents — Cloudflare joined the x402 Foundation, so they're one umbrella signal.
  • Page mentions AP2 (Agent Payments Protocol) — Google + Mastercard + 60 orgs. Cryptographically signed Mandates (Intent + Cart) authorise agents to spend on a user's behalf with price/timing/condition bounds.
  • Page mentions UTCP (Universal Tool Calling Protocol) — MCP alternative. Tools described in a JSON UTCPManual, called via their native protocols (HTTP/gRPC/CLI).

Full breakdown ↓ · View rubric ↗

§2 · what an AI sees on docs.adyen.com

Technical users and developers integrating with Adyen's payment processing platform, focusing on API usage and system integration.

This Adyen documentation provides resources for developers on integrating their payment platform. It covers API authentication, managing credentials, configuring and handling webhooks, and testing integrations. Detailed sections also explain batch processing for various payment and modification requests, along with understanding result files.
API credentials Webhooks Batch processing Payment integration Authentication types Test cards

What AILANG Parse sees on docs.adyen.com

Structural extraction — the same content an AI agent would consume from this page.

12 headings28 images19 lists1 tables106 linksHTML parsing by AILANG Parse

4 sections — page skeleton

2 navs 1 article 1 footer

12 headings

API credentials Requirements Multiple API credentials Create additional API credentials Generate an API key Generate a basic authentication password

28 images

19 list items

**Username**: An identifier in the format `ws_123456@Company.[YourCompanyAccount]`. **API key**: A password to authenticate API requests. **Roles**: Permissions that define what the credential is allowed to do. Create additional API credentials Generate an API key Configure API permissions by assigning specific roles to your credentials If you have both an online sales channel and a point-of-sale sales channel, we strongly r… If you are doing [unreferenced refunds](/online-payments/classic-integrations/modify-paym… If you have an ecommerce system and a shipping system, you can separate the permissions f… Go to **Developers** > **API credentials**. This opens a list with all API credentials l… Select **Create new credential**. In the **Create API credential** dialog, under **Credential type**, select **Web service …

106 links

API authentication types Roles Client-side authentication Migrate to client key Webhooks Configure and manage webhooks Handle webhook events Secure webhooks Verify HMAC signatures Webhook structure and types Additional settings Account settings webhooks
Show the full extract — what AILANG Parse pulled from this page
# API credentials | Adyen Docs


[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

[Image]

Development resources

[Overview](/development-resources)

Authentication

[API authentication types](/development-resources/api-authentication)

API credentials

[Roles](/development-resources/api-credentials/roles)

[Client-side authentication](/development-resources/client-side-authentication)

[Migrate to client key](/development-resources/client-side-authentication/migrate-from-origin-key-to-client-key)

Integration

[Webhooks](/development-resources/webhooks)

[Configure and manage webhooks](/development-resources/webhooks/configure-and-manage)

[Handle webhook events](/development-resources/webhooks/handle-webhook-events)

[Secure webhooks](/development-resources/webhooks/secure-webhooks)

[Verify HMAC signatures](/development-resources/webhooks/secure-webhooks/verify-hmac-signatures)

[Webhook structure and types](/development-resources/webhooks/webhook-types)

[Additional settings](/development-resources/webhooks/webhook-types/additional-settings)

[Account settings webhooks](/development-resources/webhooks/webhook-types/account-settings-webhooks)

[Troubleshoot webhooks](/development-resources/webhooks/troubleshoot)

[Testing your integration](/development-resources/testing)

[Payments and modifications](/development-resources/testing/payments-and-modifications)

[Tokenization](/development-resources/testing/tokenization)

[Risk features](/development-resources/testing/risk-features)

[3D Secure 2 authentication](/development-resources/testing/3d-secure-2-authentication)

[Result codes and refusal reasons](/development-resources/testing/result-codes)

[CVC/CVV/CID result codes](/development-resources/testing/result-codes/cvc-cvv-cid-result-codes)

[Test cards and credentials](/development-resources/test-cards-and-credentials)

[Test card numbers](/development-resources/test-cards-and-credentials/test-card-numbers)

[Alternative payment methods test credentials](/development-resources/test-cards-and-credentials/alternative-payment-method-credentials)

[Create test cards](/development-resources/test-cards-and-credentials/create-test-cards)

[API reference](/development-resources/test-cards-and-credentials/create-test-cards/test-cards-api)

[Documentation and knowledge tools](/development-resources/documentation-tools)

[Libraries](/development-resources/libraries)

[Logs](/development-resources/logs-resources)

[Webhook event logs](/development-resources/logs-resources/webhook-event-logs)

[API logs](/development-resources/logs-resources/api-logs)

[MCP server](/development-resources/mcp-server)

[API idempotency](/development-resources/api-idempotency)

[Live endpoints](/development-resources/live-endpoints)

[Developer dashboard](/development-resources/developer-dashboard)

[Versioning](/development-resources/versioning)

[Batch processing](/development-resources/batch-processing)

[Submit modifications](/development-resources/batch-processing/submit-modifications)

[Submit through SFTP](/development-resources/batch-processing/advanced-sftp-batch-files)

[Batch acknowledgement file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-acknowledgement-file)

[Batch file naming and structure](/development-resources/batch-processing/advanced-sftp-batch-files/batch-file-naming-and-structure)

[Batch request file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file)

[Authorisation request file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/authorisation-request-file)

[Authorisation for a card payment](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/authorisation-request-file/authorisation-for-a-card-payment)

[Authorisation for an IBAN payment](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/authorisation-request-file/authorisation-for-an-iban-payment)

[Authorisation for a recurring payment](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/authorisation-request-file/authorisation-for-a-recurring-payment)

[Authorisation with airline data](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/authorisation-request-file/authorisation-with-airline-data)

[Authorisation for ACH Direct Debit](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/authorisation-request-file/authorisation-for-ach-direct-debit)

[Modification request file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file)

[AuthorisationReferral request](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file/authorisationreferral-request)

[Capture request](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file/capture-request)

[Capture with airline data](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file/capture-request/capture-with-airline-data)

[CancelOrRefund request](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file/cancelorrefund-request)

[Cancel request](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file/cancel-request)

[Refund request](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/modification-request-file/refund-request)

[RefundWithData request file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/refundwithdata-request-file)

[RefundWithData request](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/refundwithdata-request-file/refundwithdata-request)

[Payout request file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/payout-request-file)

[Payout request](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/payout-request-file/payout-request)

[PayoutModification request file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/payoutmodification-request-file)

[PayoutConfirm request](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/payoutmodification-request-file/payoutconfirm-request)

[PayoutDecline request](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/payoutmodification-request-file/payoutdecline-request)

[AccountUpdater request file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/accountupdater-request-file)

[StoreToken request file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/storetoken-request-file)

[StoreToken request for payout](/development-resources/batch-processing/advanced-sftp-batch-files/batch-request-file/storetoken-request-file/storetoken-request-for-payout)

[Batch result file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-result-file)

[Authorisation result file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-result-file/authorisation-result-file)

[Modification result file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-result-file/modification-result-file)

[RefundWithData result file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-result-file/refundwithdata-result-file)

[Payout result file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-result-file/payout-result-file)

[PayoutModification result file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-result-file/payoutmodification-result-file)

[Account Updater result file](/development-resources/batch-processing/advanced-sftp-batch-files/batch-result-file/accountupdater-result-file)

[Batch result file with validation errors](/development-resources/batch-processing/advanced-sftp-batch-files/batch-result-file/modification-result-file-validationerror)

[Import data from another payment provider](/development-resources/migrating-payment-data)

[Import payment details for recurring payments](/development-resources/migrating-payment-data/import-payment-details-for-recurring-payments)

[Import data into referral lists](/development-resources/migrating-payment-data/import-data-into-referral-lists)

Responses

[Response handling](/development-resources/overview-response-handling)

[HTTP status codes](/development-resources/response-handling)

[Error codes and messages](/development-resources/error-codes)

[Raw responses](/development-resources/raw-acquirer-responses)

[Mapping to Visa fee categories](/development-resources/raw-acquirer-responses/visa-integrity-fees)

[Refusal reasons](/development-resources/refusal-reasons)

Reference

[Currency codes](/development-resources/currency-codes)

[PaymentMethodVariant](/development-resources/paymentmethodvariant)

Partners

[Application information](/partners/application-information)

[OAuth](/partners/oauth)

SECURITY AND COMPLIANCE

[Security resources](/development-resources/security)

[Protecting your Adyen integration](/development-resources/security/integration-security)

[Allowlisting IP addresses](/development-resources/security/integration-security/allowlisting)

[Identity and access management](/development-resources/security/iam)

[Secure coding](/development-resources/security/secure-coding)

[API security](/development-resources/security/api-security)

[Protecting sensitive data](/development-resources/security/sensitive-data)

[Transport Layer Security (TLS)](/development-resources/security/sensitive-data/tls)

[PGP encryption](/development-resources/security/sensitive-data/pgp-encryption)

[Handling incidents](/development-resources/security/incidents)

[Data Protection API](/development-resources/data-protection-api)

[PCI DSS compliance guide](/development-resources/pci-dss-compliance-guide)

[PCI compliance levels](/development-resources/pci-dss-compliance-guide/merchant-levels)

[Engaging a QSA](/development-resources/pci-dss-compliance-guide/pci-with-qsa)

[SAQ A eligibility](/development-resources/pci-dss-compliance-guide/saq-a-eligibility)

[Vulnerability scanning for ecommerce](/development-resources/pci-dss-compliance-guide/vulnerability-scanning-regulation)

[Script security for ecommerce](/development-resources/pci-dss-compliance-guide/script-security)

[Comparing E2EE and P2PE](/development-resources/e2ee-p2pe-comparison)

[Surcharge compliance guide](/development-resources/surcharge-compliance)

[Home](/)

[Development resources](/development-resources)

API credentials

[Image: Tools-2 icon]

# 
                                    API credentials
                                

Generate and configure credentials for the API requests that you make to Adyen.

To securely authenticate your requests to Adyen's APIs, you need API credentials. These act as the identity for your integration, and ensures that every request is authorized and linked to the correct account. When your account is set up it includes one API credential. You can also create multiple API credentials to improve security and control access.

An API credential consists of:

- **Username**: An identifier in the format `ws_123456@Company.[YourCompanyAccount]`.
- **API key**: A password to authenticate API requests.
- **Roles**: Permissions that define what the credential is allowed to do.

API credentials are created automatically during setup. You can manage them within your [Customer Area](https:
page preview · the URL we fetched https://docs.adyen.com/development-resources/api-credentials/ ↗
Screenshot of docs.adyen.com

Couldn't render a preview for this site. Open the URL in a new tab ↗

Screenshot via thum.io

§3 · AILANG × your business

docs.adyen.com scored 4/10 on agent-ready. AILANG opportunity is therefore 6/10. Here's where it would land first.

REST + MCP + A2A + OpenAPI in one command

ailang serve-api takes your typed AILANG functions and exposes them as REST endpoints, MCP tools, A2A skills, and OpenAPI 3.1 docs simultaneously. One module, four agent surfaces.

ailang serve-api --port 8092 --mcp-http \
  pricing.ail catalogue.ail
-- POST /api/pricing/quote, MCP at /mcp/,
-- A2A at /.well-known/agent.json, OpenAPI at /api/_meta/redoc.
→ AILANG docs

Contract-verified tool calls

Every tool an agent can call has a contract. Bounds, refusal paths, type signatures — proven before the agent ever sees it. The agent cannot exceed the tool's declared authority.

func placeOrder(item: SKU, qty: int) -> Receipt
  requires { qty > 0, qty <= 10 }
  ensures  { result.total > 0.0 }
-- the MCP server exposes this with its contract intact.
→ AILANG docs

An MCP server for your own docs and tools

Generate an MCP server from your typed AILANG functions; the docs MCP exposes a submit_feedback tool so agents can flag issues back to the maintainer. The language and its consumers stay on the same wire.

-- The AILANG docs MCP server lets Claude / Cursor / any
-- MCP client query the language directly:
--   stdlib_search "URL encoding"
--   submit_feedback "..."
→ AILANG docs

How this page was made

func sketchSite(url: string<pii>, topic: Topic) -> Sketch
  ! {Net @limit=1, AI @limit=5, FS @limit=4, Process, Declassify}
SignalTopicResultPointsAILANG primitive
agent.json referencedagent-ready✗0/1ailang serve-api generates A2A agent cards automatically — bonus if you're an early adopter
openapi.json referencedagent-ready✗0/2ailang serve-api generates OpenAPI 3.1 from Hindley-Milner type signatures
MCP endpoint referencedagent-ready✓2/2ailang serve-api --mcp-http exposes typed functions as MCP tools
Public API docs linkedagent-ready✓2/2ailang serve-api hosts Swagger + ReDoc at /api/_meta/ by default
Webhooks documentedagent-ready✓2/2ailang serve-api handles webhooks as typed handler functions with effect-tracked side effects
Rate limits documentedagent-ready✗0/2Capability budgets — Net @limit=N is the symmetric server-side primitive for what agents see as rate limits
Streaming / SSE endpointagent-ready✗0/2std/stream — ssePost and Stream effect handle event-source endpoints with typed event types
Sandbox / test environment offeredagent-ready✗0/2ailang --ai-stub plus mock effect handlers — deterministic, capability-scoped fakes for any effect, including Net and AI
Authentication documentedagent-ready✓2/2std/jwt for verification, IFC labels (string / string) to keep credentials out of public sinks at the type level
Idempotency keys documentedagent-ready✓2/2Pure functions are idempotent by construction; requires/ensures contracts express idempotence as a static guarantee
AG-UI streaming protocolagent-ready✗0/1std/stream — the AG-UI event lifecycle (RUN_STARTED → TEXT_MESSAGE_CONTENT → TOOL_CALL_RESULT → RUN_FINISHED) is a textbook sum type. ADTs + exhaustive pattern matching make every event-type branch a compile error to skip.
HTTP 402 agent payments (x402 / pay-per-crawl)agent-ready✗0/1Net @endpoint-scoped capability budgets bound payment destinations; requires { amount <= budget } gates the payload; IFC labels keep the signed payment key out of public sinks. Same primitives cover x402 payload signing and Cloudflare's crawler-price negotiation.
AP2 Agent Payments Protocolagent-ready✗0/1Mandates ARE contracts. requires { intent.price <= mandate.maxPrice } + ensures { cart.total <= intent.price } is a one-to-one translation of an Intent/Cart Mandate into AILANG. Z3 can verify the bounds at compile time.
UTCP tool-calling protocolagent-ready✗0/1Typed function signatures are the manifest. ailang serve-api emits the same metadata as a UTCPManual (name, input/output schema, native endpoint) — direct-call discovery without a proxy server.
End-to-end encryption documentedprivacy✓2/2IFC labels (string) force decryption to flow through a typed boundary; the compiler refuses to publish sealed values without explicit declassification
Compliance certifications citedprivacy✗0/2requires/ensures contracts express machine-verifiable claims; capability budgets bound audit-trail effects; effect rows leave nothing un-declared
Data minimisation languageprivacy✗0/2Capability scoping — each Net call declares its endpoint in the effect row, so "doesn't sell" becomes a type-system-enforceable claim, not a marketing one
Third-party domains restrainedprivacy✗0/2Capability scoping — each Net call declares its endpoint in the effect row
Data residency / on-prem languageprivacy✗0/2Three-runtime deploy — same module runs in WASM (browser), Cloud Run, and native CLI
Single-vendor LLM languageportable○2/2std/ai multi-provider — switch from Anthropic to Gemini to OpenAI without rewriting
Multiple AI providers citedportable✗0/2std/ai — one Step API across Anthropic, OpenAI, Gemini, OpenRouter, Ollama, and custom-package providers
Cross-runtime / deployment portabilityportable✗0/2Effect handlers as runtime adapters — same .ail runs as WASM in the browser, a Cloud Run container, and a native CLI; only the handlers change
BYO key / model-agnosticportable✓2/2AILANG WASM — the full interpreter ships as a browser bundle, so caller-held keys (BYOK), offline apps, and embedded demos all work client-side

The rubric that scored this page is open-source AILANG code — every signal extractor is contract-verified. View rubric →