Check the balance of an EBT payment method

post

https://{environment}.joinforage.app/api/payment_methods/{payment_method_ref}/balance/

Perform a balance check on an EBT payment method by posting the cardholder's PIN to this API. Balance checks for non-EBT payment methods will get 400 responses.

Note that only one PIN entry is required to query both the SNAP and Cash balances of the EBT Card.

Because the collection of PIN data is subject to PCI requirements, this endpoint can only be accessed through the secure PIN-capture components contained in the Forage Checkout UI.

Path Params

payment_method_ref

string

required

The PaymentMethod's unique reference hash

Body Params

An EBT cardholder's PIN data

This object contains an EBT cardholder's PIN data when one PIN entry is required

string

The PIN data

card_number_token

string

The token field of the TokenizedPaymentMethod.card object. This token is an input to Forage's secure PIN encryption.

Headers

Merchant-Account

string

required

A unique merchant ID that Forage provides during onboarding, as in 123ab45c67. The Merchant ID can be found in the Forage sandbox or production dashboard.

Idempotency-Key

string

required

An alphanumeric key that clients can use to identify repeated requests that are dropped in transit. Generate a distinct key for every unique request and only re-use keys for retries.

API-Version

string

The Forage version, represented as a string with the format of a YYYY-MM-DD date.

If not specified in the request header, then the version defaults to the value set in the Forage dashboard.

Responses

500

Server Errors Something went wrong on Forage's servers. Try again.

Language

Credentials

OAuth2

URL

Loading…

Response

Choose an example:

application/json

200Successful balance check request.

400Bad Request The request was not accepted because of errors in the request body.

401Unauthorized Missing valid API key.

402Request Failed The request failed even though the parameters are valid. This often occurs due to a payment decline.

403Forbidden The API key lacks permissions to perform the request.

404Not Found The requested resource does not exist.

429Limit Reached Request limit reached.