{"title":"Confirm funds availability","category":"default","creationDate":1776961628,"content":"<p>As part of the open banking framework for Payment Initiation Service Providers (PIISPs), Adyen provides an endpoint to confirm available funds on behalf of account holders who have given their consent.<\/p>\n<p>This page explains how you, as a third-party PIISP, use the <code>\/funds-confirmations<\/code> endpoint to:<\/p>\n<ul>\n<li><a href=\"#confirm-funds\">Confirm funds<\/a><\/li>\n<\/ul>\n<h2>Requirements<\/h2>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">Not applicable; this documentation is intended for third-party providers.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Setup steps<\/strong><\/td>\n<td style=\"text-align: left;\">Before you begin, you must: <ul><li>Complete the <a href=\"\/pt\/business-accounts\/open-banking#onboard-with-adyen\">Adyen onboarding steps<\/a>.<\/li><li> Have your <a href=\"\/pt\/business-accounts\/oauth-flow#get-an-access-token\">access token<\/a> for the Adyen business account.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Confirm funds<\/h2>\n<p>To ensure that the account holder has sufficient funds to cover the payment amount:<\/p>\n<ol>\n<li>\n<p>Make a POST <code>\/funds-confirmations<\/code> request with the following parameters in the request body. The request header includes, for example, an IPv4 address like 82.199.87.148, or an IPv6 address like 2001:db8:1:1:1:1:1:1.<\/p>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>instructedAmount<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The currency and the amount of the payment.<\/td>\n<\/tr>\n<tr>\n<td><code>account<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The account number for which the funds availability needs to be checked.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The following request checks if the IBAN has <strong>EUR&nbsp;10.50<\/strong> available.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Confirm available funds'\" :id=\"''\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;&quot;,&quot;content&quot;:&quot;curl  'https:\\\/\\\/openbanking-psd2-test.adyen.com\\\/obeu\\\/piis\\\/v1\\\/funds-confirmations' \\\\\\n--header 'X-Request-ID: {your-request-id}' \\\\\\n--header 'IPv4: 82.199.87.148' \\\\\\n--header 'Content-Type: application\\\/json' \\\\\\n--header 'Authorization: Bearer {access_token}' \\\\\\n--data '{\\n    \\&quot;instructedAmount\\&quot;: {\\n        \\&quot;currency\\&quot;: \\&quot;EUR\\&quot;,\\n        \\&quot;amount\\&quot;: \\&quot;10.50\\&quot;\\n    },\\n    \\&quot;account\\&quot;: {\\n        \\&quot;iban\\&quot;: \\&quot;NL91ABNA0417164300\\&quot;\\n    }\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>The response contains <code>fundsAvailable<\/code> that indicates whether the instructed amount is available. A value of <code>false<\/code> indicates insufficient funds for the specified amount.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Response'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"fundsAvailable\\\": true\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/business-accounts\/aisp\"\n                        target=\"_self\"\n                        >\n                    Get account holder information\n                <\/a><\/li><li><a href=\"\/business-accounts\/pisp\"\n                        target=\"_self\"\n                        >\n                    Initiate payments\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/business-accounts\/piisp","articleFields":{"description":"Learn how to consume our dedicated PIISP endpoints.","feedback_component":true,"id":"31504141","type":"page","_expandable":{"operations":""},"status":"current","parameters":{"directoryPath":"\/business-accounts","model":"balance platform"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/business-accounts\/piisp","title":"Confirm funds availability","content":"As part of the open banking framework for Payment Initiation Service Providers (PIISPs), Adyen provides an endpoint to confirm available funds on behalf of account holders who have given their consent.\nThis page explains how you, as a third-party PIISP, use the \/funds-confirmations endpoint to:\n\nConfirm funds\n\nRequirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nNot applicable; this documentation is intended for third-party providers.\n\n\nSetup steps\nBefore you begin, you must: Complete the Adyen onboarding steps. Have your access token for the Adyen business account.\n\n\n\nConfirm funds\nTo ensure that the account holder has sufficient funds to cover the payment amount:\n\n\nMake a POST \/funds-confirmations request with the following parameters in the request body. The request header includes, for example, an IPv4 address like 82.199.87.148, or an IPv6 address like 2001:db8:1:1:1:1:1:1.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\ninstructedAmount\n\nThe currency and the amount of the payment.\n\n\naccount\n\nThe account number for which the funds availability needs to be checked.\n\n\n\nThe following request checks if the IBAN has EUR&nbsp;10.50 available.\n\n\n\n\n\nThe response contains fundsAvailable that indicates whether the instructed amount is available. A value of false indicates insufficient funds for the specified amount.\n\n\n\n\n\nSee also\n\n\n                    Get account holder information\n                \n                    Initiate payments\n                \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Business accounts","lvl2":"Confirm funds availability"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/business-accounts","lvl2":"\/pt\/business-accounts\/piisp"},"levels":3,"category":"","category_color":"","tags":["Confirm","funds","availability"]}}