Understanding payment methods

Understanding payment method 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.

Payment methods


Payins can process via ACH bank transfers and all major card types, including Visa, Mastercard, Discover, and American Express. Cards can be accepted from any international location. ACH bank transfers must be from US bank accounts.

A payment method is identified by the payment_method_id in the Rainforest ecosystem. The prefix for a payment_method_id is mtd_ on production and sbx_mtd_ on sandbox.

Statuses

The payment method status is the descriptor of the current status in the life cycle of the payment method.

StatusDescription
CREATEDPayment method was created and waiting to be saved. This is an interim state.
PRESENTINGPayment method is presented on a terminal device and waiting for the user to store the payment method using the device. This is an interim state.
ACTIVEPayment method is stored and ready for use.
FAILEDPayment method failed to be stored.
CANCELEDPayment method was canceled while storing the payment method on a terminal device.