Skip to main content
PUT
/
v1
/
settlement-requests
/
{id}
Update settlement request status
curl --request PUT \
  --url https://api-sandbox.superbank.co/v1/settlement-requests/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "status": "FUNDS_SENT"
}
'
{
  "id": "d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a",
  "type": "INSTANT_ONRAMP",
  "infrastructure_provider": "SUPERBANK",
  "status": "REQUEST_STARTED",
  "amount": "99.00",
  "destination": {},
  "payment_instructions": {
    "amount": "99.00",
    "currency": "USDC",
    "rail": "SOLANA",
    "valid_until": "2026-01-20T15:22:12.805Z",
    "wallet_address": "0x12345678900987654321234567890",
    "chain": "SOLANA",
    "bank_name": "JPMorgan Chase",
    "account_number": "123456789",
    "routing_number": "021000021",
    "deposit_message": "SB-39760060"
  },
  "created_at": "2026-01-20T15:17:12.805Z",
  "updated_at": "2026-01-20T15:20:00.000Z",
  "transaction_id": "your_trx_123",
  "source": {
    "currency": "USDC",
    "rail": "SOLANA",
    "wallet_address": "0x388C818CA8B9251b393131C08a736A67ccB19297"
  },
  "outbound_payment": {
    "id": "d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a",
    "type": "PAYOUT",
    "status": "PROCESSING",
    "amount": "99.00",
    "currency": "USDC",
    "created_at": "2026-01-20T15:20:00.000Z"
  },
  "inbound_payment": {
    "id": "d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a",
    "type": "PAYOUT",
    "status": "PROCESSING",
    "amount": "99.00",
    "currency": "USDC",
    "created_at": "2026-01-20T15:20:00.000Z"
  },
  "processing_at": "2026-01-20T15:20:00.000Z",
  "completed_at": "2026-01-20T15:25:00.000Z",
  "reconciliation_expected_at": "2026-01-23T15:20:00.000Z"
}

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
id
string
required

The unique identifier of the settlement request

Body

application/json
​
status
enum<string>
required

The status to update the settlement request to

Available options:
FUNDS_SENT,
REQUEST_COMPLETED,
REQUEST_CANCELED,
PAYIN_CANCELED,
PAYIN_UNDER_REVIEW,
PAYIN_FAILED
Example:

"FUNDS_SENT"

​
transaction_id
string

The external transaction identifier that will be associated with the settlement request

Example:

"your_trx_123"

​
transaction_hash
string

The transaction hash that will be associated with the settlement request

Example:

"5K8z2tF3mN9pQrS4uV6wX7yZ1aB2cD3eF4gH5iJ6kL7m8N9oP0qR1sT2uV3wX4yZ5a"

Response

Settlement request updated

​
id
string
required

The unique identifier of the settlement request

Example:

"d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a"

​
type
enum<string>
required

The type of settlement request

Available options:
INSTANT_ONRAMP,
INSTANT_OFFRAMP
Example:

"INSTANT_ONRAMP"

​
infrastructure_provider
enum<string>
required

The infrastructure provider for the settlement

Available options:
SUPERBANK,
DEVELOPER
Example:

"SUPERBANK"

​
status
enum<string>
required

The current lifecycle status of the settlement request

Available options:
REQUEST_STARTED,
REQUEST_EXPIRED,
REQUEST_CANCELED,
REQUEST_COMPLETED,
REQUEST_REFUNDED,
FUNDS_SENT,
FUNDS_RECEIVING_LATE,
SETTLEMENT_SENT,
SETTLEMENT_COMPLETED,
PAYIN_CANCELED,
PAYIN_UNDER_REVIEW,
PAYIN_FAILED,
PAYOUT_CANCELED,
PAYOUT_UNDER_REVIEW,
PAYOUT_FAILED
Example:

"REQUEST_STARTED"

​
amount
string
required

The amount of the settlement request

Example:

"99.00"

​
destination
object
required

The destination details for the settlement

​
payment_instructions
object
required

Instructions describing the inbound payment

​
created_at
string
required

The timestamp when the settlement request was created

Example:

"2026-01-20T15:17:12.805Z"

​
updated_at
string
required

The timestamp of the most recent update to the settlement request

Example:

"2026-01-20T15:20:00.000Z"

​
transaction_id
object

The external transaction identifier associated with the settlement request

Example:

"your_trx_123"

​
source
object

The source details for the settlement (for off-ramp)

​
outbound_payment
object

The outbound (instant) payment sent from the pre-funded wallet to the destination

​
inbound_payment
object

The inbound payment received from an external source into the pre-funded wallet

​
processing_at
object

The timestamp when settlement processing began

Example:

"2026-01-20T15:20:00.000Z"

​
completed_at
object

The timestamp when the settlement request was completed

Example:

"2026-01-20T15:25:00.000Z"

​
reconciliation_expected_at
object

The timestamp when funds are expected to arrive after FUNDS_SENT (72h for on-ramp, 10min for off-ramp)

Example:

"2026-01-23T15:20:00.000Z"