Payment Lifecycle

Most transactions in Finix follow a similar pattern. The diagram below models out the Payment Lifecycle for Finix:

1. Buyer requests to make a payment with seller.
2. The platform collects the buyers information and creates an Identity to represent the buyer in Finix.
3. The platform collects the buyer's payment information and creates a Payment Instrument to represent the payment method used by the buyer to complete the payment. Once created, Finix notifies the seller with:

   • A webhook which only gets sent when a Payment Instrument gets created from a bank account , debit or credit card .
   • A payment instrument entry on the Payment Instruments tab of the Finix Dashboard .

4. The platform creates an Authorization to reserve the funds on the Payment Instrument to be captured (i.e. debited) at a later date, usually within seven days.

   • An authorization entry also gets added on the Authorizations tab of the Finix Dashboard .

5. If the Authorization is successful, Authorization#state gets updated to SUCCEEDED and Authorization#expires_at gets updated with a timestamp. The Authorization entry on the Authorizations tab of the Finix Dashboard also gets updated.

   • If the Authorization fails, Authorization#state gets updated to FAILED. The Authorization entry on the Authorizations tab of the Finix Dashboard also gets updated. To proceed, the platform needs to submit the Authorization again.

6. The platform captures the Authorization .

   • A webhooks gets sent when the Authorization gets captured .
   • The authorization entry gets updated on the Authorizations tab of the Finix Dashboard .

7. Finix creates a Transfer to debit and move funds.

   • The id of the Transfer is available in the Authorization captured webhook.
   • A transaction entry gets added on the Transactions tab of the Finix Dashboard .

8. When funds get debited, the Transfer gets updated with a timestamp in Transfer#ready_to_settle_at .

   • A webhooks gets sent when the Transfer is ready_to_settle .
   • The transaction entry gets updated on the Transactions tab of the Finix Dashboard .

9. Once the timestamp in Transfer#ready_to_settle_at passes, the Transfer will appear in the next Settlement that closes and requires approval.

   • A webhooks gets sent when a Settlement is ready and waiting for your approval .
   • An settlement entry also gets added on the Settlements tab of the Finix Dashboard .

10. Once the Settlement is approved, a funding Transfer gets created to credit funds to the seller.

    • The settlement entry also gets updated on the Settlements tab of the Finix Dashboard .

11. When the funding Transfer gets updated to SUCCEEDED , the seller can expect funds to hit their bank account in 5-7 business days (depending on their bank).

    • See Managing Failed Payouts for details on how to handle a funding Transfer that gets updated to FAILED.
    • A webhooks gets sent when the Transfer gets updated .