Flashswitch Flash Group 1foryou

Name: 1foryou API
Brand: 1foryou
Availability: InStock

★ Only Publicly Available OpenAPI DocumentPaymentsPayment Processingoauth24 EndpointsREST

For Agents

Issue, redeem, refund, and reverse 1FORYOU prepaid vouchers through the Flash flashswitch — four endpoints covering the full voucher lifecycle.

Install Jentic One Beta

Connect the 1foryou to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the 1foryou, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with 1foryou API.

Purchase a new 1FORYOU voucher for a specified value via POST /purchase

Redeem a voucher in full or partially via POST /redeem, with the residual minted as a new voucher

Refund a prior redemption via POST /refundRedemption, transferring the refunded value to a new voucher

GET STARTED

Start building with 1foryou API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use 1foryou API for, with concrete tasks.

★ Retail Voucher Issuance

Issue 1FORYOU prepaid vouchers from a retail point-of-sale or e-commerce checkout via POST /purchase. Useful for informal-sector retail and gift-card programmes in the South African market. Most integrations are live in under a week including settlement reconciliation.

POST /purchase with amount=10000 (cents) and merchantRef='POS-22-08-15' to mint a new R100 voucher for a customer

Partial Redemption with Residual

Accept partial redemption against a voucher via POST /redeem; the API mints a new voucher for the residual value automatically. This supports voucher reuse without forcing customers to spend the full amount in one transaction, common in prepaid airtime and utility flows.

POST /redeem with voucherCode='1FY-...' and amount=4500 to redeem R45 of a R100 voucher; capture the residual voucher code from the response

Refund and Reversal Handling

Use POST /refundRedemption to refund a redeemed voucher (issuing a fresh voucher for the refund value) and POST /reverseRedemption inside the 90-second window to undo a redemption against the original voucher. This separation matches the operational realities of retail till errors versus later refunds.

POST /reverseRedemption with the redemption reference within 90 seconds of the original /redeem call to undo the transaction at the till

AI Agent Voucher Operations

Use the 1foryou API through Jentic so a retail agent can issue or redeem vouchers from natural language, with credentials in the vault. Useful for cashier-assistant copilots and reseller back-office bots. Get started at https://app.jentic.com/sign-up

Through Jentic, search 'issue a 1foryou voucher', load the /purchase schema, and execute with amount=20000 and merchantRef='AGENT-RUN-1'

Key Endpoints

4 endpoints — the 1foryou api on the flash group flashswitch platform issues, redeems, and reverses 1foryou vouchers used across south african informal-sector retail.

METHOD

PATH

DESCRIPTION

POST

/purchase

Purchase a new 1FORYOU voucher

POST

/redeem

Redeem all or part of a voucher (residual minted automatically)

POST

/refundRedemption

Refund a prior redemption to a new voucher

POST

/reverseRedemption

Reverse a redemption within 90 seconds back to the original voucher

POST

/purchase

Purchase a new 1FORYOU voucher

POST

/redeem

Redeem all or part of a voucher (residual minted automatically)

POST

/refundRedemption

Refund a prior redemption to a new voucher

POST

/reverseRedemption

Reverse a redemption within 90 seconds back to the original voucher

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

OAuth2 tokens for the Flash flashswitch live in the Jentic vault. The Authorization header is injected at execution time, so retail-facing agents never hold long-lived voucher credentials in their context.

Intent-based discovery

Agents search by intent (e.g. 'issue a voucher' or 'reverse a redemption') and Jentic returns the matching 1foryou operation with its parameters, so the agent calls the right one of four endpoints without reading the spec.

Time to first call

Direct 1foryou integration: 2-5 days including OAuth, reconciliation, and reversal-window handling. Through Jentic: under 30 minutes for the API surface.

FAQs

Specific to using 1foryou API through Jentic.

What authentication does the 1foryou API use?

The API uses OAuth 2.0 (implicit flow per the spec) issued by the Flash flashswitch. Through Jentic, the access token is held in the encrypted vault and added to the Authorization header at execution time.

Can I redeem a 1FORYOU voucher partially?

Yes. POST /redeem accepts a redeem amount less than the voucher value and mints a new voucher for the residual, returning its code in the response so it can be used in subsequent transactions.

What is the difference between /refundRedemption and /reverseRedemption?

/reverseRedemption must be called within 90 seconds of /redeem and undoes the redemption against the original voucher. /refundRedemption applies after that window and instead issues a new voucher carrying the refunded value.

What are the rate limits for the 1foryou API?

The flashswitch applies per-merchant rate limits and returns standard 429 responses when exceeded. Specific quotas are set in your Flash agreement; Jentic surfaces 429 to the agent for back-off handling.

How do I issue a voucher through Jentic?

Search Jentic for 'issue a 1foryou voucher', load the /purchase schema, and execute with the desired amount in cents and a merchant reference. The response contains the voucher code to deliver to the customer.

Is the 1foryou API restricted to South Africa?

1FORYOU vouchers are issued and accepted within Flash Group's South African retail network. Geographic availability of redemption depends on participating merchants and is governed by the Flash agreement, not the API itself.

Flashswitch Flash Group 1foryou

Connect the 1foryou to your agent

Capabilities

Start building with 1foryou API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs