Understanding payins

Understanding payin statuses

🚧

Upgrade to the latest version

These docs are for version 2023-12-01. We encourage you to upgrade to version 2024-10-16 to access new features. Please see the changelog for more information.

Payin


A payin is a type of payment and is the movement of funds from a User to a Merchant.

A payin is identified by the payin_id in the Rainforest ecosystem. The prefix for a payin_id is pyi_ on production and sbx_pyi on sandbox.

Statuses

The payin status is the descriptor of the current status in the life cycle of the payin.

StatusDescription
CREATEDPayin was created and waiting approval. This is an interim state.
PRESENTINGPayin is presented on a terminal device and waiting for the user to process the payin on the device. This is an interim state.
PROCESSINGPayin was approved and is currently processing. This is an interim state.
SUCCEEDEDPayin has completed processing and is available to be deposited.
FAILEDPayin failed to process.
CANCELEDPayin processing was canceled and no funds will be moved. This means the payment was canceled/voided after processing or canceled when presenting on a terminal device.
IN_REVIEWPayin has been flagged for fraud review.