Skip to main content

SCT10 - Closed-loop Operation

Self-contained financial ecosystem for specific use cases, enabling controlled internal transactions and custom payment instruments through the API.

Overview

This capability enables your platform to operate a closed-loop financial ecosystem where transactions occur within a controlled network, ideal for loyalty programs, corporate ecosystems, or specialized marketplaces.

Features

FeatureDescription
Internal Wallet SystemClosed-loop wallet balances
Network TransactionsInternal peer-to-peer transfers
Custom InstrumentsBranded payment instruments
Loyalty IntegrationPoints and rewards systems
Ecosystem ManagementControl participant access

Configuration Options

LevelFeaturesExternal Access
BasicSimple closed-loop transactionsNone
StandardFull ecosystem with loyaltyLimited (load only)
AdvancedHybrid closed/open loopFull external connections

API Usage

Create Closed-loop Wallet

POST /api/v1/wallets
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "customer_id": "cust_abc123",
  "wallet_type": "CLOSED_LOOP",
  "currency": "EUR",
  "name": "Loyalty Wallet"
}
Response:
{
  "wallet_id": "wal_xyz789",
  "customer_id": "cust_abc123",
  "wallet_type": "CLOSED_LOOP",
  "currency": "EUR",
  "balance": 0.00,
  "status": "ACTIVE"
}

Internal Transfer

POST /api/v1/wallets/transfers/internal
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "source_wallet_id": "wal_xyz789",
  "destination_wallet_id": "wal_merchant001",
  "amount": 50.00,
  "currency": "EUR",
  "reference": "Purchase at Store A"
}

Load Wallet from External Source (Advanced)

POST /api/v1/wallets/{wallet_id}/load
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "amount": 100.00,
  "source_type": "BANK_TRANSFER",
  "source_reference": "ref_123456"
}

Use Cases

Use CaseDescription
Corporate EcosystemInternal corporate payments and expenses
MarketplaceBuyer-seller transactions within platform
Loyalty ProgramPoints earning and redemption
Gift CardsClosed-loop gift card systems

Integration with Other Capabilities

CapabilityIntegration
SCT03 - CountryWallet availability per country
SCT05 - SubscriptionRecurring value loads
SCT11 - ComplianceInternal transaction monitoring

Wallet APIs

View detailed wallet API specifications

Subscription Tier Availability

TierConfiguration Level
StarterNot included
ProfessionalBasic
EnterpriseAdvanced
CustomConfigurable