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"
}
}
}Retrieve detailed status of a crypto bridge transaction including all stages: deposit collection, crypto payment, and settlement.
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"
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Kotani reference ID for the transaction
"KOTANI-REF-789"