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.

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.