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",
    "quote_id": "FIN_PROVIDED_UUID",
    "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
  }
}
Retrieves the current status and details of a payment order, including both payment and settlement information.

​
Payment Status Values

The payment can be in one of the following statuses:
  • PAY_INIT - Payment initialized (ByBit equivalent: INIT)
  • PAY_PROCESS - Payment is being processed (ByBit equivalent: PAY_PROCESS)
  • PAY_SUCCESS - Payment completed successfully (ByBit equivalent: PAY_SUCCESS)
  • PAY_FAILED - Payment failed (ByBit equivalent: PAY_FAILED)
  • PAY_TIMEOUT - Payment timed out (ByBit equivalent: TIMEOUT)
  • PAY_CANCEL - Payment was cancelled (ByBit equivalent: CANCEL)
  • SETTLEMENT_INIT - Settlement process started
  • SETTLEMENT_SUCCESS - Fin to PayPal settlement completed successfully
  • SETTLEMENT_HOLD - Fin has put the transaction on hold due to insufficient amount in the rebalancing wallets. Fin will automatically proceed with the held transactions once the rebalancing wallets have sufficient funds.
  • SETTLEMENT_FAILED - Fin to PayPal settlement failed after 3 retry attempts (The likelihood of SETTLEMENT_FAILED is negligible, except in the event of a technical issue)
The settlement_info field will be null until the payment reaches PAY_SUCCESS status. The payment_time will be 0 until PAY_SUCCESS is achieved.

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 the Create Payment endpoint

Response

Payment details retrieved successfully

​
data
object