Payout Bounced Sub-Merchants

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.

URL

HTTP Method URL
POST /settlement-reporting/v1/settlement-file/bounced-sub-merchant-rows

Request Parameters

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

Response Parameters

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

Sample Codes

You can review the sample codes in the open source Craftgate API clients.

Search Payout Bounced Transactions