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 with Jentic One, the self-hosted execution layer

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

Your 1foryou OAuth2 credential is stored once, encrypted, by your own Jentic One instance and injected into the Authorization header at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'issue a voucher' or 'reverse a redemption', and Jentic returns the matching 1foryou operation with its input schema so the agent calls the right one of four endpoints without browsing the reference docs.

Time to first call

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.

Can I limit what my agent is allowed to do with the 1foryou API?

Yes. Because you run Jentic One yourself, your own rules decide which of the four 1foryou operations the agent may call: purchase, redeem, refundRedemption, and reverseRedemption. Since 1foryou passes the voucher target in the request body rather than as an owned resource in the URL path, you scope by operation, so you can allow the agent to issue or redeem vouchers while leaving refunds and reversals out of its permitted set. The OAuth2 credential stays with your instance and is added to requests only for the operations you have allowed.

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