If you are working in the marketplace model, money transfers you have made to your sub-merchant type members may be returned because, for example, the bank account of the sub-merchant might be closed, IBAN/NAME-SURNAME might mismatch. You can list your sub-merchants whose money returns on this endpoint, update the sub-merchant information and try to send money again.
| HTTP Method | URL |
|---|---|
POST |
/settlement-reporting/v1/settlement-file/bounced-sub-merchant-rows |
The expected parameters to be sent in requests to query bounced sub-merchants are listed under the table and subheadings below;
| Parameter Name | Type | Mandatory | Description |
|---|---|---|---|
startDate |
date |
Yes | Start date for the time interval you want to query |
endDate |
date |
Yes | End date for the time interval you want to query |
Parameters returned as a result of querying bounced sub-merchants are also subject to the rules specified in
the Response Formats section of the API documentation home page. In the absence of a systematic
or fictional error, the sub-parameters of the object returned in the data/items parameter are as follows:
| Parameter Name | Type | Description |
|---|---|---|
id |
long |
The id value of merchant member whose money is bounced |
iban |
string |
The IBAN value of merchant member whose money is bounced |
createdDate |
date |
The date the payout is created |
updatedDate |
date |
The update date that the payout is updated |
payoutId |
number |
The value of the payout |
payoutAmount |
decimal |
The amount of the payout |
contactName |
string |
Name of the merchant member whose money is bounced |
contactSurname |
string |
Surname of the merchant member whose money is bounced |
legalCompanyTitle |
string |
Legal company title of the merchant whose money is bounced |
rowDescription |
string |
Row description that is sent to the bank while the payout process |
You can review the sample codes in the open source Craftgate API clients.