- \n
- Make sure that your server can receive and accept webhooks<\/a>, and that the Transfer webhook<\/strong> has been added in your Customer Area<\/a>.<\/li>\n
- Ask our Support Team<\/a> to enable transfers for the balance account where the funds are returned from.<\/li>\n
- If the balance accounts involved in the internal funds transfer do not belong to the same account holder<\/em>, check the capabilities of the account holders:\n
- \n
- The account holder of the balance account where the funds are returned from must have the sendToBalanceAccount<\/strong> capability.<\/li>\n
- The account holder of the balance account where the funds are returned to must have the receiveFromBalanceAccount<\/strong> capability.<\/li>\n<\/ul><\/li>\n
- Make sure that your API credential<\/a>:\n
- \n
- Has access to the Transfers API<\/a>.<\/li>\n
- Has the TransferService Webservice Initiate role<\/a><\/strong>.<\/li>\n<\/ul><\/li>\n<\/ul>\n
Initiate a return<\/h2>\n
To return an internal push transfer:<\/p>\n
- \n
- \n
Make a POST \/transfers\/{transferId}\/returns<\/a> request, where
{transferId}<\/code> is the ID of the original incoming transfer that is returned in the webhooks.<\/p>\nSpecify the following request parameters:<\/p>\n
\n\n
\n \nParameter<\/th>\n Required<\/th>\n Description<\/th>\n<\/tr>\n<\/thead>\n \n amount<\/a><\/td>\n ![\"-white_check_mark-\"](\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" "\\"-white_check_mark-\\"")
<\/td>\nObject containing the currency and value of the transfer. These must be the same as in the original transfer.<\/td>\n<\/tr>\n \n reference<\/a><\/td>\n <\/td>\n Your unique reference for returning the transfer.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n The following example shows how to return EUR 100 previously received through an internal transfer with the ID
123XYZABC456DEF7<\/code>.<\/p>\n\n<\/code-sample>\n<\/div>\n<\/li>\n - \n
In the response, note the following:<\/p>\n
- \n
id<\/code>: the ID of the return request.<\/li>\nstatus<\/code>: Authorised<\/strong>. If Declined<\/strong>, this can indicate that you used the wrong transfer ID in the URL.<\/li>\ntransferId<\/code>: the ID of the original incoming transfer, which you specified in the URL of the return request.<\/li>\n<\/ul>\n\n<\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n Get updates on the status of the return<\/h2>\n
Track returns by using the webhooks<\/a> that Adyen sends to your server. The webhooks provide the status of the request and also inform you if the request failed.<\/p>\n
- \n
- Has the TransferService Webservice Initiate role<\/a><\/strong>.<\/li>\n<\/ul><\/li>\n<\/ul>\n
- The account holder of the balance account where the funds are returned to must have the receiveFromBalanceAccount<\/strong> capability.<\/li>\n<\/ul><\/li>\n
- Ask our Support Team<\/a> to enable transfers for the balance account where the funds are returned from.<\/li>\n