1foryou

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

★ Only Publicly Available SpecPaymentsPayment Processingoauth24 EndpointsREST

For Agents

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

Quickstart

Get started with 1foryou in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"issue a 1foryou prepaid voucher"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

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

GET STARTED

Start building with 1foryou API

Explore with Jentic

View OpenAPI Spec

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.

Jentic publishes the only available OpenAPI specification for 1foryou, keeping it validated and agent-ready.

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.

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 though 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.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Fire Financial Services Business API

Bank-account-led payments and batches rather than prepaid voucher issuance

Choose Fire when the agent needs to move money via SEPA/Faster Payments; choose 1foryou for prepaid voucher use cases

Alternative

Finstar API

PSD2 payment initiation API rather than retail prepaid vouchers

Choose Finstar for European PSD2 payment initiation; pick 1foryou for South African voucher flows

Complementary

Fintel API

Different finance domain — equity research signals rather than transactional payments

Pair only when an agent needs both market context and a means of moving prepaid value

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.