Documentation Index Fetch the complete documentation index at: https://docs.finhub.cloud/llms.txt
Use this file to discover all available pages before exploring further.
SCT04 - Instant Payment
Real-time payment processing capabilities for immediate fund transfers with 24/7 availability through the API.
Overview
This capability enables your platform to process payments in real-time via API, providing instant confirmation and immediate fund availability for your customers.
Features
Feature Description Real-Time Processing Immediate transaction execution Instant Notifications Real-time payment confirmations via webhooks 24/7 Availability Round-the-clock payment processing Status Tracking Live transaction status updates Fallback Mechanisms Automatic retry and alternative routing
Configuration Options
Level Processing Time Features Basic Standard (T+1) Batch processing Standard Same-day Intraday settlement Advanced Real-time Instant confirmation, 24/7
API Usage
Initiate Instant Transfer
POST /api/v1/transfers
Content-Type: application/json
Authorization: Bearer {access_token}
{
"source_account_id" : "acc_123456",
"destination" : {
"type" : "IBAN",
"iban" : "DE89370400440532013000",
"name" : "John Doe"
},
"amount" : 250.00,
"currency" : "EUR",
"payment_type" : "INSTANT",
"reference" : "Invoice #12345"
}
Response:
{
"transfer_id" : "txn_abc789" ,
"status" : "COMPLETED" ,
"amount" : 250.00 ,
"currency" : "EUR" ,
"payment_type" : "INSTANT" ,
"executed_at" : "2024-01-15T10:30:00Z" ,
"settlement_time" : "INSTANT"
}
Get Transfer Status
GET /api/v1/transfers/{transfer_id}
Authorization: Bearer {access_token}
Response:
{
"transfer_id" : "txn_abc789" ,
"status" : "COMPLETED" ,
"status_history" : [
{ "status" : "INITIATED" , "timestamp" : "2024-01-15T10:29:58Z" },
{ "status" : "PROCESSING" , "timestamp" : "2024-01-15T10:29:59Z" },
{ "status" : "COMPLETED" , "timestamp" : "2024-01-15T10:30:00Z" }
]
}
Webhook Notifications
{
"event" : "transfer.completed" ,
"transfer_id" : "txn_abc789" ,
"status" : "COMPLETED" ,
"amount" : 250.00 ,
"currency" : "EUR" ,
"timestamp" : "2024-01-15T10:30:00Z"
}
Payment Schemes Supported
Scheme Region Settlement Time SEPA Instant EU/EEA < 10 seconds Faster Payments UK < 2 hours SWIFT gpi Global Same-day
Integration with Other Capabilities
Capability Integration SCT03 - Country Available payment schemes per country SCT09 - Multi-Currency Cross-currency instant payments SCT11 - Compliance Real-time fraud screening SCT12 - Financial Network Network connectivity
Transfer APIs View detailed transfer API specifications
Subscription Tier Availability
Tier Configuration Level Starter Basic Professional Standard Enterprise Advanced Custom Configurable