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\/payouts\/payout-service\/top-up-balance-accounts\/create-recurring-top-ups","articleFields":{"Menu":"Create recurring top-ups","description":"Learn how to configure recurring top-ups for your balance accounts.","last_edit_on":"11-09-2020 17:20","parameters":{"directoryPath":"\/payouts\/payout-service","integrationType":"payouts"}},"algolia":{"url":"https:\/\/docs.adyen.com\/payouts\/payout-service\/top-up-balance-accounts\/create-recurring-top-ups","title":"Create recurring top-ups","content":"You can create recurring top-ups to automatically pull funds into your balance accounts when needed. This ensures that your balance accounts are adequately funded and have sufficient balance for day-to-day activities.\nA recurring top-up triggers outgoing direct debit requests to a bank account, based on the settings you configure. These settings determine the amount, frequency, and source of funds for the direct debit requests. Adyen then books the funds from the top-up to your balance account.\nRequirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\n Adyen enterprise payouts integration. \n\n\nAPI credential roles\nTo configure top-up schedules using the API, make sure that you have the credentials for the Configuration API with the following role:BankAPI Advanced Webservice role\n\n\nCustomer Area roles\nTo configure top-up schedules using the Customer Area, make sure that you have the following roles:Balance platform base roleConfigure scheduled payouts\n\n\nWebhooks\nSubscribe to the following webhooks: Configuration webhooks Transfer webhooks Transaction webhooks\n\n\nCapabilities\nMake sure that the account holder has the following capability: receiveFromTransferInstrument Before attempting a transfer, verify that this capability is active and has a valid verificationStatus. You can check this via the verificationStatus. Note, if you need to enable this capability see Request a capability.\n\n\nLimitations\nThis feature does not support on-demand top-ups.Top-ups are supported only in EUR and USD.\n\n\nSetup steps\nMake sure that your top-up source has enough balance to fund the top-up.If you are configuring top-ups using the API, you must first accept the Terms of Service. If you are using the Customer Area, this is handled during the setup wizard.\n\n\n\nCreate a recurring top-up\nYou can create a recurring top-up using the API or your Customer Area.\n\n\n \n \n \n \n\n\nProcessing and cut-off times\nIf you set a time-based schedule (such as weekly or monthly), the trigger timestamp defaults to 7:00 AM in the timezone of your account. Settle times depend on how this trigger time interacts with currency-specific cut-offs:\n\nUSD (T+2 settlement): Because the automatic 7:00 AM trigger occurs after the 01:45 ET cut-off, funds settle on T+2 (after 08:30 ET).\nEUR (next business day settlement): Because the automatic 7:00 AM trigger occurs before the 14:00 CET cut-off, funds settle on the next business day.\n\nError messages and failure reasons\nWhen you create top-up schedules using the API, if the request fails, the reason for the failure is provided in the API response. The following table shows how to identify and troubleshoot some of the most common errors that can occur during top-up creation.\n\n\n\nStatus\nError codeerrorCode\nError summarytitle\nReasondetail\n\n\n\n\n400\n29_001\nThe request is missing required fields or contains invalid data.\ntrigger.threshold.currency: missing or invalid currency code.\n\n\n400\n29_001\nThe request is missing required fields or contains invalid data.\nCurrencies must match threshold currency. topUpAmount.fixed.currencytopUpAmount.target.currency\n\n\n400\n29_001\nThe request is missing required fields or contains invalid data.\ndescription: invalid placeholders or invalid format.\n\n\n404\n1082_105\nRecurring top-up not found.\nTop-up ID does not exist. (Applies to GET, PATCH, DELETE requests).\n\n\n422\n30_013\nBalance account not found.\nCould not find balance account with ID {id}.\n\n\n422\n1082_101\nAccount top-up currency mismatch.\nCurrency of the top-up does not match the balance account.\n\n\n422\n1082_102\nInvalid BAP configuration provided.\nBAP property DirectDebitTopUp is not active for this balance account.\n\n\n422\n1082_103\nInvalid recurring top-up request.\nGeneric invalid request rejected by banksweep.\n\n\n422\n1082_104\nAccount is missing required capabilities.\nMissing receiveFromTransferInstrument on the account holder.\n\n\n422\n1082_107\nFailed to resolve payment instrument.\nPayment instrument could not be resolved.\n\n\n422\n1082_108\nFailed to resolve transfer instrument.\nInvalid transfer instrument with id {id}.\n\n\n422\n1082_112\nNo valid routes found.\nNo routes are available for the provided configuration.\n\n\n422\n1082_113\nNo PPA route assigned.\nNo PPA route found.\n\n\n422\n1082_114\nTerms of service not signed.\nA terms of service needs to be signed before having a recurring top-up configured.\n\n\n422\n1082_115\nDirect debit amount threshold exceeded.\nTop-up amount exceeds the configured maximum threshold for direct debit top-ups on balance account {id}.\n\n\n422\n1011_001\nAn account has an invalid status.\nBalanceAccountHolder {id} has invalid account status inactive.\n\n\n422\n1011_003\nInvalid counterparty provided.\nValidation failed for one of the following reasons: Cannot configure a sweep to itself.Bank account id is invalid.Merchant account not found.Legal entity does not have access to transfer instrument.\n\n\n422\n1011_013\nA sweep with this configuration already exists.\nA ({direction}) sweep with currency ({cur}), counterparty ({cp}) and schedule ({sched}) already exists: ({id}).\n\n\n\nSee also\n\nManage 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 Payouts","lvl2":"Payouts and Payments","lvl3":"Top up accounts","lvl4":"Create recurring top-ups"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/payouts","lvl2":"https:\/\/docs.adyen.com\/payouts\/payout-service","lvl3":"https:\/\/docs.adyen.com\/payouts\/payout-service\/top-up-balance-accounts","lvl4":"\/payouts\/payout-service\/top-up-balance-accounts\/create-recurring-top-ups"},"levels":5,"category":"","category_color":"","tags":["Create","recurring","top-ups"]}}