Skip to main content
GET
/
api
/
v3
/
deposit
/
crypto-bridge
/
status
/
{kotani_reference_id}
Get crypto bridge deposit status
curl --request GET \
  --url https://sandbox-api.kotanipay.com/api/v3/deposit/crypto-bridge/status/{kotani_reference_id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Crypto bridge deposit status retrieved.",
  "data": {
    "kotani_reference_id": "KOTANI-REF-789",
    "provider_reference_id": "PROVIDER-TXN-20241122-001",
    "status": "PAYMENT_SENT",
    "transaction_type": "cross_border",
    "chain": "LIGHTNING",
    "token": "MSAT",
    "stages": {
      "deposit": {
        "status": "DEPOSIT_CONFIRMED",
        "timestamp": "2024-11-22T12:00:45Z",
        "amount": 1000,
        "currency": "KES",
        "chain": "LIGHTNING",
        "token": "MSAT",
        "payment_hash": "a1b2c3d4e5f6...",
        "amount_msat": 150000000
      },
      "crypto_payment": {
        "status": "DEPOSIT_CONFIRMED",
        "timestamp": "2024-11-22T12:00:45Z",
        "amount": 1000,
        "currency": "KES",
        "chain": "LIGHTNING",
        "token": "MSAT",
        "payment_hash": "a1b2c3d4e5f6...",
        "amount_msat": 150000000
      },
      "settlement": {
        "status": "DEPOSIT_CONFIRMED",
        "timestamp": "2024-11-22T12:00:45Z",
        "amount": 1000,
        "currency": "KES",
        "chain": "LIGHTNING",
        "token": "MSAT",
        "payment_hash": "a1b2c3d4e5f6...",
        "amount_msat": 150000000
      }
    },
    "metadata": {
      "sender_name": "John Doe",
      "sender_country": "KE",
      "recipient_name": "Jane Smith",
      "recipient_country": "ZA",
      "notes": "Family support payment"
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

kotani_reference_id
string
required

Kotani reference ID for the transaction

Example:

"KOTANI-REF-789"

Response

success
boolean
Example:

true

message
string
Example:

"Crypto bridge deposit status retrieved."

data
object