> ## 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 via API

# 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

```bash theme={null}
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:**

```json theme={null}
{
  "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

```bash theme={null}
GET /api/v1/transfers/{transfer_id}
Authorization: Bearer {access_token}
```

**Response:**

```json theme={null}
{
  "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

```json theme={null}
{
  "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                  |

## Related API Reference

<Card title="Transfer APIs" icon="paper-plane" href="/baas/api/reference/financial-operations/transfers">
  View detailed transfer API specifications
</Card>

## Subscription Tier Availability

| Tier         | Configuration Level |
| ------------ | ------------------- |
| Starter      | Basic               |
| Professional | Standard            |
| Enterprise   | Advanced            |
| Custom       | Configurable        |
