HomeGuidesReference↗ Forage Dashboard
Log In
Guides

Reuse Payment Methods

Allow your customers to reuse their saved payment methods in Custom Checkout.

Custom Checkout allows customers to reuse their saved EBT payment methods for faster PIN capture. Unlike Fully Hosted Checkout, Custom Checkout does not create or manage payment methods directly. You create and store payment method references via the Forage API.

📘

Payment Method Support

Custom Checkout only supports EBT payment methods (SNAP and EBT Cash). Credit/debit card is not supported.

Reuse EBT payment methods

When you create a Payment Method via the Forage API, the ref field is reusable. You store this reference in your application's database and use it when creating subsequent orders for the same customer.

How it works

Balance check

To perform a balance check:

  1. Create a Balance Session via the Forage API. Pass the stored payment method ref as the payment_method field in the payload of the request.
  2. Redirect to the redirect_url that comes in the response of the previous API call.
  3. The customer enters their PIN to check their balance.

The customer's EBT balance is displayed.

Process a payment

To process a payment:

  1. Create a Capture Session via the Forage API. Pass the stored payment method ref in the payment_method field of the payment_details object.
  2. Redirect to the redirect_url that comes in the response of the previous API call.
  3. The customer enters their PIN to process the payment.

The payment is processed and the order is completed.