How do I interpret different statuses of a Payin?

When a Payin is initiated on Finmo, it progresses through various statuses based payment method and transaction timlines. Below are the statuses that can be expected:

PENDING: Initial status when a Payin is created. No payment has been made yet.

AWAITING_FUNDS: The customer has initiated the transfer, but Finmo has not yet received the funds from the partner bank.

COMPLETED: Finmo has successfully received the funds, and the Payin is marked as completed.

EXPIRED: The Payin has expired because the customer did not complete the payment within the allotted time window (typically 30–60 minutes, depending on the payment method).

CANCELLED: The Payin was cancelled either by the customer or programmatically during creation (based on options provided in the API).

FAILED: If funds are not received by Finmo within 7 days of the transfer initiation (even if the customer attempted the transfer), the status is marked as failed.

Payin Events on Webhook notifications

Finmo uses webhooks to notify your application any time an events happens on your account. You can set up static webhook via the Dashboard. If you do not wish to use the static webhook you can also provide us with a dynamic webhook_url in the Payin/Checkout API that trigger a webhook.

Here’s what each webhook event name refers to:

Payin_CREATED: Triggered when a Payin is initiated. Status = PENDING.

Payin_AWAITING_FUNDS: Triggered when the customer has transferred the funds, but they have not yet reached Finmo. Status = AWAITING_FUNDS.

Payin_COMPLETED: Triggered when Finmo receives the funds. Status = COMPLETED.

Payin_EXPIRED: Triggered when the customer doesn’t complete the payment within the allowed window. Status = EXPIRED.

Payin_CANCELLED: Triggered when the Payin is cancelled as per options configured in the selected Payin method. Status = CANCELLED.

For further support on a Pending or Failed Payin, please email [email protected] with your Payin ID as shown on your Finmo Dashboard.