Flashswitch Flash Group 1foryou
★ 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.
Use for: Issue a new R100 1FORYOU voucher for a customer, Redeem voucher 1FY-22918 for R45, I need to reverse the last redemption on voucher 1FY-22918, Refund a redeemed voucher and issue a replacement
Not supported: Does not handle card payments, bank transfers, or KYC - use for issuing, redeeming, refunding, and reversing 1FORYOU prepaid vouchers only.
The 1foryou API on the Flash Group flashswitch platform issues, redeems, and reverses 1FORYOU vouchers used across South African informal-sector retail. The four endpoints cover the full voucher lifecycle: purchase a new voucher, redeem (in part or whole), refund a prior redemption, and reverse a redemption inside a 90-second window. Voucher partial redemption mints a residual voucher automatically, suitable for retail point-of-sale, prepaid utility top-ups, and reseller channels.
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.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fflashswitch.flash-group.com%2Fflashswitch" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fflashswitch.flash-group.com%2Fflashswitch" | sh
jentic register # connects your agent to your Jentic One instanceJentic 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
Reverse a redemption within 90 seconds of /redeem to restore value to the original voucher
Operate within an OAuth2-secured switch suitable for retail and reseller integrations
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?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the 1foryou voucher API by hand means running its OAuth2 flow, mapping purchase, redeem, refund, and reversal onto the right routes, and handling retries yourself. Through Jentic you install once, import 1foryou from the API Directory, store the credential once, and your agent calls it.
Permission scoping
1foryou carries its voucher target in the request body rather than as an owned resource in the URL path, so limit the agent to the operations it needs, such as issuing or redeeming a voucher, and leave refunds and reversals out of the allowed set unless required. You choose which of the four operations it may call.
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.
Related APIs
Alternatives and complements available in the Jentic catalogue.
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.
GET STARTED