v1

latestOpenAPI 3.0.22026-08-061303782.1 MB

Settlements

Close a Settlement

Close an accruing Settlement. Finix, by default, creates accruing settlements then closes them based on your payout configurations. Use this endpoint to manually close a specific settlement.

The closed Settlement will not accrue any further transactions and gets immediately submitted for approval.

Important Notes:

This endpoint is only available to Finix Core customers. If you have any questions, please contact the Finix Support Team.
Any refunded Transfers get included in Settlements as a deduction.
PENDING Transfers don't get included in Settlements.
The total_amount minus the total_fee equals the net_amount. The net_amount is the amount in cents that gets deposited into the seller's bank account.

put/settlements/{settlement_id}

Request body

action'STOP_ACCRUAL' required

The action you want to perform on the Settlement. Use STOP_ACCRUAL to close the specified Settlement.

Response

A single closed Settlement

idstring

The ID of the resource.

created_atstring date-time

Timestamp of when the object was created.

updated_atstring date-time

Timestamp of when the object was last updated.

applicationstring

ID of the Application the resource was created under.

currency'CAD' | 'USD'

ISO 4217 3-letter currency code.

destinationstring nullable

ID of the Payment Instrument where funds will be sent.

funds_flowstring nullable

Details how funds will be dispersed in the Funding Transfer (usually null).

identitystring

The ID of the Identity used to create the Settlement resource.

is_exceptionboolean

Returns true if the Settlement contains items that were removed from a previous Settlement.

merchant_idstring

The ID of the Merchant used to create the Settlement resource.

net_amountinteger

The amount in cents that will be deposited into the merchant's bank account.

payment_typestring nullable

The type of Payment Instrument used in the Funding Transfer (or the original payment).

payout_profile_idstring

The ID of the Payout Profile that was used to generate the Settlement.

processorstring

The name of the processor.

status'APPROVED' | 'AWAITING_APPROVAL'

The status of the Settlement. Merchants only receive payouts when Settlements are APPROVED. For more information, see Payouts.

tagsTags nullable

Include up to 50 key: value pairs to annotate requests with custom metadata.

Maximum character length for individual keys is 40.
Maximum character length for individual values is 500. (For example, order_number: 25, item_type: produce, department: sales)

total_amountinteger

The total amount of the Settlement in cents.

total_feeinteger

The sum of the fees in the Settlement.

total_feesinteger

The sum of the fees in the Settlement, including subscription billing fees.

The type of Settlement.

Example response

{
  "destination": "PIxxxxxxxxxxxxxxxxxx"
}