Quickstart

Dashboard setup

Contact your account representative for access to Benny’s dashboard. From there you are able to manage orders, issue refunds, authorize your Stripe integration, create API keys, setup webhooks, and more.

You’ll need to provide your USDA FNS number to configure your account.

Connect your Stripe account

Connect your Stripe account to Benny’s dashboard with our Stripe guide.

Generate sandbox keys

Benny offers two environments:

Production: Enables real EBT and bank card money movement. Access to the production environment is gated by your organization receiving USDA FNS approval.
Sandbox: Enables testing your integration with simulated money movement.

From the Benny dashboard, click on the Developer resources menu item, toggle Sandbox mode, and generate your secret API keys.

Create an order session

An order session represents an in-progress order that is unique to your store and a customer. A session is launched from your checkout page by an API call or for the case of simple, single-item sales, the Benny Checkout Button.

Benny Checkout Button
Node.js
Python
Kotlin
Java

See Checkout Button for the complete configuration, but as an example:

Example integration

<script async src="https://js.bennyapi.com/v1/ebt-checkout-button.js"></script>

<ebt-checkout-button
  publicKey="<Public Key>"
  environment="<Environment of PRODUCTION or SANDBOX">
  orderDetails='{
    "onSuccessRedirectUrl": "https://yoursite.com/success",
    "onExitRedirectUrl": "https://yoursite.com/exit",
    "items": [
      {
        "id": "item_1",
        "description": "Staple Produce Sampler",
        "quantity": 1,
        "unit": "COUNT",
        "price": 500,
        "snapEligible": true,
        "taxRate": 0.0
      }
    ]
  }'
/>

import Benny from "@bennyapi/sdk";

const client = new Benny({
  apiKey: process.env.BENNY_API_KEY,
  environment: "sandbox",
});

const session = await client.order.createSession({
  onSuccessRedirectUrl: "https://yoursite.com/success",
  onExitRedirectUrl: "https://yoursite.com/exit",
  items: [
    {
      id: "item_1",
      description: "Organic Apples",
      quantity: 2,
      unit: "COUNT",
      price: 500,
      snapEligible: true,
      taxRate: 0.0,
    },
  ],
});

// Redirect the customer to session.url
console.log(session.url);

import os
from bennyapi import Benny

client = Benny(
    api_key=os.environ["BENNY_API_KEY"],
    environment="sandbox",
)

session = client.order.create_session(
    on_success_redirect_url="https://yoursite.com/success",
    on_exit_redirect_url="https://yoursite.com/exit",
    items=[
        {
            "id": "item_1",
            "description": "Organic Apples",
            "quantity": 2,
            "unit": "COUNT",
            "price": 500,
            "snap_eligible": True,
            "tax_rate": 0.0,
        },
    ],
)

# Redirect the customer to session.url
print(session.url)

val client = BennyClientBuilder()
    .apiKey(System.getenv("BENNY_API_KEY"))
    .sandbox()
    .build()

val session = client.order().createSession(
    OrderCreateSessionParams.builder()
        .onSuccessRedirectUrl("https://yoursite.com/success")
        .onExitRedirectUrl("https://yoursite.com/exit")
        .addItem(
            OrderCreateSessionParams.Item.builder()
                .id("item_1")
                .description("Organic Apples")
                .quantity(2)
                .unit("COUNT")
                .price(500)
                .snapEligible(true)
                .taxRate(0.0)
                .build()
        )
        .build()
)

// Redirect the customer to session.url()
println(session.url())

BennyClient client = new BennyClientBuilder()
    .apiKey(System.getenv("BENNY_API_KEY"))
    .sandbox()
    .build();

var session = client.order().createSession(
    OrderCreateSessionParams.builder()
        .onSuccessRedirectUrl("https://yoursite.com/success")
        .onExitRedirectUrl("https://yoursite.com/exit")
        .addItem(
            OrderCreateSessionParams.Item.builder()
                .id("item_1")
                .description("Organic Apples")
                .quantity(2)
                .unit("COUNT")
                .price(500)
                .snapEligible(true)
                .taxRate(0.0)
                .build()
        )
        .build()
);

// Redirect the customer to session.url()
System.out.println(session.url());

A common pattern is to have a separate button on your checkout page, e.g., “Checkout with EBT” that invokes your server to create a new session URL. Once the session URL is generated, redirect the customer to Benny’s hosted checkout experience.

(Optionally) Subscribe to webhook events

Benny will send webhook events when an order session is completed, indicating that items should be prepared for delivery or pickup. Alternatively, you can view all order information from the Benny dashboard.Consume the Order Completed Event.

That's it!

Benny will guide you through all the steps to receive USDA FNS approval. Once approved, you will be able to start accepting EBT payments online.

Get Started

Hosted Checkout

Enterprise

Mobile SDKs

Testing

Dashboard setup

Connect your Stripe account

Generate sandbox keys

Create an order session

(Optionally) Subscribe to webhook events

That's it!