Skip to main content
WEBHOOK
transit.payment.status
{
  "event": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "transit.payment.status",
    "event_reference_id": "FIN_PROVIDED_UUID",
    "created_at": "2025-10-10T15:40:56Z"
  },
  "data": {
    "payment_id": "FIN_PROVIDED_UUID",
    "integration_type": "BYBIT",
    "status": "PAY_INIT",
    "create_time": 1740748353,
    "payment_info": {
      "pay_id": "01JN6AZVEMAC8H9SED6JES3QH8",
      "merchant_trade_no": "841e4ba2-...-a2a45de7bd00",
      "amount": "100",
      "status": "PAY_INIT",
      "currency": "USDT",
      "currency_type": "crypto",
      "expire_time": 1740751953,
      "payment_time": 0
    },
    "settlement_info": null
  }
}

​
Payment Status Values

  • PAY_INIT — Payment initialized
  • PAY_PROCESS — Payment is being processed
  • PAY_SUCCESS — Payment completed successfully
  • PAY_FAILED — Payment failed
  • PAY_TIMEOUT — Payment timed out
  • PAY_CANCEL — Payment was cancelled
  • SETTLEMENT_INIT — Settlement process started
  • SETTLEMENT_SUCCESS — Settlement completed successfully
  • SETTLEMENT_HOLD — On hold due to insufficient rebalancing funds. Fin will auto-proceed once funds are available.
  • SETTLEMENT_FAILED — Settlement failed after 3 retry attempts
The settlement_info field will be null for PAY_* statuses and populated for SETTLEMENT_* statuses.
All webhook requests include HMAC signatures for verification.

Body

application/json
​
event
object
required
​
data
object
required

Response

200

Webhook received successfully