Lightspark Sandbox API is one of 22 APIs that Lightspark publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Sandbox. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes
7 operations
across 7 paths,
and defines 180 schemas.
It is described by OpenAPI 3.1.0, at version 2025-10-13.
Requests are made against a single base URL, https://api.lightspark.com/grid/2025-10-13.
The identity and technical contract details declared by the specification.
PaymentEmbeddedWalletInfo
EurAccountInfoBase
object
3 properties
2 required
SandboxUmaReceiveRequest
object
5 properties
3 required
TransactionStatus
string
Status of a payment transaction. | Status | Description | |--------|-------------| | CREATED | Initial lookup has been created | | PENDING | Quote has been cre…
Error404
object
4 properties
3 required
BaseTransactionDestination
object
2 properties
1 required
GtqAccountInfoBase
object
4 properties
4 required
CadAccountInfoBase
object
4 properties
4 required
BaseWalletInfo
object
2 properties
2 required
SandboxFundRequest
object
1 property
1 required
GbpAccountInfoBase
object
3 properties
3 required
PaymentRail
string
The payment rail used for the transfer. Payment rails represent the underlying payment network or system used to move funds between accounts.
SandboxSendRequest
object
3 properties
2 required
OutgoingRateDetails
object
Details about the rate and fees for an outgoing transaction or quote. Note: counterpartyFixedFee is denominated in the receiving currency, so its equivalent va…
6 properties
6 required
OutgoingTransactionStatus
string
Status of an outgoing payment transaction. | Status | Description | |--------|-------------| | PENDING | Quote is pending confirmation | | PENDINGAUTHORIZATION…
CardPullSummary
object
3 properties
2 required
CurrencyAmount
object
2 properties
2 required
MyrAccountInfoBase
object
4 properties
4 required
OutgoingTransactionFailureReason
string
Reason for failure of an outgoing transaction. This is used to provide more context on why a transaction failed. If the transaction is not in a failed state, t…
Error400
object
4 properties
3 required
HtgAccountInfoBase
object
2 properties
2 required
IdrAccountInfoBase
object
5 properties
5 required
Error500
object
4 properties
3 required
HkdAccountInfoBase
object
4 properties
4 required
SwiftAccountInfoBase
object
6 properties
4 required
TestWebhookResponse
object
3 properties
1 required
PaymentInstructions
object
3 properties
1 required
BasePaymentAccountInfo
object
1 property
1 required
Error403
object
4 properties
3 required
IncomingTransactionFailureReason
string
Reason for failure of an incoming transaction. This is used to provide more context on why a transaction failed. If the transaction is not in a failed state, t…
KesAccountInfoBase
object
3 properties
3 required
UgxAccountInfoBase
object
3 properties
3 required
TransactionType
string
Type of transaction (incoming payment or outgoing payment)
MxnAccountInfoBase
object
2 properties
2 required
InrAccountInfoBase
object
Required fields depend on the selected paymentRails: - NEFT: accountNumber, ifsc, rail - RTGS: accountNumber, ifsc, rail - UPI: vpa
6 properties
1 required
PolygonWalletInfo
object
2 properties
2 required
TransactionDirection
string
Whether the transaction credits (funds in) or debits (funds out) the customer's account. Independent of type: an incoming transaction is normally a CREDIT, but…
SandboxCardClearingRequest
object
Sandbox-only request body for POST /sandbox/cards/{id}/simulate/clearing. Drives a clearing event against an existing CardTransaction. Pass an amount greater t…
2 properties
2 required
TransactionDestinationOneOf
MwkAccountInfoBase
object
3 properties
3 required
Error401
object
4 properties
3 required
RealtimeFundingTransactionSource
SolanaWalletInfo
object
2 properties
2 required
RwfAccountInfoBase
object
3 properties
3 required
SlvAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: bankAccountType, accountNumber - MOBILEMONEY: phoneNumber
5 properties
1 required
PhpAccountInfoBase
object
3 properties
3 required
GhsAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
4 properties
2 required
AedAccountInfoBase
object
3 properties
2 required
SandboxCardAuthorizationRequest
object
Sandbox-only request body for POST /sandbox/cards/{id}/simulate/authorization. Drives the same internal authorization + reconcile paths that the issuer would c…
3 properties
3 required
ReconciliationInstructions
object
Instructions for reconciling a payment with this transaction. For the on-chain transaction to or from an external crypto wallet that is the transaction's own s…
2 properties
EthereumWalletInfo
object
2 properties
2 required
CardTransaction
object
Parent transaction row for a card authorization and all of the pulls / settlements / refunds that reconcile against it. Child events are rolled up into the pul…
20 properties
12 required
TronWalletInfo
object
2 properties
2 required
CardSettlementSummary
object
2 properties
2 required
PaymentAccountType
string
Type of payment account or wallet
CardRefundSummary
object
2 properties
2 required
CardTransactionStatus
string
Lifecycle status of a card transaction. | Status | Description | |--------|-------------| | AUTHORIZED | The auth has been approved and a hold placed on the fu…
CnyAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
4 properties
2 required
CounterpartyInformation
object
Additional information about the counterparty, if available and relevant to the transaction and platform.
UmaAddressTransactionSource
AccountTransactionDestination
OnChainTransaction
object
2 properties
2 required
CryptoNetwork
string
The blockchain network an on-chain transaction settled on. Whether this is the mainnet or a test network (e.g. Solana devnet) is determined by your platform's…
TransactionSourceType
string
Type of transaction source
JmdAccountInfoBase
object
5 properties
5 required
TransactionDestinationType
string
Type of transaction destination
Transaction
object
14 properties
7 required
InternalAccountType
string
Classification of an internal account. - INTERNALFIAT: A Grid-managed fiat holding account (for example, the USD holding account used as the source for Payouts…
RailSelectionMode
string
How the payment rail was chosen — MANUAL when the platform specified a paymentRail on the destination, AUTO when Lightspark selects it.
NgnAccountInfoBase
object
3 properties
3 required
PaymentLightningInvoiceInfo
InternalAccount
object
10 properties
8 required
TzsAccountInfoBase
object
3 properties
3 required
ThbAccountInfoBase
object
4 properties
4 required
XafAccountInfoBase
object
4 properties
4 required
PaymentEthereumWalletInfo
BdtAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
6 properties
2 required
UsdAccountInfoBase
object
3 properties
3 required
XofAccountInfoBase
object
4 properties
4 required
PkrAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
5 properties
2 required
EgpAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: bankName, iban - MOBILEMONEY: bankName, phoneNumber
4 properties
2 required
SparkWalletInfo
object
2 properties
2 required
DkkAccountInfoBase
object
3 properties
2 required
ZmwAccountInfoBase
object
3 properties
3 required
VndAccountInfoBase
object
4 properties
4 required
BaseTransactionSource
object
2 properties
1 required
IncomingRateDetails
object
Details about the rate and fees for an incoming transaction. Note: gridApiFixedFee is denominated in the receiving currency, so its equivalent value in the sen…
4 properties
4 required
InternalAccountStatus
string
Status of a Grid internal account. The status determines whether the account can send or receive payments. - PENDING: The account is under review and is being…
UmaAddressTransactionDestination
Currency
object
4 properties
BwpAccountInfoBase
object
3 properties
3 required
Refund
object
5 properties
3 required
ZarAccountInfoBase
object
3 properties
3 required
SgdAccountInfoBase
object
4 properties
3 required
CardMerchant
object
3 properties
1 required
SandboxCardReturnRequest
object
Sandbox-only request body for POST /sandbox/cards/{id}/simulate/return. Drives a RETURN event against an existing settled CardTransaction, which creates a Card…
2 properties
2 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Lightspark publishes across the network.
