Understanding payment methods
Understanding payment methods in the Rainforest ecosystem
Rainforest supports processing payins with various payment methods:
- Card - debit or credit cards on all major card brands, including Visa, Mastercard, Discover, and American Express
- Apple Pay - debit or credit cards through the Apple Pay wallet
- ACH - US bank accounts
- Validated ACH - US bank accounts collected by the user authenticating into their online bank account
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.
Active payment methods can be used to process recurring payins with the create a payin from a stored payment method endpoint.
Payin from a stored payment method
A payin can be created from a stored payment method by sending the payment_method_id
received from capturing a previous payin or storing a payment method via the payment component.
Creating a payin from a stored payment method can be utilized to run a new one-time payin or for recurring or installment payins. The platform is responsible for maintaining the recurring schedule and submitting the payment_method_id
in the request each time a new payin is requested to be processed.
The process, statuses, and responses are the same for a payin from a stored payment method as a new payin processed from the payment component.
Statuses
The payment method status
is the descriptor of the current status in the life cycle of the payment method.

Status | Description |
---|---|
CREATED | Payment method was created and waiting to be saved. This is an interim state. |
PRESENTING | Payment 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. |
ACTIVE | Payment method is stored and ready for use. |
FAILED | Payment method failed to be stored. |
CANCELED | Payment method was canceled while storing the payment method on a terminal device. |
Updated about 17 hours ago