Rainforest supports processing payments and storing payment methods utilizing a physical terminal device where the User can tap or swipe their card. This enables your merchants to process card-present payments when the User is at the point of sale with your merchant.

Device payments are processed using the Rainforest API to:

Register and de-register devices to a merchant
Configure a payin and present it on the device for the user to process a payment
Listen to the result of the payment

Limitations

There are a few limitations to consider with device payments:

Devices are registered to a single merchant and cannot process payments for multiple merchants
Payment methods stored from a device are restricted to the merchant the device is registered to. Meaning, a payment method from a device can only process payments on the originating merchant and cannot be utilized across the platform.
Payment methods stored from a device will not have a fingerprint (the fingerprint value will always be null). Rainforest is unable to access the full credit card number for payment methods stored from a device and therefore cannot determine the payment method's fingerprint.

Statuses

Payin

When processing a payin with a device, the payin will be in the status of Presenting while the User completes the interaction with the device.

If the user completes the interaction, then the payin will move to the status of Processing or Failed depending on the result of processing the payin.

Presenting timeout

If the user does not complete the interaction, Rainforest will automatically cancel the payin flow after 5 minutes. This will move the payin to the status of Canceled.

Payment method

When storing a payment method with a device, the payin will be in the status of Presenting while the User completes the interaction with the device.

If the user completes the interaction, then the payment method will move to the status of Active or Failed depending on the result of storing the payment method.

Presenting timeout

If the user does not complete the interaction, Rainforest will automatically cancel the payment method flow after 5 minutes. This will move the payment method to the status of Canceled.