Overview
Linora exposes a set of RESTful API endpoints for programmatic access to virtual card issuance and currency exchange services. All endpoints return JSON responses and require appropriate authentication headers.
Base URL
All API requests are made to the base URL of your Linora deployment. In production, this is your primary domain with /api prefix.
Gift Cards / Virtual Cards
GET /api/giftcards/products
Returns a list of available virtual card products including Visa and Mastercard options with their denomination ranges, fees, and discount information.
- Response -- Array of product objects with productId, productName, denominationType, min/max amounts, fee structure, and brand details.
POST /api/giftcards/order
Creates a new virtual card order. The card details are delivered to the specified email address.
- productId (number) -- The Reloadly product ID for the desired card.
- unitPrice (number) -- The card value amount.
- quantity (number) -- Number of cards to issue (default: 1).
- recipientEmail (string) -- Email address for card delivery.
- senderName (string) -- Name of the sender (default: "Linora").
GET /api/giftcards/balance
Returns the current Reloadly account balance available for card issuance.
Exchange
GET /api/exchange/currencies
Returns the list of all available currencies for exchange, including ticker symbols, network information, and availability status.
GET /api/exchange/estimate
Calculates the estimated exchange amount for a given currency pair and amount.
- fromCurrency (string) -- Source currency ticker.
- toCurrency (string) -- Destination currency ticker.
- fromAmount (number) -- Amount to exchange.
- fromNetwork (string, optional) -- Source currency network.
- toNetwork (string, optional) -- Destination currency network.
POST /api/exchange/create
Creates a new exchange transaction and returns a deposit address for the source currency.
- fromCurrency (string) -- Source currency ticker.
- toCurrency (string) -- Destination currency ticker.
- fromAmount (number) -- Amount to send.
- address (string) -- Recipient wallet address for the destination currency.
- fromNetwork (string, optional) -- Source network.
- toNetwork (string, optional) -- Destination network.
GET /api/exchange/status
Retrieves the current status of an exchange transaction by its ID.
- id (string) -- The transaction ID returned from the create endpoint.
Error Handling
All endpoints return standard HTTP status codes. Errors include a JSON body with an error field describing the issue. Common codes include 400 (bad request), 401 (unauthorized), and 500 (server error).