When managing payments, you may come across specific situations that demand your attention to ensure a seamless user experience and effective reconciliation.

Pending Payments

Pending payments are instances where Fintoc cannot provide a definitive status of the payment at the moment. These payments can either succeed or fail at a later time, depending on various factors and your process for handling them might depend on your payment scheme and API version.

🚧

Pause internal processes

We strongly advise you to pause any internal processes that may be affected by the payment completion, such as charging interest on debts or canceling contracts, until the payment is finalized.

How to Deal with Pending Payments

Fintoc does not have access to your bank statements and might not be able to provide a definite answer regarding the status of some payments. If the Payment is validated as successful or failed, Fintoc will send a webhook (payment_intent.succeeded or payment_intent.failed) notifying the final status of the payment.

Fintoc will attempt to validate pending payments for up to 10 days. If the payment cannot be verified in that time, you will recieve a payment_intent.failed webhook with a distinct error reason (unresolved_final_status).

It is highly recommended to check your banks statements to see if the payment was completed or not. If the payment occurs, we recommend handling it depending on your business case:

Previous API Versions

Since there is no pending state for payments in previous versions of our API, these will always have a failed status initially. Fintoc might be able to determine the final status, but we recommend you check your bank statement for any unknown transfer you might have received related to this payment. If you are not using this current version of the API, we encourage you to check the documentation of your API version to get more details.

False Failed Payments

False failed payments occur when Fintoc provides a failed status for a payment, but the funds are actually deposited into your bank account.

How to Deal with False Failed Payments

It is highly recommended to check your bank statements to verify whether each payment was completed. If Fintoc provides a failed status for a payment that was actually deposited into your bank account, we suggest handling it based on your business case:

External Transfers

If you are using Direct Payments, your company name may be saved on you client’s recipient contacts in their banks. This means that they can mistakenly transfer funds directly to your account outside of your payment flow.

How to Deal with External Transfers

Since Fintoc does not have access to your bank statement, there is no way to tell if a movement outside of a regular payment flow was made. To provide a great user experience, we encourage you to identify this cases and handle them according to your business case.

As these payments are typically caused by user errors and may have been intended for another bank account, we encourage you to return these payments to your clients or establish a clear policy on how to handle them. This proactive approach can help you avoid larger issues with your customer support team and provide a better overall payment experience for your users.

Fintoc Reconciles

If you are using Fintoc Reconciles, the reconciliation process run by Fintoc will automatically identify both Pending Payments and External Transfers.

Each business day, Fintoc will analyze the transaction records of your bank account and compare them with the payments received via the Fintoc API. Based on this reconciliation process, Fintoc will provide you with a file containing the results.

For specific details on the reconciliation results file, visit the "Reporting and Reconciliation" section.