{"files":{"SKILL.md":"---\nname: adyen-balance-control-api\ndescription: \"Adyen Balance Control API skill. Use when working with Adyen Balance Control for balanceTransfer. Covers 1 endpoint.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Adyen Balance Control API\nAPI version: 1\n\n## Auth\nApiKey X-API-Key in header | Bearer basic\n\n## Base URL\nhttps://pal-test.adyen.com/pal/servlet/BalanceControl/v1\n\n## Setup\n1. Set Authorization header with Bearer token\n2. Verify API access with a test request\n3. POST /balanceTransfer -- create first balanceTransfer\n\n## Endpoints\n1 endpoint across 1 group. See references/api-spec.lap for full details.\n\n### BalanceTransfer\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /balanceTransfer | Start a balance transfer |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a balanceTransfer?\" -> POST /balanceTransfer\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Adyen Balance Control API\n@base https://pal-test.adyen.com/pal/servlet/BalanceControl/v1\n@version 1\n@auth ApiKey X-API-Key in header | Bearer basic\n@endpoints 1\n@toc balanceTransfer(1)\n\n@endpoint POST /balanceTransfer\n@desc Start a balance transfer\n@required {amount: map{currency!: str, value!: int(int64)}, fromMerchant: str # The unique identifier of the source merchant account from which funds are deducted., toMerchant: str # The unique identifier of the destination merchant account from which funds are transferred., type: str(tax/fee/terminalSale/credit/debit/adjustment) # The type of balance transfer. Possible values: **tax**, **fee**, **terminalSale**, **credit**, **debit**, and **adjustment**.}\n@optional {description: str # A human-readable description for the transfer. You can use alphanumeric characters and hyphens. We recommend sending a maximum of 140 characters, otherwise the description may be truncated., reference: str # A reference for the balance transfer. If you don't provide this in the request, Adyen generates a unique reference. Maximum length: 80 characters.}\n@returns(200) {amount: map{currency: str, value: int(int64)}, createdAt: str(date-time), description: str, fromMerchant: str, pspReference: str, reference: str, status: str, toMerchant: str, type: str} # OK - the request has succeeded.\n@example_request {\"amount\":{\"value\":50000,\"currency\":\"EUR\"},\"description\":\"Your description for the transfer\",\"fromMerchant\":\"MerchantAccount_NL\",\"toMerchant\":\"MerchantAccount_DE\",\"type\":\"debit\"}\n\n@end\n"}}