Skip to main content
POST
Submit deposit proof

Authorizations

Authorization
string
header
required

Partner API key in the form Authorization: Bearer fn_....

Headers

X-Idempotency-Key
string
required
Minimum string length: 1

Body

application/json

Source-specific deposit references; unknown top-level fields are ignored.

quoteId
string
required
Minimum string length: 1
txHash
string

Source transaction reference; native Hedera transfers require their native transaction ID.

Minimum string length: 1
sourceAddress
string

Expected source-chain sender; a verified mismatch pauses the order for review.

Minimum string length: 1
sparkTxHash
string
Minimum string length: 1
sourceSparkAddress
string

Expected Spark sender address; sanctioned addresses are rejected.

Minimum string length: 1
bitcoinTxid
string
Minimum string length: 1
bitcoinVout
integer
Required range: x >= 0
lightningReceiveRequestId
string
Minimum string length: 1

Response

Order created or replayed

orderId
string
required
status
string
required

Partner-visible order status. Internal paused orders are reported as processing.