Skip to main content
GET
/
v1
/
transit
/
payment
/
{payment_id}
Fetch a Payment
curl --request GET \
  --url https://sandbox.api.fin.com/v1/transit/payment/{payment_id} \
  --header 'Authorization: Bearer <token>'
{
  "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 — Transaction on hold due to insufficient rebalancing funds
  • SETTLEMENT_FAILED — Settlement failed after 3 retry attempts
The settlement_info field will be null until PAY_SUCCESS. The payment_time will be 0 until PAY_SUCCESS.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Path Parameters

​
payment_id
string<uuid>
required

The unique payment identifier returned from Create Payment

Response

Payment details retrieved successfully

​
data
object