Top-up webhooks<\/h6>
Stay updated about changes to the recurring top-ups on your platform.<\/p><\/div><\/p><\/a><\/div>\n","url":"https:\/\/docs.adyen.com\/issuing\/add-manage-funds\/top-ups\/sign-terms-of-service","articleFields":{"Menu":"Show Terms of Service document","description":"Get your cardholders to accept Adyen's Terms of Service","last_edit_on":"28-04-2026 13:08","parameters":{"directoryPath":"\/issuing","integrationType":"issuing"}},"algolia":{"url":"https:\/\/docs.adyen.com\/issuing\/add-manage-funds\/top-ups\/sign-terms-of-service","title":"Show Terms of Service document","content":"Before you can set up recurring top-ups, you must accept Adyen's Terms of Service for top-up contracts.\nThe Terms of Service document must be accepted by an individual legal entity that represents a physical person. For organizations, the document must be accepted by an authorized signatory of the organization.\nFor example:\n\nA cardholder accepts the document on their own behalf.\nThe owner of a restaurant accepts the document on behalf of the legal entity that represents the business.\n\n\n\nRequirements\nBefore you begin, take into account the following requirements and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\n Adyen Issuing integration. \n\n\nAPI credential roles\nMake sure that you have the credentials for the Legal Entity Management API (in the format ws[123456]@Scope.Company[YourCompanyAccount])\n\n\nSetup steps\nThis workflow is only required if you are configuring top-ups using the API. If you are using the Customer Area, this is handled during the setup wizard.Before you begin, make sure that you created the legal entity connected to the account holder. This is the same legal entity that accepts the Terms of Service document.\n\n\n\nHow it works\nTo generate and accept the Terms of Service, follow these steps:\n\nOptionally, make an API request to check if your cardholder has already signed the Terms of Service.\nMake an API request to generate the Terms of Service document.\nPresent the Terms of Service document to your cardholder.\nMake an API request to confirm that your cardholder has accepted the Terms of Service.\n\nCheck the Terms of Service status\nTo see if your cardholder has already accepted the Terms of Service for top-up contracts:\n\n\nMake a GET \/legalEntities\/{id}\/termsOfServiceAcceptanceInfos request with the id of the main legal entity in the path. The main legal entity is the legal entity that accepts the Terms of Service. For sole proprietorships, this is the individual legal entity ID of the owner. For organizations, this is the ID of the organization.\n\n\n\n\n\nThe response returns a data array. Each object in the array contains the details of a Terms of Service document that the legal entity has accepted.\n\nIf no terms have been accepted: The response returns an empty data array.\nIf terms have been accepted: Check the data array for an object where the type is set to directDebit. If this object is present, your cardholder has already accepted the Terms of Service for top-up contracts and you can skip the remaining steps.\n\nThe response contains the following fields:\n\n\n\nParameter\nDescription\n\n\n\n\ncreatedAt\nThe date the document was created.\n\n\nid\nThe unique identifier of the accepted document.\n\n\nacceptedBy\nThe id of the individual who accepted the terms of service.\n\n\nacceptedFor\nThe id of the main legal entity.\n\n\ntype\nThe type of document based on the services and capabilities requested.\n\n\n\n\n\n\n\n\nGenerate the Terms of Service document\nTo generate the Terms of Service document:\n\n\nMake a POST \/legalEntities\/{id}\/termsOfService request, specifying the id of the main legal entity in the path. For sole proprietorships, this is the individual legal entity ID of the owner. For organizations, this is the ID of the organization.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n type\n\nThe type of document based on the services and capabilities requested.Set this to directDebit for topup contracts.\n\n\n language\n\nThe language used for the Terms of Service document, specified by the two letter ISO 639-1 language code. Possible values: en for English fr for French Note that French is only available for some integration types in certain countries\/regions. Reach out to your Adyen contact for more information.\n\n\n termsOfServiceDocumentFormat\n\nThe requested format for the Terms of Service document. Possilble values: JSON (default)PDFTXT.\n\n\n\n\n\n\n\n\nThe response contains the following fields:\n\n\n\nParameter\nDescription\n\n\n\n\n document\nThe generated document in the Base64-encoded format. Present this to your cardholder in the next step.\n\n\n id\nThe unique identifier of the legal entity. For sole proprietorships, this is the individual legal entity ID of the owner. For organizations, this is the ID of the organization.\n\n\n language\nThe language of the document.\n\n\n type\nThe type of document based on the services and capabilities requested.\n\n\n termsOfServiceDocumentId\nThe unique identifier of the document. Use this when you confirm that your cardholder has accepted the Terms of Service.\n\n\n termsOfServiceDocumentFormat\nThe requested format for the Terms of Service document. Possilble values: JSON (default)PDFTXT\n\n\n\n\nDepending on your integration, your cardholder may need to accept more than one Terms of Service document. In this case, every required document and termsOfServiceDocumentId is returned in the response.\n\n\n\n\n\n\nPresent the Terms of Service document\nYou need to ask your cardholder to review and accept the Terms of Service document. The process depends on the format you requested in the previous step:\n\nUse JSON if you want to render the document directly in your UI using the Adyen Document Viewer.\nUse PDF or TXT for a simpler flow where your cardholder downloads and reviews the document.\n\n\n\n \n \n \n \n\n\nConfirm the Terms of Service acceptance\nTo confirm that your cardholder has accepted the Terms of Service:\n\n\nMake a PATCH \/legalEntities\/{id}\/termsOfService\/termsOfServicedocumentid request, specifying the id of the main legal entity and the termsOfServiceDocumentId of the document in the path. For sole proprietorships, include the legal entity ID of the owner in the path. For organizations, include the legal entity ID of the organization in the path.\nIn the body of the request, specify the following:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nacceptedBy\n\nThe individual legal entity id who accepts the Terms of Service.\n\n\nipAddress\n\nThe IP address of the individual accepting the Terms of Service.\n\n\n\nThis request populates the Terms of Service document with the data of the main legal entity. For sole proprietorships, this is the information for the individual legal entity of the owner. For organizations, this means the document contains both the data for the organization and the individual legal entity of the authorized signatory who accepted the document.\n\n\n\nThe response returns the following information.\n\n\n\nParameter\nDescription\n\n\n\n\nacceptedBy\nThe individual legal entity id who accepted the Terms of Service.\n\n\nid\nThe unique identifier of the accepted document.\n\n\nipAddress\nThe IP address of the individual accepting the Terms of Service. Returned only if provided in the request.\n\n\nlanguage\nThe language of the document.\n\n\ntermsOfServiceDocumentId\nThe unique identifier of the document.\n\n\ntype\nThe type of document based on the services and capabilities requested.\n\n\n\n\n\n\n\n\nAfter receiving a successful response, confirm that the document is now correctly linked to the legal entity record. Follow the steps in Check the Terms of Service status to verify that the type directDebit is now returned in the acceptance information.\n\n\nSee also\n\nCreate recurring top-upsLearn how to configure recurring top-ups for your balance accounts.Manage recurring top-upsLearn how to view, change, and delete recurring top-ups.Top-up webhooksStay updated about changes to the recurring top-ups on your platform.\n","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Adyen Issuing","lvl2":"Add and manage funds","lvl3":"Top up accounts","lvl4":"Show Terms of Service document"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/issuing","lvl2":"https:\/\/docs.adyen.com\/issuing\/add-manage-funds","lvl3":"https:\/\/docs.adyen.com\/issuing\/add-manage-funds\/top-ups","lvl4":"\/issuing\/add-manage-funds\/top-ups\/sign-terms-of-service"},"levels":5,"category":"Issuing","category_color":"green","tags":["Terms","Service","document"]}}
![\"-white_check_mark-\"](\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" "\\"-white_check_mark-\\"")
<\/td>\n